'Python to GNU Octave bridge --> run m-files from python.'
Project description
Oct2Py allows you 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:
>>> import oct2py
>>> oc = oct2py.Oct2Py()
>>> x = oc.zeros(3, 3)
>>> print(x, x.dtype)
[[0. 0. 0.]
[0. 0. 0.]
[0. 0. 0.]] float64To run .m function, you need to explicitly add the path to .m file using:
>>> from oct2py import octave
>>> # to add a folder use:
>>> octave.addpath("/path/to/directory") # doctest: +SKIP
>>> # to add folder with all subfolder in it use:
>>> octave.addpath(octave.genpath("/path/to/directory")) # doctest: +SKIP
>>> # to run the .m file :
>>> octave.run("fileName.m") # doctest: +SKIPTo get the output of .m file after setting the path, use:
>>> import numpy as np
>>> from oct2py import octave
>>> x = np.array([[1, 2], [3, 4]], dtype=float)
>>> # use nout='max_nout' to automatically choose max possible nout
>>> octave.addpath("./example") # doctest: +SKIP
>>> out, oclass = octave.roundtrip(x, nout=2) # doctest: +SKIP
>>> import pprint # doctest: +SKIP
>>> pprint.pprint([x, x.dtype, out, oclass, out.dtype]) # doctest: +SKIP
[array([[1., 2.],
[3., 4.]]),
dtype('float64'),
array([[1., 2.],
[3., 4.]]),
'double',
dtype('<f8')]If you want to run legacy m-files, do not have MATLAB®, and do not fully trust a code translator, this is your library.
Features
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/struct arrays with arbitrary nesting.
Supports sparse matrices.
Builds methods on the fly linked to Octave commands (e.g. zeros above).
Thread-safety: each Oct2Py object uses an independent Octave session.
Can be used as a context manager.
Supports Unicode characters.
Supports logging of session commands.
Optional timeout command parameter to prevent runaway Octave sessions.
Installation
You must have GNU Octave installed and in your PATH environment variable. Alternatively, you can set an OCTAVE_EXECUTABLE or OCTAVE environment variable that points to octave executable itself.
You must have the Numpy and Scipy libraries for Python installed. See the installation instructions for more details.
Once the dependencies have been installed, run:
$ pip install oct2pyIf using conda, it is available on conda-forge:
$ conda install -c conda-forge oct2pyDocumentation
Documentation is available online.
For version information, see the Changelog.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file oct2py-5.7.0.tar.gz.
File metadata
- Download URL: oct2py-5.7.0.tar.gz
- Upload date:
- Size: 441.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ec5f1feeeb9bcd353efd3040911f6c53427db0a4856d81730b745748b0552d2e |
|
| MD5 | 1acebcc5fe411818b2f6d2499216e83d |
|
| BLAKE2b-256 | b7c7747eab9159ba4c1747ca27815ae7f9f69acc2208f2c3eea1bdc47fc74125 |
Provenance
File details
Details for the file oct2py-5.7.0-py3-none-any.whl.
File metadata
- Download URL: oct2py-5.7.0-py3-none-any.whl
- Upload date:
- Size: 29.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/5.1.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c120148d67f47bc984257e8902fadea538a4550d9f521865efb2781d2fb68d4c |
|
| MD5 | 0ae2ad48ad4ec758ed078c2403c8eda6 |
|
| BLAKE2b-256 | 1de86c31682035e145fe84034569362e6eb5d2da081242e3ebfe740ec8448caa |
