Metadata-Version: 2.1
Name: openbayestool
Version: 0.3.2
Summary: Openbayes Service Tool
Home-page: https://openbayes.com
Author: Openbayes
License: UNKNOWN
Description: # openbayestool
        
        该工具用于 [OpenBayes](https://openbayes.com) 下参数、指标的记录。
        
        ## 快速开始
        
        该类库将会把模型执行过程中的 `parameters` 和 `metrics` 提交到 `openbayes-server` 方便记录每次模型的结果。
        
        ```python
        from openbayestool import log_param, log_metric, clear_metric, clear_param
        
        # 记录参数 `learning_rate=0.01`
        log_param('learning_rate', 0.01)
        
        # 同一参数将会记录最后一个请求的结果 `foo=3`
        log_param('foo', 1)
        log_param('foo', 2)
        log_param('foo', 3)
        
        # 记录模型的运行结果 `precision=0.77`
        log_metric('precision', 0.77)
        
        # 同一个结果 precision 多次记录会追加结果，即结果为 [0.79, 0.82, 0.86]
        log_metric('precision', 0.79)
        log_metric('precision', 0.82)
        log_metric('precision', 0.86)
        
        # 清理一个自定义的 metric
        clear_metric('precision')
        
        # 清理一个自定义的 param
        clear_param('foo')
        ```
        
        ## 安装
        
        **注意** 在 [OpenBayes](https://openbayes.com) 内无需安装，默认已经引入了该依赖。
        
        ```shell
        pip install -U openbayestool
        ```
        
        ## 使用
        
        **注意** 在 openbayes 所提交的任务会自动设置 **API 访问 token** 和 **要记录的容器的 url** 无需用户知晓。
        
        ### 设置要记录的容器的 url
        
        可以通过环境变量配置：`JOB_UPDATE_URL=<job-url>`，也可以在程序中采用 `api` 配置：
        
        ```python
        from openbayestool import set_callback_url, get_callback_url
        
        set_callback_url('<job-url>') # set the job-url
        get_callback_url() # return the job-url
        ```
        
        ### 设置访问 API 的 token
        
        可以通过环境变量 `JOB_ACCESS_TOKEN=<job-token>` 配置，也可以在程序中采用 `api` 配置：
        
        ```python
        from openbayestool import set_access_token, get_access_token
        
        set_access_token('<job-token>') # set the job-token
        get_access_token() # return the job-token
        ```
        
        ### 通过 api 操纵 `parameters` 和 `metrics`
        
        ```python
        from openbayestool import log_param, log_metric, clear_metric
        
        # 记录参数 `learning_rate=0.01`
        log_param('learning_rate', 0.01)
        
        # 同一参数将会记录最后一个请求的结果 `foo=3`
        log_param('foo', 1)
        log_param('foo', 2)
        log_param('foo', 3)
        
        # 记录模型的运行结果 `precision=0.77`
        log_metric('precision', 0.77)
        
        # 同一个结果 precision 多次记录会追加结果，即结果为 [0.79, 0.82, 0.86]
        log_metric('precision', 0.79)
        log_metric('precision', 0.82)
        log_metric('precision', 0.86)
        
        # 清理一个自定义的 metric
        clear_metric('precision')
        ```
        
        ## 查看记录结果
        
        在 openbayes 的容器页面会展现以上的记录结果并作为自动建模确认下一步参数的依据。
        
Keywords: ml ai openbayes
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
