PythonEnvironment

Python 环境信息

全页展开

说明

PythonEnvironment 对象包含有关 Python® 解释器的设置和状态的信息。当您调用 py. 命令时，MATLAB® 会与解释器通信。Python 环境信息在不同 MATLAB 会话中持久保留。

创建对象

要创建 PythonEnvironment 对象或更改设置，请调用 pyenv。

当您使用 py 命名空间从 MATLAB 键入 Python 表达式时，MATLAB 会选择并加载一个 Python 解释器，例如 py.list。要更改解释器，请执行以下操作：

  • 如果在 InProcess ExecutionMode 中加载了 Python，则重新启动 MATLAB 并使用新版本信息或执行模式调用 pyenv。

  • 如果在 OutOfProcess 模式下加载了 Python，则在使用新版本信息或执行模式调用 pyenv 之前，通过调用 terminate 终止 (terminate) 与 Python 解释器关联的进程。

属性

全部展开

此 属性 为只读。

Python 版本，以字符串形式返回。要设置 Version 属性，请在 Version 名称-值参量设置为 MATLAB 支持的版本号的状态下调用 pyenv。有关受支持版本的信息，请参阅配置您的系统使用 Python。

示例: "3.10"

此 属性 为只读。

Python 可执行文件的名称，以字符串形式返回。要设置 Executable 属性，请在 Version 名称-值参量设置为 Python 可执行文件的相对或绝对路径的情况下调用 pyenv。

示例: "/usr/local/bin/python"

此 属性 为只读。

共享库文件，以字符串形式返回。

示例: "libpython3.10.so.1.0"

此 属性 为只读。

主文件夹，以字符串形式返回。

示例: "/usr/local/bin/../.."

进程状态，指定为 NotLoaded、Loaded 或 Terminated。

示例: Terminated

执行模式，它指示是否在与 MATLAB 相同的进程中运行 Python 脚本；指定为 InProcess 或 OutOfProcess。要设置 ExecutionMode 属性，请带 ExecutionMode 名称-值参量调用 pyenv。

示例: OutOfProcess

此 属性 为只读。

正在运行 Python 解释器的进程的 ID，以字符串形式返回。如果 ExecutionMode 是 InProcess，则 ProcessID 是 MATLAB 进程 ID。如果 Status 为 NotLoaded，则 ProcessID 为空。

示例: "9388"

此 属性 为只读。

注册表中的进程名称，以字符串形式返回。

示例: "MATLABPyHost"

对象函数

terminate终止与 Python 解释器相关联的进程

示例

全部折叠

pe = pyenv

pe = 

  PythonEnvironment with properties:

          Version: "3.10"
       Executable: "C:\Python310\pythonw.exe"
          Library: "C:\windows\system32\python310.dll"
             Home: "C:\Python310"
           Status: NotLoaded
    ExecutionMode: OutOfProcess

局限性

  • 不支持将 PythonEnvironment 对象保存（序列化）到 MAT 文件。

版本历史记录

在 R2019b 中推出

另请参阅

主题