skip to navigation
skip to content

oct2py 1.2.0

Python to GNU Octave bridge --> run m-files from python.

Package Documentation

Latest Version: 4.0.6

Oct2Py is a means to seamlessly call M-files and Octave functions from Python. It manages the Octave session for you, sharing data behind the scenes using MAT files. Usage is as simple as:

>>> oc = oct2py.Oct2Py()
>>> x = oc.zeros(3,3)
>>> print x, x.dtype
[[ 0.  0.  0.]
 [ 0.  0.  0.]
 [ 0.  0.  0.]] float64

If you want to run legacy m-files, do not have MATLAB(TM), and do not fully trust a code translator, this is your library.


  • Supports all Octave datatypes and most Python datatypes and Numpy dtypes.
  • Provides OctaveMagic for IPython, including inline plotting in notebooks.
  • Supports cell arrays and structs with arbitrary nesting.
  • Supports sparse matrices.
  • Builds methods on the fly linked to Octave commands (e.g. zeros above).
  • Nargout is automatically inferred by the number of return variables.
  • Thread-safety: each Oct2Py object uses an independent Octave session.
  • Can be used as a context manager.
  • Supports Unicode characters.


You must have GNU Octave installed and in your PATH. On Windows, the easiest way to get Octave is to use an installer from Sourceforge. On Linux, it should be available from your package manager. Additionally, you must have the Numpy and Scipy libraries installed.

To install Oct2Py, simply:

$ pip install oct2py

Or, if you absolutely must:

$ easy_install oct2py


Documentation is available online.

For version information, see the Revision History.

File Type Py Version Uploaded on Size
oct2py-1.2.0-py2.py3-none-any.whl (md5) Python Wheel 2.7 2013-12-14 33KB
oct2py-1.2.0.tar.gz (md5) Source 2013-12-14 310KB
oct2py-1.2.0.win32-py2.7.exe (md5) MS Windows installer 2.7 2013-12-14 226KB
oct2py-1.2.0.win32-py3.2.exe (md5) MS Windows installer 3.2 2013-12-14 226KB
oct2py-1.2.0.win32-py3.3.exe (md5) MS Windows installer 3.3 2013-12-14 226KB (md5) Source 2013-12-14 323KB