主要内容

安装并导入 MATLAB Compiler SDK Python

使用 MATLAB® Compiler SDK™ 生成 Python® 包后,必须在目标计算机上安装 MATLAB Runtime 和该包。在 Python 应用程序中导入该包以调用编译的 MATLAB 函数。

安装 Python

如果您使用 Python 包编译器compiler.package.installer 函数创建安装程序,该安装程序将包含安装 Python 包以及可选的 MATLAB Runtime 所需的文件。

您也可以手动分发 Python 包文件。为了运行 Python 应用程序,目标计算机必须能够访问与用于编译包的 MATLAB 版本匹配且更新级别相同或更高的 MATLAB Runtime。有关详细信息,请参阅关于 MATLAB Runtime

使用生成的安装程序

  1. 将安装程序分发到所需位置。

  2. 运行安装程序。

  3. 记下安装程序写入 Python 包文件的位置。

  4. 安装程序完成后,打开系统命令提示符窗口,导航到包含 Python 包文件的文件夹。

  5. 通过在系统命令行中运行 python -m pip install . [options] 来安装该包。如果您拥有完全管理员权限并安装到默认位置,则无需指定任何选项。否则,请使用 --user 安装到主文件夹,或使用 --prefix="installdir" 安装到特定目录。如果安装到默认位置以外的位置,请将 installdir 添加到 PYTHONPATH 环境变量中。有关更多详细信息,请参阅安装 Python 模块 - Python 3.7.16 文档

  6. MATLAB Runtime 文件夹添加到库路径环境变量中。有关详细信息,请参阅针对部署设置 MATLAB Runtime 路径

使用包文件

  1. 分发以下文件以将 Python 包集成到应用程序中。

    • setup.py - Python 安装程序

    • _init_.py - Python 包的初始化脚本

    • packageName .ctf - 可部署存档

    • 已部署的 MATLAB 函数的函数签名(有关详细信息,请参阅自定义代码建议和自动填充

  2. 打开系统命令提示符窗口,导航到包含 Python 包文件的文件夹。

  3. 通过在系统命令行中运行 python -m pip install . [options] 来安装该包。如果您拥有完全管理员权限并安装到默认位置,则无需指定任何选项。否则,请使用 --user 安装到主文件夹,或使用 --prefix="installdir" 安装到特定目录。如果安装到默认位置以外的位置,请将 installdir 添加到 PYTHONPATH 环境变量中。有关更多详细信息,请参阅安装 Python 模块 - Python 3.7.16 文档

  4. 安装与用于编译 Python 包的 MATLAB 版本匹配的 MATLAB Runtime。有关详细信息,请参阅下载并安装 MATLAB Runtime

  5. MATLAB Runtime 文件夹添加到库路径环境变量中。有关详细信息,请参阅针对部署设置 MATLAB Runtime 路径

导入 Python

在编译过程中,您可以指定包命名空间,该命名空间是一个以句点分隔的列表,例如 companyname.groupname.packageName

  • 如果您使用 compiler.build.pythonPackage 函数,则可以使用 PackageName 选项指定命名空间。生成的包的名称将设置为以句点分隔的列表的最后一个条目。

    如果未指定,则 PackageName 默认为 FunctionFiles 参量中列出的第一个 MATLAB 文件的名称。

  • 如果您使用 Python 包编译器,则可以使用 Package Name 字段指定包名称,使用 Namespace 字段指定命名空间。

    Package Name 字段默认为该 App 中列出的第一个 MATLAB 文件的名称。您可以将 Namespace 字段留空。

  • 如果您使用 mcc 函数,则可以将包名称和命名空间指定为 -W python:namespace.packageName 标志的一部分。

    如果未指定,则命名空间默认为命令中列出的第一个 MATLAB 文件的名称。

使用 import 语句后跟完整命名空间在 Python 应用程序中导入该包。

例如,如果您编译 MATLAB 函数并将包名称指定为不带命名空间的 addmatrix,则按如下方式导入:

import addmatrix

如果您使用命名空间 com.mathworks.addmatrix 编译 MATLAB 函数,则按如下方式导入:

import com.mathworks.addmatrix

另请参阅

|

主题

外部网站