PythonEnvironment

Python 环境信息

自 R2019b 起

全页展开

说明

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

创建对象

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

当您使用 py 包从 MATLAB 键入 Python 语句时，MATLAB 会选择并加载一个 Python 解释器，例如 py.list。要更改解释器，请执行以下操作：

如果在单一 MATLAB 会话中的 InProcess ExecutionMode 中加载了 Python，则重新启动 MATLAB 并使用新版本信息运行 pyenv。
如果在 OutOfProcess 模式下加载 Python，则调用 terminate 并使用新版本信息运行 pyenv。

属性

全部展开

`Version` — Python 版本
字符串

此属性为只读。

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

示例: "3.10"

`Executable` — Python 可执行文件的名称
字符串

此属性为只读。

Python 可执行文件的名称，以字符串形式返回。要设置 Executable 属性，请在 version 参量设置为 Python 可执行文件名称（也可以设置完整路径）的状态下调用 pyenv。

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

`Library` — 共享库文件
字符串

此属性为只读。

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

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

`Home` — 主文件夹
字符串

此属性为只读。

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

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

`Status` — 进程状态
`NotLoaded` (默认) | `Loaded` | `Terminated`

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

示例: Terminated

`ExecutionMode` — 执行模式
`InProcess` (默认) | `OutOfProcess`

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

示例: OutOfProcess

`ProcessID` — 进程 ID
字符串

此属性为只读。

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

示例: "9388"

`ProcessName` — 进程名称
字符串

此属性为只读。

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

示例: "MATLABPyHost"

对象函数

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

示例

全部折叠

显示您的系统的 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