文字识别样例

登录jupyter lab

为方便新手开发者进行应用开发和程序运行，镜像中已包含jupyter lab软件（可视化代码演示、数据分析工具），可为用户提供一个图形化运行推理样例的界面，本节介绍基于远程登录模式如何登录jupyter lab并运行一个ResNet50样例。

本节内容介绍开发者套件在以下三种场景下，如何登录和启动jupyter lab。

本机显示模式

在图形化桌面打开命令终端。

Ubuntu OS：左键单击左下方工具栏

打开终端。

openEuler OS：左键单击正下方工具栏

打开终端。
进入“notebooks”目录，在命令终端窗口输入如下命令（可以拷贝）：
```
cd /home/HwHiAiUser/samples/notebooks
```
修改jupyter lab启动脚本（start_notebook.sh）中jupyter lab启动IP地址，执行vi start_notebook.sh命令修改启动IP地址。在键盘按i键进入编辑模式，将脚本中以下加粗的IP地址修改为127.0.0.1。
```
. /usr/local/Ascend/ascend-toolkit/set_env.sh
export PYTHONPATH=/usr/local/Ascend/thirdpart/aarch64/acllite:$PYTHONPATH
if [ $# -eq 1 ];then
    jupyter lab --ip $1 --allow-root --no-browser
else
    jupyter lab --ip 127.0.0.1 --allow-root --no-browser
fi
```
修改完成后，按Esc键退出编辑模式，按键盘输入**:wq**保存文件。

:::note 说明本机显示模式下，如果开发者套件同时有接口连接PC，可以将jupyter lab启动IP地址修改为开发者套件连接PC的接口IP地址，用户可以实现同时通过本机显示模式和远程登录模式登录开发者套件。 :::

执行**./start_notebook.sh**命令启动jupyter lab。

系统回显类似以下信息表示jupyter lab已正常运行：

[I 2023-05-09 08:02:59.683 ServerApp] nbclassic | extension was successfully loaded.
[I 2023-05-09 08:02:59.685 ServerApp] Serving notebooks from local directory: /home/HwHiAiUser/samples/notebooks
[I 2023-05-09 08:02:59.685 ServerApp] Jupyter Server 1.23.6 is running at:
[I 2023-05-09 08:02:59.685 ServerApp] http://127.0.0.1:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807
[I 2023-05-09 08:02:59.685 ServerApp]  or http://127.0.0.1:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807
[I 2023-05-09 08:02:59.685 ServerApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 2023-05-09 08:02:59.701 ServerApp]

在回显信息页面按住键盘“Ctrl”键并使用鼠标左键单击步骤4回显中加粗的网址链接（如：http://127.0.0.1:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807），进入jupyter lab界面，即可运行开发者套件预置的Python推理样例。

图1 样例目录

:::note 说明启动jupyter lab失败请参见登录开发者套件后启动jupyter lab失败解决。 :::

远程登录模式（开发者套件通过Type-C接口连接PC）

进入“notebooks”目录，在MobaXterm工具窗口输入如下命令（可以拷贝）：
```
cd /home/HwHiAiUser/samples/notebooks
```
修改jupyter lab启动脚本（start_notebook.sh）中jupyter lab启动IP地址，如果烧录镜像时开发者套件Type-C接口保留了默认IP信息，则将启动脚本中的IP修改为192.168.0.2；如果Type-C接口配置了其他IP地址，则将启动脚本中的IP修改为实际IP地址。

执行vi start_notebook.sh命令修改启动IP地址。在键盘按i键进入编辑模式，将脚本中以下加粗的IP地址修改为实际IP地址（例如修改为192.168.0.2）。
```
. /usr/local/Ascend/ascend-toolkit/set_env.sh
export PYTHONPATH=/usr/local/Ascend/thirdpart/aarch64/acllite:$PYTHONPATH
if [ $# -eq 1 ];then
    jupyter lab --ip $1 --allow-root --no-browser
else
    jupyter lab --ip 192.168.0.2 --allow-root --no-browser
fi
```
修改完成后，按Esc键退出编辑模式，按键盘输入**:wq**保存文件。

执行**./start_notebook.sh**命令启动jupyter lab。

系统回显类似以下信息表示jupyter lab已正常运行：

[I 2023-05-09 08:02:59.683 ServerApp] nbclassic | extension was successfully loaded.
[I 2023-05-09 08:02:59.685 ServerApp] Serving notebooks from local directory: /home/HwHiAiUser/samples/notebooks
[I 2023-05-09 08:02:59.685 ServerApp] Jupyter Server 1.23.6 is running at:
[I 2023-05-09 08:02:59.685 ServerApp] http://192.168.0.2:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807
[I 2023-05-09 08:02:59.685 ServerApp]  or http://127.0.0.1:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807
[I 2023-05-09 08:02:59.685 ServerApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 2023-05-09 08:02:59.701 ServerApp]

在回显信息页面按住键盘“Ctrl”键并使用鼠标左键单击步骤3回显中加粗的网址链接（如：http://192.168.0.2:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807），进入jupyter lab界面，即可运行开发者套件预置的Python推理样例。

图2 样例目录

:::note 说明启动jupyter lab失败请参见登录开发者套件后启动jupyter lab失败解决。 :::

远程登录模式（开发者套件通过以太网口连接PC）

进入“notebooks”目录，在MobaXterm工具窗口输入如下命令（可以拷贝）：
```
cd /home/HwHiAiUser/samples/notebooks
```
jupyter lab启动脚本（start_notebook.sh）中的jupyter lab启动IP地址默认为192.168.137.100，如果烧录镜像时开发者套件以太网口eth1保留了默认IP信息，则跳过本步骤；如果以太网口eth1配置了其他IP地址，则将启动脚本中的IP修改为实际IP地址。

启动IP地址修改方法：执行vi start_notebook.sh命令修改启动IP地址。在键盘按i键进入编辑模式，将脚本中以下加粗的IP地址192.168.137.100修改为实际IP地址。
```
. /usr/local/Ascend/ascend-toolkit/set_env.sh
export PYTHONPATH=/usr/local/Ascend/thirdpart/aarch64/acllite:$PYTHONPATH
if [ $# -eq 1 ];then
    jupyter lab --ip $1 --allow-root --no-browser
else
    jupyter lab --ip 192.168.137.100 --allow-root --no-browser
fi
```
修改完成后，按Esc键退出编辑模式，按键盘输入**:wq**保存文件。

执行**./start_notebook.sh**命令启动jupyter lab。

系统回显类似以下信息表示jupyter lab已正常运行：

[I 2023-05-09 08:02:59.683 ServerApp] nbclassic | extension was successfully loaded.
[I 2023-05-09 08:02:59.685 ServerApp] Serving notebooks from local directory: /home/HwHiAiUser/samples/notebooks
[I 2023-05-09 08:02:59.685 ServerApp] Jupyter Server 1.23.6 is running at:
[I 2023-05-09 08:02:59.685 ServerApp] http://192.168.137.100:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807
[I 2023-05-09 08:02:59.685 ServerApp]  or http://127.0.0.1:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807
[I 2023-05-09 08:02:59.685 ServerApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 2023-05-09 08:02:59.701 ServerApp]

在回显信息页面按住键盘“Ctrl”键并使用鼠标左键单击步骤3回显中加粗的网址链接（如：http://192.168.137.100:8888/lab?token=a046a76dc21f1504f271c16278ed62ed7fb014aaf38ee807），进入jupyter lab界面，即可运行开发者套件预置的Python推理样例。

图3 样例目录

:::note 说明启动jupyter lab失败请参见登录开发者套件后启动jupyter lab失败解决。 :::

目标检测样例

在jupyter lab可视化界面目录中双击“01-yolov5”模型样例目录。
双击打开“main.ipynb”脚本，进入样例运行页面。

图1 样例运行页面
当前目标检测样例支持图片、视频、USB摄像头目标检测，用户可修改代码块中infer_mode，默认值：video，可选值：image、video、camera。

图2 运行模式
单击

按钮运行样例，单击“Restart”按钮，运行完成后等待若干秒时间，查看推理结果，如图4和图5所示，目标检测识别出汽车、人物与足球。

图3 单击按钮

图4 视频目标检测推理结果

图5 图像目标检测推理结果

:::note 说明若运行多个样例后，出现Kernel Restarting提示框，如图6所示，请参见jupyter notebook运行多个推理样例后提示Kernel Restarting解决。

图6 错误提示

:::

文字识别样例

在jupyter lab可视化界面目录中双击“02-ocr”模型样例目录。
双击打开“main.ipynb”脚本，进入样例运行页面。
单击按钮运行样例，单击“Restart”按钮，运行完成后等待若干秒时间，查看推理结果，如图3所示，识别图中文字结果。

图1 样例运行页面

图2 单击按钮

图3 文字识别推理结果

:::note 说明若运行多个样例后，出现Kernel Restarting提示框，如图4所示，请参见jupyter notebook运行多个推理样例后提示Kernel Restarting解决。

图4 错误提示

:::

图像曝光增强样例

在jupyter lab可视化界面目录中双击“04-image-HDR-enhance”模型样例目录。
双击打开“main.ipynb”脚本，进入样例运行页面。
单击

按钮运行样例，单击“Restart”按钮，运行完成后等待若干秒时间，查看推理结果，如图3所示，增加了图片的曝光度。

图1 样例运行页面

图2 单击按钮

图3 曝光增强推理结果

:::note 说明若运行多个样例后，出现Kernel Restarting提示框，如图4所示，请参见jupyter notebook运行多个推理样例后提示Kernel Restarting解决。

图4 错误提示

:::

卡通图像生成样例

在jupyter lab可视化界面目录中双击“05-cartoonGAN_picture”模型样例目录。
双击打开“main.ipynb”脚本，进入样例运行页面。
单击

按钮运行样例，单击“Restart”按钮，运行完成后等待若干秒时间，查看推理结果，如图3所示，将山水照片转换为卡通图像。

图1 样例运行页面

图2 单击按钮

图3 卡通图像生成推理结果

:::note 说明若运行多个样例后，出现Kernel Restarting提示框，如图4所示，请参见jupyter notebook运行多个推理样例后提示Kernel Restarting解决。

图3 错误提示

:::

蛋白质分类评估样例

在jupyter lab可视化界面目录中双击“06-human_protein_map_classification”模型样例目录。
双击打开“main.ipynb”脚本，进入样例运行页面。
单击

按钮运行样例，单击“Restart”按钮，运行完成后等待若干秒时间，查看推理结果，如图3所示，将蛋白质图谱进行分类并展示置信度。

图1 样例运行页面

图2 单击按钮

图3 蛋白质分类推理结果

:::note 说明若运行多个样例后，出现Kernel Restarting提示框，如图4所示，请参见jupyter notebook运行多个推理样例后提示Kernel Restarting解决。

图3 错误提示

:::

在线提单

登录jupyter lab​

本机显示模式​

远程登录模式（开发者套件通过Type-C接口连接PC）​

远程登录模式（开发者套件通过以太网口连接PC）​

目标检测样例​

文字识别样例​

图像曝光增强样例​

卡通图像生成样例​

蛋白质分类评估样例​

登录jupyter lab

本机显示模式

远程登录模式（开发者套件通过Type-C接口连接PC）

远程登录模式（开发者套件通过以太网口连接PC）

目标检测样例

文字识别样例

图像曝光增强样例

卡通图像生成样例

蛋白质分类评估样例