PythonEnvironment

Python 环境信息

自 R2019b 起

说明

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

创建对象

要创建 PythonEnvironment 对象或更改设置，请调用 pyenv。当您调用 py 包中的 Python 命令时，会加载 Python 解释器。在 MATLAB 加载 Python 后，您无法更改解释器。要更改解释器，请重新启动 MATLAB，然后调用 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