Conversions

Python to Octave Types

Shows the round-trip data types, originating in Python. Lists and sets will be converted to a numeric array if possible, falling back on cells. If an Octave cell consisting of numbers is desired, use a tuple. Cell, Struct, StructArray are Oct2Py convenience classes.

Python	Octave	Python
int	int32	np.int32
long	int64	np.int64
float	double	np.float64
complex	double	np.complex128
str	char	unicode
unicode	cell	unicode
bool	logical	np.bool
None	nan	np.nan
dict	struct	Struct
tuple	cell	Cell
list	array or cell	ndarray or Cell
set	array or cell	ndarray or Cell
Struct	struct	Struct
StructArray	struct array	StructArray

Numpy to Octave Types

Note that when convert_to_float is set (default is True), integer types are converted to floating point before sending them to Octave.

Numpy	Octave	Numpy
np.int8	int8	np.int8
np.int16	int16	np.int16
np.int32	int32	np.int32
np.int64	int64	np.int64
np.uint8	uint8	np.uint8
np.uint16	uint16	np.uint16
np.uint32	uint32	np.uint32
np.uint64	uint64	np.uint64
np.float16	double	np.float64
np.float32	single	np.float32
np.float64	double	np.float64
np.float128	double	np.float64
np.double	double	np.float64
np.complex64	double	np.complex64
np.complex128	double	np.complex128
np.complex256	double	np.complex128
np.bool	logical	bool
np.str	cell	list
np.object	cell	list
sparse	sparse	sparse
recarray	struct array	StructArray

Octave to Python Types

These are handled unambiguously. The only known data type that is not transferable is a function pointer, since Octave cannot save them to the v6 MAT file format.

Octave	Python
array	ndarray
cell	Cell
struct	Struct
struct array	StructArray
logical	ndarray (of uint8)
sparse	sparse
user defined object	Oct2Py object pointer