(ph2 .%SrSSKJr SSKrSSKJr SSKJr /SQr "SS \ 5r "S S \ 5r "S S \5rSSSSSSSSSS. r\R""\5r\\S'SrSrSS.Sjr\rSrSrS'S jr"S!S"5r"S#S$5rS%rS&rg)(zf Base classes for MATLAB file stream reading. MATLAB is a registered trademark of the Mathworks inc. )FinalN)doccer)_byteordercodes) MatReadErrorMatReadWarning MatWriteErrorc\rSrSrSrSrg)rz"Exception indicating a read issue.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r K/var/www/html/venv/lib/python3.13/site-packages/scipy/io/matlab/_miobase.pyrrs,rrc\rSrSrSrSrg)r z#Exception indicating a write issue.r Nr r rrr r s-rr c\rSrSrSrSrg)rzWarning class for read issues.r Nr r rrrrs(rrzfile_name : str Name of the mat file (do not need .mat extension if appendmat==True) Can also pass open file-like object.zappendmat : bool, optional True to append the .mat extension to the end of the given filename, if not already present. Default is True.abyte_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).abstruct_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.zAmat_stream : file-like Object with file API, open for reading.along_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.6z[do_compression : bool, optional Whether to compress matrices on write. Default is False.zoned_as : {'row', 'column'}, optional If 'column', write 1-D NumPy arrays as column vectors. If 'row', write 1D NumPy arrays as row vectors.zbunicode_strings : bool, optional If True, write strings as Unicode, else MATLAB usual encoding.) file_arg append_arg load_args struct_arg matstream_arg long_fieldsdo_compressiononed_asunicode_strings docfillercUR5nUH,n[R"X#5RU5X#'M. U$)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@  MrcjURn[R"SUURU5SS9nU$)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. r F)shaper'bufferorder)itemsizer&ndarrayread) mat_streama_dtype num_bytesarrs r read_dtyper:s8$  I **2"&OOI6 C JrT appendmatcfSSKJn U"XS9n[U5sSSS5 $!,(df  g=f)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 r)_open_file_contextr;N)_mior>_get_matfile_version) file_namer<r>fileobjs rmatfile_versionrCs&J) I ;w#G, < ; ;s " 0r cjURS5 UR[5n[U5[:a [ S5eUR S5[:Xa[ S[S35e[ R"S[ RUSSS9nSU;aURS5 gURS 5 URS5nURS5 [US S :H5n[X45n[US U- 5nXV4nUS ;aU$[SR"U65e)Nrz Mat file appears to be truncatedz&Mat file appears to be corrupt (first z bytes == 0))rEr0r'r1rr|Ir)rrIz%Unknown mat file type, version {}, {}) seekr5 _HDR_N_BYTESlenrcountr&r4uint8int ValueErrorformat)rB 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 JJrcURnUS:Xag[U5S:Xa/USS:XagUS:XaUS-$US:XaSU-$[S US 35eU$) 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 r )rrrrrGcolumn)rrowz 1-D option "z " is strange)r0rMrQ)r9r!r0s rmatdimsr]sn~ IIE { 5zQ 8q=  4<   %< |G9LAB B Lrc*\rSrSrSrSrSrSrSrg) MatVarReaderiNz:Abstract class defining required interface for var readerscg)Nr )self file_readers r__init__MatVarReader.__init__Ps rcg)zReturns header Nr ras r read_headerMatVarReader.read_headerS rcg)zReads array given header Nr )raheaders rarray_from_headerMatVarReader.array_from_headerWrirr N) rrrrrrcrgrlrr rrr_r_NsE   rr_cN\rSrSrSr\S Sj5rSrSrSr Sr g) 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 *Xl0UlU(dUR5nO[R"U5nX lXplU(aUR5 OX@lXPl X0l Xl Xl U (aSUlSUlgg)z Initializer for mat file reader mat_stream : file-like object with file API, open for reading %(load_args)s TFN) r6r+guess_byte_orderboc to_numpy_code byte_orderstruct_as_recordset_matlab_compatible squeeze_mechars_as_strings mat_dtype verify_compressed_data_integritysimplify_cells) rar6rtryrwrxmatlab_compatiblerurzr{s rrcMatFileReader.__init__fs~$% ..0J**:6J$ 0   & & ((O$4 !&N0P-, "DO$)D ! rc.SUlSUlSUlg)z3Sets options to return arrays as MATLAB loads them TFN)ryrwrxrfs rrv#MatFileReader.set_matlab_compatibles %rc"[R$)z8As we do not know what file type we have, assume native )rr native_coderfs rrqMatFileReader.guess_byte_orders rcURRS5nURR5nURRUS- 5 [ U5S:H$)Nrr)r6r5tellrKrM)rabcurposs r end_of_streamMatFileReader.end_of_streamsL OO  #%%' VAX&1v{r) rtrxr+ryr6r{rwrurz)NFFTFTTF) rrrrrr#rcrvrqrrr rrroro\sC  !"&#("&26 %#*#*J& rroct[R"URRSS[U5-5$)z2Return dtype for given number of items per elementNrI)r&r'str)r9nums rarr_dtype_numberrs) 88CIIMM"1%C0 11rc[UR5nU(dS/nUR[URR SS55 [ R"U[US5US9nU[ R"SURS9:H/n[ R"U5(dU$UR5nSU[U5'U$)z#Convert string array to char array rrINrF)r' ) listr0appendrPr'rr&r4rarrayanyr%tuple)r9dimsemptiess r arr_to_charsrs  ?D sKKCIIMM!"%&' **4+C3 !Cbhhr334G 66'?? ((*CCg Jr)r[)rtypingrnumpyr& scipy._librrrrr__all__ Exceptionrr UserWarningrdoc_dictfilldocr#__annotations__r-r:rCget_matfile_versionrLr@r]r_rorrr rrrs $ -9-.I.)[)  < 9   > . #  ? 6 Ea1F h>>(+ 5+*Z.4-1'-T& K8K\   >>B2 r