Skip to content

Latest commit

 

History

History
198 lines (123 loc) · 11.1 KB

README_cn.md

File metadata and controls

198 lines (123 loc) · 11.1 KB

English | 简体中文

📚 OpenVINO™ Notebooks

Apache License Version 2.0 CI CI

在这里,我们提供了一些可以运行的Jupyter* notebooks,用于学习和尝试使用OpenVINO™开发套件。这些notebooks旨在向各位开发者提供OpenVINO基础知识的介绍,并教会大家如何利用我们的API来优化深度学习推理。

🚀 您可以通过查看以下交互式的页面,对OpenVINO™ Notebooks的内容进行快速导览: OpenVINO™ Notebooks at GitHub Pages

notebooks-selector-preview

-----------------------------------------------------

目录

-----------------------------------------------------

📝 安装指南

OpenVINO™ Notebooks需要预装Python和Git, 针对不同操作系统的安装参考以下英语指南:

Windows Ubuntu macOS Red Hat CentOS Azure ML Docker Amazon SageMaker

-----------------------------------------------------

🚀 开始

使用这个 页面来探索notebooks, 选择一个跟你需求相关的开始试试吧。祝你好运!

注意: 这个仓库的main分支已经升级了对于OpenVINO 2024.3 release的支持. 请运行在你的 openvino_env虚拟环境中,运行 pip install --upgrade -r requirements.txt 升级到最新版本. 如果这是您第一次安装OpenVINO™ Notebooks,请参考以下的 安装指南。 如果您想使用上一个OpenVINO版本, 请切换至2023.3 分支. 如果您想使用上一个长期维护 (LTS) 的OpenVINO版本,请切换到 2022.3 分支

如果您有任何问题,可以开启一个 GitHub 讨论

如果你遇到了问题,请查看故障排除, 常见问题解答 或者创建一个GitHub 讨论

带有binder 标签colab 标签 按键的Notebooks可以在无需安装的情况下运行。BinderGoogle Colab是基于有限资源的免费在线服务。 如果享有获得最佳性能体验,请遵循安装指南在本地运行Notebooks。

-----------------------------------------------------

⚙️ 系统要求

这些notebooks可以运行在任何地方,包括你的笔记本电脑,云VM,或者一个Docker容器。下表列出了所支持的操作系统和Python版本。

支持的操作系统 Python Version (64-bit)
Ubuntu 20.04 LTS, 64-bit 3.8 - 3.11
Ubuntu 22.04 LTS, 64-bit 3.8 - 3.11
Red Hat Enterprise Linux 8, 64-bit 3.8 - 3.11
CentOS 7, 64-bit 3.8 - 3.11
macOS 10.15.x versions or higher 3.8 - 3.11
Windows 10, 64-bit Pro, Enterprise or Education editions 3.8 - 3.11
Windows Server 2016 or higher 3.8 - 3.11

-----------------------------------------------------

💻 运行Notebooks

启动单个Notebook

如果你希望启动单个的notebook(如:Monodepth notebook),运行以下命令:

jupyter vision-monodepth.ipynb

启动所有Notebooks

jupyter lab notebooks

在浏览器中,从Jupyter Lab侧边栏的文件浏览器中选择一个notebook文件,每个notebook文件都位于notebooks 目录中的子目录中。

-----------------------------------------------------

🧹 清理

  1. 停止Jupyter Kernel

    Ctrl-c结束 Jupyter session,会弹出一个提示框 Shutdown this Jupyter server (y/[n])?,您可以输入 y and 敲击 Enter回车。

  1. 注销虚拟环境

    注销虚拟环境:只需在激活了openvino_env的终端窗口中运行 deactivate即可。

    重新激活环境:在Linux上运行 source openvino_env/bin/activate 或者在Windows上运行 openvino_env\Scripts\activate 即可,然后输入 jupyter labjupyter notebook 即可重新运行notebooks。

  1. 删除虚拟环境 (可选)

    直接删除 openvino_env 目录即可删除虚拟环境:

  • On Linux and macOS:

    rm -rf openvino_env
  • On Windows:

    rmdir /s openvino_env
  • 从Jupyter中删除 openvino_env Kernel

    jupyter kernelspec remove openvino_env

-----------------------------------------------------

⚠️ 故障排除

如果以下方法无法解决您的问题,欢迎创建一个讨论主题issue!

  • 运行 python check_install.py 可以帮助检查一些常见的安装问题,该脚本位于openvino_notebooks 目录中。 记得运行该脚本之前先激活 openvino_env 虚拟环境。
  • 如果出现 ImportError ,请检查是否安装了 Jupyter Kernel。如需手动设置kernel,从 Jupyter Lab 或 Jupyter Notebook 的_Kernel->Change Kernel_菜单中选择openvino_env内核。
  • 如果OpenVINO是全局安装的,不要在执行了setupvars.batsetupvars.sh的终端中运行安装命令。
  • 对于Windows系统,我们建议使用_Command Prompt (cmd.exe),而不是_PowerShell。

-----------------------------------------------------

🧑‍💻 贡献者

使用 contributors-img制作。

-----------------------------------------------------