Ñò pXJc@s’dZddkZddkZddklZddkZdefd„ƒYZ h dd6dd 6d d 6d d 6dd6dd6dd6dd6dd6dd6Z ei e ƒZ d„Z d„Zdefd„ƒYZ dd„Zdefd „ƒYZeid!ƒeƒZd"efd#„ƒYZd$efd%„ƒYZd&efd'„ƒYZd(efd)„ƒYZd*efd+„ƒYZd,efd-„ƒYZdS(.s2 Base classes for matlab (TM) file stream reading iÿÿÿÿN(tdoccert MatReadErrorcBseZRS((t__name__t __module__(((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyRssfile_name : string Name of the mat file (do not need .mat extension if appendmat==True) If name not a full path name, search for the file on the sys.path list and use the first one found (the current directory is searched first). Can also pass open file-like objecttfile_argsƒappendmat : {True, False} optional True to append the .mat extension to the end of the given filename, if not already presentt append_args¼base_name : string, optional, unused base name for unnamed variables. The code no longer uses this. We deprecate for this version of scipy, and will remove it in future versionst basename_args³byte_order : {None, string}, optional None by default, implying byte order guessed from mat file. Otherwise can be one of ('native', '=', 'little', '<', 'BIG', '>') mat_dtype : {False, True} optional If True, return arrays in same dtype as would be loaded into matlab (instead of the dtype with which they are saved) squeeze_me : {False, True} optional whether to squeeze unit matrix dimensions or not chars_as_strings : {True, False} optional whether to convert char arrays to string arrays matlab_compatible : {False, True} returns matrices as would be loaded by matlab (implies squeeze_me=False, chars_as_strings=False, mat_dtype=True, struct_as_record=True)t load_argss“struct_as_record : {False, True} optional Whether to load matlab structs as numpy record arrays, or as old-style numpy arrays with dtype=object. Setting this flag to False replicates the behaviour of scipy version 0.6 (returning numpy object arrays). The preferred setting is True, because it allows easier round-trip load and save of matlab files. In a future version of scipy, we will change the default setting to True, and following versions may remove this flag entirely. For now, we set the default to False, for backwards compatibility, but issue a warning. Note that non-record arrays cannot be exported via savemat.t struct_args@mat_stream : file-like object with file API, open for readingt matstream_args long_field_names : boolean, optional, default=False * False - maximum field name length in a structure is 31 characters which is the documented maximum length * True - maximum field name length in a structure is 63 characters which works for Matlab 7.6t long_fieldsshdo_compression : {False, True} bool, optional Whether to compress matrices on write. Default is Falsetdo_compressions–oned_as : {'column', 'row'} string, optional If 'column', write 1D numpy arrays as column vectors If 'row', write 1D numpy arrays as row vectorstoned_assrunicode_strings : {True, False} boolean, optional If True, write strings as Unicode, else matlab usual encodingtunicode_stringscCs%d}x|D]}||9}q W|S(s& Faster than product for small arrays i((tarrtreste((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyt small_productTs cCsë|idƒtidd dtid|idƒƒ}d|jo|idƒd S|idƒ|idƒ}|idƒt|ddjƒ}t||ƒ}t|d |ƒ}||f}|djo|Std |ƒ‚d S(sV Return major, minor tuple depending on apparent mat file type Where: #. 0,x -> version 4 format mat files #. 1,x -> version 5 format mat files #. 2,x -> version 7.3 format mat files (HDF format) Parameters ---------- fileobj : {file-like} object implementing seek() and read() Returns ------- major_version : {0, 1, 2} major matlab file format version minor_version : int major matlab file format version Notes ----- Has the side effect of setting the file read pointer to 0 itshapeitdtypetbufferi|itIis%Unknown mat file type, version %s, %sN(i(ii(ii(tseektnptndarraytuint8treadtinttordt ValueError(tfileobjt mopt_bytesttst_strtmaj_indtmaj_valtmin_valtret((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytget_matfile_version\s$        cBseZRS((RR(((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyRstcolumncCs|idjodti|idgƒS|i}|djod St|ƒdjo@|djo |d S|djo d |Std|ƒ‚n|S( sü Determine equivalent matlab dimensions for given array Parameters ---------- arr : ndarray oned_as : {'column', 'row'} string, optional Returns ------- dims : shape as matlab expects Examples -------- >>> matdims(np.array(1)) # numpy scalar (1, 1) >>> matdims(np.array([1])) # 1d array, 1 element (1, 1) >>> matdims(np.array([1,2])) # 1d array, 2 elements (2, 1) >>> matdims(np.array([[2],[3]])) # 2d array, column vector (2, 1) >>> matdims(np.array([[2,3]])) # 2d array, row vector (1, 2) >>> matdims(np.array([[[2,3]]])) # 3d array, rowish vector (1, 1, 2) >>> matdims(np.array([])) # empty 1d array (0, 0) >>> matdims(np.array([[]])) # empty 2d (0, 0) >>> matdims(np.array([[[]]])) # empty 3d (0, 0, 0) Optional argument flips 1d shape behavior >>> matdims(np.array([1,2]), 'row') # 1d array, 2 elements (1, 2) The argument has to make sense though >>> matdims(np.array([1,2]), 'bizarre') Traceback (most recent call last): ... ValueError: 1D option "bizarre" is strange Notes ----- We had to decide what shape a 1 dimensional array would be by default. ``np.atleast_2d`` thinks it is a row vector. The default for a vector in matlab (e.g. ``>> 1:12``) is a row vector. Versions of scipy up to and including 0.7 resulted (accidentally) in 1d arrays being read as column vectors. For the moment, we maintain the same tradition here. iiiR&trows1D option "%s" is strange(i((ii(i(i(tsizeRtmaxtndimRtlenR(RR R((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytmatdims’s7      t ByteOrdercBs2eZdZeiZeiZeiZeiZRS(s Namespace for byte ordering ( RRt__doc__tboct sys_is_let little_endiant native_codet swapped_codet to_numpy_code(((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyR-Ùs    s§ We no longer use the ByteOrder class, and deprecate it; we will remove it in future versions of scipy. Please use the scipy.io.matlab.byteordercodes module instead. tMatStreamAgentcBs)eZdZd„Zd„Zd„ZRS(sÁ Base object for readers / getters from mat file streams Attaches to initialized stream Base class for "getters" - which do store state of what they are reading on initialization, and therefore need to be initialized before each read, and "readers" which do not store state, and only need to be initialized once on object creation Implements common array reading functions Inputs mat_steam - MatFileReader object cCs ||_dS(N(t mat_stream(tselfR6((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyt__init__ösc Cs=|i}tiddd|d|ii|ƒddƒ}|S(s¡ Generic get of byte stream data of known type Inputs a_dtype - dtype of array a_dtype is assumed to be correct endianness RRRtordertF((titemsizeRRR6R(R7ta_dtypet num_bytesR((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyt read_dtypeùs   cCs|ii|ƒidƒS(Nt(R6Rtstrip(R7R=((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyt read_ztstrings(RRR.R8R>RA(((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyR5çs   t MatFileReadercBs(eZdZedeeeedd„ƒZd„Zd„Z d„Z e e e ddƒZ d„Z d„Ze e eddƒZd „Zd „Ze eedd ƒZd „Zd „Ze eeddƒZd„Zd„Zd„Zd„Zd„Zd„Zd„Zdd„Zd„ZRS(sP Base object for reading mat files To make this class functional, you will need to override the following methods: set_dtypes - sets data types defs from byte order matrix_getter_factory - gives object to fetch next matrix from stream guess_byte_order - guesses file byte order from file cCsu||_h|_|p|iƒ}n||_|o|iƒn+||_||_||_|iƒ|_ dS(s– Initializer for mat file reader mat_stream : file-like object with file API, open for reading %(load_args)s N( R6tdtypestguess_byte_ordert order_codetset_matlab_compatiblet _squeeze_met_chars_as_stringst _mat_dtypetget_processor_functprocessor_func(R7R6t byte_ordert mat_dtypet squeeze_metchars_as_stringstmatlab_compatibletstruct_as_record((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyR8s      cCs.t|_t|_t|_|iƒ|_dS(s9 Sets options to return arrays as matlab (tm) loads them N(tTrueRItFalseRGRHRJRK(R7((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyRF5s   cCs|iS(N(RI(R7((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyt get_mat_dtype<scCs||_|iƒ|_dS(N(RIRJRK(R7RM((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyt set_mat_dtype>s sget/set mat_dtype propertycCs|iS(N(RG(R7((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytget_squeeze_meFscCs||_|iƒ|_dS(N(RGRJRK(R7RN((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytset_squeeze_meHs sget/set squeeze me propertycCs|iS(N(RH(R7((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytget_chars_as_stringsPscCs||_|iƒ|_dS(N(RHRJRK(R7RO((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytset_chars_as_stringsRs s!get/set chars_as_strings propertycCs|iS(N(t _order_code(R7((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytget_order_codeZscCs&ti|ƒ}||_|iƒdS(N(R/R4RZt set_dtypes(R7RE((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pytset_order_code\s sget/set order codecCsdS(s6 Set dtype endianness. In this case we have no dtypes N((R7((sGP:\graphics\Tools\Python26\lib\site-packages\scipy\io\matlab\miobase.pyR\escCsD|iƒ}x1|D])}ti||ƒi|iƒ||s<       3 G%Ð"#