imatlab 0.4

安装

如往常一样，使用pip安装

$ pip install imatlab  # from PyPI
$ pip install git+https://github.com/imatlab/imatlab  # from Github

然后，使用以下命令注册kernelspec

$ python -mimatlab install

在没有管理员权限的情况下，应将这些命令的所有命令中添加--user标志。

使用

# Notebook (in the notebook interface, select Matlab from the 'New' menu):
$ jupyter notebook
# or QtConsole:
$ jupyter qtconsole --kernel imatlab
# or terminal:
$ jupyter console --kernel imatlab

内联图形

MATLAB图形可以在原生的MATLAB窗口中显示（默认），或者（当使用笔记本时）作为内联图像。内核可以原生地显示静态图像，或者使用Plotly生成交互式的JavaScript图形。

通过调用imatlab_export_fig函数设置导出器，该函数在内核运行时自动添加到MATLAB路径。以下是一些可能的设置

imatlab_export_fig('')  % Native windows.
imatlab_export_fig('fig2plotly')  % Plotly figures.
imatlab_export_fig('print-png')  % Static png figures.
imatlab_export_fig('print-svg')  % Static svg figures.
imatlab_export_fig('print-jpeg')  % Static jpeg figures.

必须在第一个图形显示之前发出此调用。请注意，非原生导出器将调用set(0, 'defaultfigurevisible', 'off')以防止窗口短暂显示，而使用原生窗口将默认图形可见性恢复为'on'。

环境变量

IMATLAB_CONNECT

如果此环境变量设置为有效的 MATLAB 标识符，内核将尝试连接到具有该名称的共享引擎。如果设置为另一个非空值，它将连接到任何现有的共享引擎。

IMATLAB_CD

如果此环境变量已设置，则将工作目录更改为与内核的工作目录匹配。

IMATLAB_CONNECT 需要在 MATLAB 外部设置（因为它在连接到引擎之前进行检查）。其他环境变量可以在 MATLAB 外部设置（在启动内核之前）或在 MATLAB 内部设置（使用 setenv）。

异步输出

如 1, pause(1), 2 这样的结构，在 Linux 和 OSX 上将以一秒间隔输出 1 和 2，但在 Windows 上将一起在一秒后输出。欢迎提交改进 Windows 支持的 PR。

使用 timer 对象的异步输出似乎完全不受 MATLAB 引擎对 Python 的支持。

MATLAB调试器

在每次执行之前清除 MATLAB 调试器（dbclear all），因为引擎 API 不支持交互式输入。

与Calysto MATLAB内核的差异

• 通过依赖 MATLAB 2016b 中可用的新 API，完成系统更加健壮。

• 历史记录从 MATLAB 自身的 History.xml 中读取和写入，因此与标准 MATLAB 会话共享。请注意，如果文件不存在（例如，如果设置了“不保存历史文件”选项，或在仅控制台设置中），则历史记录不会重新加载到后续会话中。（欢迎提交加载 history.m 的 PR；它需要正确解析该文件中的多行输入。）

• 在 Linux 和 OSX 上支持同步输出（见上文）。

• 没有魔术系统，因为MATLAB已经提供了许多用于此目的的函数（如 cd、edit 等）。

• 内联图形可以基于 plotly，因此是交互式的。

测试

在安装内核和 jupyter_kernel_test 之后，使用 python -munittest 或 pytest 运行测试。