更新时间:2021-09-18 GMT+08:00
分享

编辑主文件

  1. 在JupyterLab环境编辑界面的左侧导航栏中,单击自定义学件项目“custom_01”主文件“custom_01.ipynb”。

    界面右侧打开文件编辑界面,如图1所示。
    图1 学件主文件

  2. 单击“Import sdk”代码框左侧的运行图标,导入模型训练服务SDK。
  3. 依次为各个算子,分别创建一个markdown cell和一个code cell。

    创建方法,如图2所示。

    界面元素说明如下所示:

    • 1:左侧图标用于创建code cell,右侧图标用于创建markdown cell。
    • 2:创建的markdown cell。
    • 3:创建的code cell。其中,“test = "aaa"”为需要暴露的参数。
    • 4:算子输出的内容展示。
    图2 创建算子

    其中,markdown cell以markdown格式填写算子的标题和描述信息,标题一般是二级标题。

    code cell中用于填写算子代码,需要注意如下事项:

    1. 尽量将主体代码封装起来,详情请参见抽象算子

      此处仅调用“custom.sdk.learnware.Learnware”实例的“load_data”等方法。

      如果通用,后续可以考虑沉淀到NAIE SDK或者特定领域的学件SDK中。

    2. 如果需要将算子的变量暴露为参数,供用户输入,需要在代码中以“<变量名> = <变量值>”的格式体现,供后续开发表单时使用。
    3. 针对“加载数据”算子,可参考JupyterLab环境界面右上角内置的“数据处理 > 数据集 > 加载数据”算子进行定制。

      学件主文件的代码样例,如下所示:

      data_reference_kwargs = [
          {
              "dataset": "iris",
              "dataset_entity": "train",
              "file_list": None,
              "file_type": "csv",
              "encoding": "utf-8",
              "enable_local_cache": False
          },
          {
              "dataset": "iris",
              "dataset_entity": "test",
              "file_list": None,
              "file_type": "csv",
              "encoding": "utf-8",
              "enable_local_cache": False
          }
      ]
      learnware.load_data(data_reference_kwargs)
      learnware.display_data()

      其中,“data_reference_kwargs”是需要暴露给用户的参数字典,具体请参见表3

  4. 按照上述操作方法,开发所有算子,并将学件流程调试通。

相关文档