1 Star 0 Fork 0

pyminer / octave_kernel

加入 Gitee
与超过 600 万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README.rst

An Octave kernel for Jupyter

Prerequisites

Jupyter Notebook and GNU Octave.

It is recommended to also install gnuplot for Octave to enable inline plotting.

Installation

To install using pip:

pip install octave_kernel

Add --user to install in the user-level environment instead of the system environment.

To install using conda:

conda config --add channels conda-forge
conda install octave_kernel
conda install texinfo # For the inline documentation (shift-tab) to appear.

We require the octave-cli executable to run the kernel. Add that executable's directory to the PATH environment variable or use the OCTAVE_EXECUTABLE to point to the executable itself. Note that on Octave 5 on Windows, the executable is in "Octave-5.x.x.x\mingw64\bin".

We automatically install a Jupyter kernelspec when installing the python package. This location can be found using jupyter kernelspec list. If the default location is not desired, remove the directory for the octave kernel, and install using python -m octave_kernel install. See python -m octave_kernel install --help for available options.

Usage

To use the kernel, run one of:

jupyter notebook  # or ``jupyter lab``, if available
# In the notebook interface, select Octave from the 'New' menu
jupyter qtconsole --kernel octave
jupyter console --kernel octave

This kernel is based on MetaKernel, which means it features a standard set of magics (such as %%html). For a full list of magics, run %lsmagic in a cell.

A sample notebook is available online.

Configuration

The kernel can be configured by adding an octave_kernel_config.py file to the jupyter config path. The OctaveKernel class offers plot_settings, inline_toolkit, kernel_json, and cli_options as configurable traits. The available plot settings are: 'format', 'backend', 'width', 'height', 'resolution', and 'plot_dir'.

cat ~/.jupyter/octave_kernel_config.py
# use Qt as the default backend for plots
c.OctaveKernel.plot_settings = dict(backend='qt')

The path to the Octave kernel JSON file can also be specified by creating an OCTAVE_KERNEL_JSON environment variable.

The command line options to Octave can also be specified with an OCTAVE_CLI_OPTIONS environment variable. The cli options be appended to the default opions of --interactive --quiet --no-init-file. Note that the init file is explicitly called after the kernel has set more off to prevent a lockup when the pager is invoked in ~/.octaverc.

The inline toolkit is the graphics_toolkit used to generate plots for the inline backend. It defaults to gnuplot. The different backend can be used for inline plotting either by using this configuration or by using the plot magic and putting the backend name after inline:, e.g. plot -b inline:fltk.

Troubleshooting

Kernel Times Out While Starting

If the kernel does not start, run the following command from a terminal:

python -m octave_kernel.check

This can help diagnose problems with setting up integration with Octave. If in doubt, create an issue with the output of that command.

Kernel is Not Listed

If the kernel is not listed as an available kernel, first try the following command:

python -m octave_kernel install --user

If the kernel is still not listed, verify that the following point to the same version of python:

which python  # use "where" if using cmd.exe
which jupyter

Gnuplot Error

An error that starts with gnuplot> set terminal aqua enhanced title can be fixed by adding setenv("GNUTERM","qt"); to ~/.octaverc on MacOS or by installing gunplot-x11 and using setenv("GNUTERM", "X11").

Octave-Snap (Linux)

You can check if you are using a snap version on Linux by checking the path to your Octave installation.

which octave

If the returned path has snap in it, then Octave is running in a container and you will need to configure the kernel appropriately.

  1. Set the environment variable OCTAVE_EXECUTABLE="octave"
echo export OCTAVE_EXECUTABLE=\"octave\" >> ~/.bashrc
  1. Make a directory for the temporary plot directories that the kernel uses. This cannot be a hidden directory.
mkdir ~/octavePlots
  1. Set plot_dir to point to your plot directory in octave_kernel_config.py.
c.OctaveKernel.plot_settings = dict(plot_dir='<home>/octavePlots')

where <home> is the absolute path to your home directory. Do not use ~ as this resolves to a different location for Octave-Snap.

Blank Plot

Specify a different format using the %plot -f <backend> magic or using a configuration setting. On some systems, the default 'png' produces a black plot. On other systems 'svg' produces a black plot.

点评 ( 0 )

你可以在登录后,发表评论

简介

暂无描述 展开 收起
BSD-3-Clause
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Python
1
https://gitee.com/py2cn/octave_kernel.git
git@gitee.com:py2cn/octave_kernel.git
py2cn
octave_kernel
octave_kernel
master

搜索帮助

105716 1d94204e 1850385 105716 2d26be5c 1850385