+ LV-j.3^aR,t 0tRt^RIHt^RIt^RIHt^RIH t .R-Ot !R R] 4t !R R] 4t!R R]4t!R R]4tR RRRRRRRRRRRRRRRRR/ t]P&!]4t]^kRtR tR!R"/R#lt]t^tR$tR.R%lt!R&R'4t!R(R)4tR*tR+tR#)/zf Base classes for MATLAB file stream reading. MATLAB is a registered trademark of the Mathworks inc. )FinalN)doccer)_byteordercodes MatReadErrorMatReadWarning MatWriteErrorMatWriteWarningc]tRt^tRtRtR#)rz"Exception indicating a read issue.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r i/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/scipy/io/matlab/_miobase.pyrrs,rc]tRt^tRtRtR#)rz#Exception indicating a write issue.r Nr r rrrrs-rc]tRt^tRtRtR#)rzWarning class for read issues.r Nr r rrrrs(rc]tRt^tRtRtR#)rzWarning class for write issues.r Nr r rrrrs)rfile_argzfile_name : str Name of the mat file (do not need .mat extension if appendmat==True) Can also pass open file-like object. append_argzappendmat : bool, optional True to append the .mat extension to the end of the given filename, if not already present. Default is True. load_argsabyte_order : str or None, optional None by default, implying byte order guessed from mat file. Otherwise can be one of ('native', '=', 'little', '<', 'BIG', '>'). mat_dtype : bool, 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 : bool, optional Whether to squeeze unit matrix dimensions or not. chars_as_strings : bool, optional Whether to convert char arrays to string arrays. matlab_compatible : bool, optional Returns matrices as would be loaded by MATLAB (implies squeeze_me=False, chars_as_strings=False, mat_dtype=True, struct_as_record=True). struct_argabstruct_as_record : bool, 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 behavior of SciPy version 0.7.x (returning numpy object arrays). The default setting is True, because it allows easier round-trip load and save of MATLAB files. matstream_argzAmat_stream : file-like Object with file API, open for reading. long_fieldsalong_field_names : bool, optional * False - maximum field name length in a structure is 31 characters which is the documented maximum length. This is the default. * True - maximum field name length in a structure is 63 characters which works for MATLAB 7.6do_compressionz[do_compression : bool, optional Whether to compress matrices on write. Default is False.oned_aszoned_as : {'row', 'column'}, optional If 'column', write 1-D NumPy arrays as column vectors. If 'row', write 1D NumPy arrays as row vectors.unicode_stringszbunicode_strings : bool, optional If True, write strings as Unicode, else MATLAB usual encoding.cVP4pVF0p\P!W#,4PV4W#&K2 V#)amConvert dtypes in mapping to given order Parameters ---------- dtype_template : mapping mapping with values returning numpy dtype from ``np.dtype(val)`` order_code : str an order code suitable for using in ``dtype.newbyteorder()`` Returns ------- dtypes : mapping mapping where values have been replaced by ``np.dtype(val).newbyteorder(order_code)`` )copynpdtype newbyteorder)dtype_template order_codedtypesks&& rconvert_dtypesr)s>" "F HHVY'44Z@  MrcpVPp\P!RVVPV4RR7pV#)a2 Generic get of byte stream data of known type Parameters ---------- mat_stream : file_like object MATLAB (tm) mat file stream a_dtype : dtype dtype of array to read. `a_dtype` is assumed to be correct endianness. Returns ------- arr : ndarray Array of dtype `a_dtype` read from stream. F)shaper#bufferorderr )itemsizer"ndarrayread) mat_streama_dtype num_bytesarrs&& r read_dtyper6s8$  I **2"&OOI6 C Jr appendmatTc^RIHpV!WR7;_uu_4p\V4uuRRR4# +'giR#;i)a$ 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 ---------- file_name : str Name of the mat file (do not need .mat extension if appendmat==True). Can also pass open file-like object. appendmat : bool, optional True to append the .mat extension to the end of the given filename, if not already present. Default is True. Returns ------- major_version : {0, 1, 2} major MATLAB File format version minor_version : int minor MATLAB file format version Raises ------ MatReadError If the file is empty. ValueError The matfile version is unknown. Notes ----- Has the side effect of setting the file read pointer to 0 )_open_file_context)r7N)_mior9_get_matfile_version) file_namer7r9fileobjs&$ rmatfile_versionr>s,J) I ; ;w#G, < ; ; ;s . ? cVP^4VP\4p\V4\8d \ R4hVP ^4\8Xd\ R\ R24h\ P!R\ PVR,R7p^V9dVP^4R#VP^|4VP^4pVP^4\V^,^I8H4p\W4,4p\V^V, ,4pWV3pVR 9dV#\RP!V!4h) z Mat file appears to be truncatedz&Mat file appears to be corrupt (first z bytes == 0):NNr,r#r-z%Unknown mat file type, version {}, {})rAr@r@)) seekr1 _HDR_N_BYTESlenrcountr"r0uint8int ValueErrorformat)r= hdr_bytes mopt_intstst_strmaj_indmaj_valmin_valrets& rr;r;s LLO \*I 9~ $=>>q\)%%1N,@A A RXXimLII~ Q  LLll1oG LLO'!*'(G'"#G'!g+&'G  C& <CCSI JJrcVPpVR8XdR#\V4^8Xd@V^,^8XdR#VR8Xd VR,#VR8Xd RV,#\RV R24hV#) a. Determine equivalent MATLAB dimensions for given array Parameters ---------- arr : ndarray Input array oned_as : {'column', 'row'}, optional Whether 1-D arrays are returned as MATLAB row or column matrices. Default is 'column'. Returns ------- dims : tuple Shape tuple, in the form MATLAB expects it. 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.11 resulted (accidentally) in 1-D arrays being read as column vectors. For the moment, we maintain the same tradition here. Examples -------- >>> import numpy as np >>> from scipy.io.matlab._miobase import matdims >>> matdims(np.array(1)) # NumPy scalar (1, 1) >>> matdims(np.array([1])) # 1-D array, 1 element (1, 1) >>> matdims(np.array([1,2])) # 1-D array, 2 elements (2, 1) >>> matdims(np.array([[2],[3]])) # 2-D array, column vector (2, 1) >>> matdims(np.array([[2,3]])) # 2-D array, row vector (1, 2) >>> matdims(np.array([[[2,3]]])) # 3-D array, rowish vector (1, 1, 2) >>> matdims(np.array([])) # empty 1-D array (0, 0) >>> matdims(np.array([[]])) # empty 2-D array (0, 0) >>> matdims(np.array([[[]]])) # empty 3-D array (0, 0, 0) Optional argument flips 1-D shape behavior. >>> matdims(np.array([1,2]), 'row') # 1-D array, 2 elements (1, 2) The argument has to make sense though >>> matdims(np.array([1,2]), 'bizarre') Traceback (most recent call last): ... ValueError: 1-D option "bizarre" is strange columnrowz 1-D option "z " is stranger )rDrDrCrD)r,rHrL)r5rr,s&& rmatdimsrYsr~ IIE {  5zQ 8q=M  4<   %< |G9LAB B Lrc6a]tRtRtoRtRtRtRtRtVt R#) MatVarReaderiQz:Abstract class defining required interface for var readerscR#)Nr )self file_readers&&r__init__MatVarReader.__init__Ss rc R#)zReturns header Nr r]s&r read_headerMatVarReader.read_headerV rc R#)zReads array given header Nr )r]headers&&rarray_from_headerMatVarReader.array_from_headerZrerr N) r r rrrr_rcrhr__classdictcell__ __classdict__s@rr[r[QsE    rr[cJa]tRtRtoRt]R Rl4tRtRtRt Rt Vt R#) MatFileReaderi_zBase object for reading mat files To make this class functional, you will need to override the following methods: matrix_getter_factory - gives object to fetch next matrix from stream guess_byte_order - guesses file byte order from file Nc  4Wn/VnV'gVP4pM\P!V4pW nWpnV'dVP4MW@nWPn W0n Wn Wn V 'dRVnRVnR#R#)z Initializer for mat file reader mat_stream : file-like object with file API, open for reading %(load_args)s TFN) r2r'guess_byte_orderboc to_numpy_code byte_orderstruct_as_recordset_matlab_compatible squeeze_mechars_as_strings mat_dtype verify_compressed_data_integritysimplify_cells) r]r2rsrxrvrwmatlab_compatiblertryrzs &&&&&&&&&&rr_MatFileReader.__init__is~$% ..0J**:6J$ 0   & & ((O$4 !&N0P-, "DO$)D ! rc 0RVnRVnRVnR#)z3Sets options to return arrays as MATLAB loads them TFN)rxrvrwrbs&rru#MatFileReader.set_matlab_compatibles %rc "\P#)z8As we do not know what file type we have, assume native )rq native_coderbs&rrpMatFileReader.guess_byte_orders rcVPP^4pVPP4pVPPV^, 4\ V4^8H#rX)r2r1tellrFrH)r]bcurposs& r end_of_streamMatFileReader.end_of_streamsL OO  #%%' VAX&1v{r) rsrwr'rxr2rzrvrtry)NFFTFTTF) r r rrr docfillerr_rurprrrjrks@rrnrn_s3#*#*J& rrnc\P!VPPR,\V4,4#)z2Return dtype for given number of items per element:NrEN)r"r#str)r5nums&&rarr_dtype_numberrs' 88CIIMM"%C0 11rc\VP4pV'g^.pVP\VPP R,44\ P!V\V^4VR7pV\ P!RVPR78H.p\ P!V4'gV#VP4pRV\V4&V#)z#Convert string array to char array :rENNrB)r# ) listr,appendrKr#rr"r0rarrayanyr!tuple)r5dimsemptiess& r arr_to_charsrs  ?D sKKCIIMM"%&' **4+C3 !Cbhhr334G 66'?? ((*CCg Jrc@V^8dQh/^\9d \;R&#)rEr)__conditional_annotations__r)rMs"r __annotate__rs h,+5+ir)rrrr)rV)!rrtypingrnumpyr" scipy._librrrrq__all__ Exceptionrr UserWarningrrdoc_dictfilldocrr)r6r>get_matfile_versionrGr;rYr[rnrrr)rs@rrs $ -9-.I.)[)*k*  < 9  >  . #  ? 6 Ea1F h>>(+ +*Z.4'-D'-T& K8K\   >>B2 r