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')]