scipy.io.matlab.

whosmat#

scipy.io.matlab.whosmat(file_name, appendmat=True, **kwargs)[source]#

列出 MATLAB 文件中的变量。

参数:
file_namestr

mat 文件的名称(如果 appendmat==True,则不需要 .mat 扩展名)。也可以传递打开的文件类对象。

appendmatbool, 可选

如果给定的文件名没有 .mat 扩展名,则将其追加到末尾。默认值为 True。

byte_orderstr 或 None, 可选

默认值为 None,表示从 mat 文件中猜测字节序。否则可以是以下之一 ('native', '=', 'little', '<', 'BIG', '>')。

mat_dtypebool, 可选

如果为 True,则返回与加载到 MATLAB 中相同数据类型的数组(而不是保存它们的数据类型)。

squeeze_mebool, 可选

是否压缩单位矩阵维度。

chars_as_stringsbool, 可选

是否将字符数组转换为字符串数组。

matlab_compatiblebool, 可选

返回与 MATLAB 加载的矩阵相同的矩阵(这意味着 squeeze_me=False, chars_as_strings=False, mat_dtype=True, struct_as_record=True)。

struct_as_recordbool, 可选

是否将 MATLAB 结构体加载为 NumPy 记录数组,还是作为旧式 NumPy 数组,其中 dtype=object。将此标志设置为 False 将复制 SciPy 版本 0.7.x 的行为(返回 numpy 对象数组)。默认设置为 True,因为它允许更轻松地对 MATLAB 文件进行往返加载和保存。

返回值:
variables元组列表

一个元组列表,每个元组包含矩阵名称(字符串)、其形状(整数元组)及其数据类别(字符串)。可能的数据类别为:int8、uint8、int16、uint16、int32、uint32、int64、uint64、single、double、cell、struct、object、char、sparse、function、opaque、logical、unknown。

备注

支持 v4(级别 1.0)、v6 和 v7 到 7.2 的 mat 文件。

要读取 matlab 7.3 格式的 mat 文件,您需要一个 HDF5 python 库(例如 h5py)。由于 SciPy 没有提供一个,因此我们在这里没有实现 HDF5/7.3 接口。

在版本 0.12.0 中添加。

示例

>>> from io import BytesIO
>>> import numpy as np
>>> from scipy.io import savemat, whosmat

创建一些数组,并使用 savemat 将它们写入 BytesIO 实例。

>>> a = np.array([[10, 20, 30], [11, 21, 31]], dtype=np.int32)
>>> b = np.geomspace(1, 10, 5)
>>> f = BytesIO()
>>> savemat(f, {'a': a, 'b': b})

使用 whosmat 检查 f。输出列表中的每个元组都给出了 f 中数组的名称、形状和数据类型。

>>> whosmat(f)
[('a', (2, 3), 'int32'), ('b', (1, 5), 'double')]