+
LV-jR R t ^ RIt^ RIt^ RIt^ RIHt ^ RIt^ RIt ^RI
H t H t H
t
HtHtHtHt ^RIHtHt ^ RIHt . R'Ot]P0 R 8H t^ t^t^t ^t ^t ^t ]R ]R
] R] R] R] RR. R(ORR/t R ]R]R]R]R
]R]R] R] R] R] R] / t!^ t"^t#^t$^ R^R^R^R ^R /t%]"R ]#R ]$R /t&]PN ! ]PP 4 PR t* ! R! R4 t+ ! R" R 4 t, ! R# R] 4 t-R)R$ lt. ! R% R
4 t/ ! R& R4 t0R# )*z0Classes for read / write of matlab (TM) 4 files
N)mul)
MatFileReader docfillermatdims
read_dtypeconvert_dtypes arr_to_charsarr_dtype_number)squeeze_elementchars_to_strings)reduceMatFile4ReaderMatFile4Writer
VarHeader4
VarReader4
VarWriter4littlef8f4i4i2u2u1headerU1c32c24c16c8S1<>z VAX D-floatz VAX G-floatCraydoublecharsparsec . a ] tR t^Yt o RtRtR tRtV tR# )r Fc B Wn W n W0n W@n WPn R # N)namedtypemclassdims
is_complex)selfr) r* r+ r, r- s &&&&&&f/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/scipy/io/matlab/_mio4.py__init__VarHeader4.__init__^ s
$ )r, r* r- r+ r) N) __name__
__module__ __qualname____firstlineno__
is_logical is_globalr0 __static_attributes____classdictcell__
__classdict__s @r/ r r Y s JI
%
%r2 c \ a ] tR t^kt o RtR tR tR R ltR R ltR t R t
R t R t R
t
V tR # )
r z!Class to read matlab 4 variables c Wn VP V n VP V n VP V n VP V n R # r( ) file_reader
mat_streamdtypeschars_as_strings
squeeze_me)r. r? s &&r/ r0 VarReader4.__init__n s= &%00!(( + < < %00r2 c \ V P V P R, 4 pV P P \ VR, 4 4 P R4 pVR, ^ 8 g VR, R8 d \
R4 h\ VR, R4 w r4VR9 d- \ P ! R\ V, R 2\ ^R
7 \ V^d4 w rTV^ 8w d \
R 4 h\ V^
4 w rdTpVR , VR
, 3pVR, ^8H p V P V, p
\ VV
VVV 4 # )z$Read and return header for variable r namlen mopt z.Mat 4 mopt wrong format, byteswapping problem? z!We do not support byte ordering 'z '; returned data may be corrupt)
stacklevelz,O in MOPT integer should be 0, wrong format?mrowsncolsimagf) )
r r@ rA readintstrip
ValueErrordivmodwarningswarn order_codes UserWarningr ) r. datar) MrestOPTr, r- r* s & r/ read_headerVarReader4.read_headeru s& $//4;;x+@A##CX$78>>wG >>%%c%6C''%'8E"*% %""3''r2 c N V P V4 P \ P 4 pVP 4 P R4 p\ P ! VP \ P ! R4 \ P ! V4 R7 P 4 # )zlatin-1 text matrix (char matrix) reader
Parameters
----------
hdr : ``VarHeader4`` instance
Returns
-------
arr : ndarray
with dtype 'U1', shape given by `hdr` ``dims``
latin-1r rs r* rt ) r astyperv uint8tobytesrz r| r, r* arrayr} )r. rk rm Ss && r/ rg VarReader4.read_char_array sm !!#&--bhh7 KKM +zz "!#!..2df 5r2 c 6 V P V4 pVRR1R3, p\ VR, 4 \ VR , 4 3p\ P ! VR
, RR7 p\ P ! VR , RR7 pV^, pV^, pVP ^, ^8X d! \ P ! VR , RR7 pM-\ P ! VR , RR7 pVR
, Vn \ P P WuV33V4 # )a Read and return sparse matrix type
Parameters
----------
hdr : ``VarHeader4`` instance
Returns
-------
arr : coo_array
with dtype ``float`` and shape read from the sparse array data
Notes
-----
MATLAB 4 real sparse arrays are saved in a N+1 by 3 array format, where
N is the number of non-zero values. Column 1 values [0:N] are the
(1-based) row indices of the each non-zero value, column 2 [0:N] are the
column indices, column 3 [0:N] are the (real) values. The last values
[-1,0:2] of the rows, column indices are shape[0] and shape[1]
respectively of the output matrix. The last value for the values column
is a padding 0. mrows and ncols values from the header give the shape of
the stored matrix, here [N+1, 3]. Complex data are saved as a 4 column
matrix, where the fourth column contains the imaginary component; the
last value is again 0. Complex sparse data do *not* have the header
``imagf`` field set to True; the fact that the data are complex is only
detectable because there are 4 storage columns.
NNNNintcr* floatcomplex)r rO )r rP )r rO )r rP )r )r ) r rR rv ascontiguousarrayrs imagscipyr% coo_array)r. rk r tmpr, IJVs && r/ ri VarReader4.read_sparse_array s 6 !!##a%jCICI/ S 7 S 7 Q Q 99Q<1 $$SXGAXAF||%%qAi66r2 c J VP pV\ 8X d& \ \ \ VP
4 4 pEMV\ 8X d= \ \ \ VP
4 4 pV P ' d VRR pEMeV\ 8X EdL VP pVP
p\ V4 ^8X d V^ , ^8 d V^, ^8 g R# V P P VP V^ , ^,
, ^4 \ P ! RVV P P! VP 4 R7 pV P P VP V^ , ^,
, ^4 \ P ! RVV P P! VP 4 R7 p\ V4 \ V4 3pM\# RV 24 hV P$ ' d$ \ V Uu. uF
q^8w g K VNK up4 pV# u upi )zgRead the shape of the array described by the header.
The file position after this call is unspecified.
Nr rc r )r+ rd tuplemaprR r, rf rB rh r* r{ r@ seekrx rv r| rQ rj rC ) r. rk r+ rs r~ r, rowscolsxs && r/ shape_from_header VarReader4.shape_from_header s \ !#c388,-E
|
##c388,-E$$$ cr
~
%B88DINtAw!|Q1
OO Q! ! < \ SV ` ! V.VO5/ VB RV n R# )zEInitialize matlab 4 file reader
%(matstream_arg)s
%(load_args)s
N)superr0 _matrix_reader)r. r@ argskwargs __class__s &&*,r/ r0 MatFile4Reader.__init__> s$ 5d5f5 "r2 c X V P P ^ 4 \ V P \ P ! R4 4 pV P P ^ 4 V^ 8X d R# V^ 8 g VR8 d \
;' d R;' g R# \
;' d R;' g R# )rO r r rI r! )r@ r r rv r* SYS_LITTLE_ENDIAN)r. rH s & r/ guess_byte_order MatFile4Reader.guess_byte_orderH s Q $//288D>: Q 19 !8td{$,,33 3 ((S//C/r2 c d \ \ V P 4 V n \ V 4 V n R# )zPRun when beginning read of variables
Sets up readers from parameters in `self`
N)r mdtypes_template
byte_orderrA r r )r. s &r/ initialize_read MatFile4Reader.initialize_readT s$
%%5tG ( .r2 c d V P P 4 p\ \ VP \
P ! VP P 4 4 pVP ' d VP \ 8X g
V^, pV P P 4 V, pW3# )a Read and return header, next position
Parameters
----------
None
Returns
-------
header : object
object that can be passed to self.read_var_array, and that
has attributes ``name`` and ``is_global``
next_position : int
position in stream of next variable
)r r` r r r, rv rw r* rx r- r+ rh r@ tell)r. rk remaining_bytes
next_positions & r/ read_var_header MatFile4Reader.read_var_header\ s{ !!--/ chh9K9K0LM >>>#**"> q O ,,. @
!!r2 c 8 V P P W4 # )aD Read array, given `header`
Parameters
----------
header : header object
object with fields defining variable header
process : {True, False}, optional
If True, apply recursive post-processing during loading of array.
Returns
-------
arr : array
array with post-processing applied or not according to
`process`.
)r rn )r. r rl s &&&r/ read_var_array MatFile4Reader.read_var_arrays s ""44VEEr2 c Z \ V\ 4 ' d V.pMVe \ V4 pV P P ^ 4 V P 4 / pV P
4 ' g V P 4 w r4VP f RMVP P R4 pVe$ WQ9 d V P P V4 Kz V P V4 W%& V P P V4 Vf K VP V4 \ V4 ^ 8X g K V# V# )zget variables from stream as dictionary
Parameters
----------
variable_names : None or str or sequence of str, optional
variable name, or sequence of variable names to get from Mat file /
file stream. If None, then get all variables in file.
Nonerq )
isinstancestrlistr@ r r
end_of_streamr r) rz r remover{ )r. variable_namesmdictrk r r) s && r/
get_variables MatFile4Reader.get_variables s nc * * , -N
' !. 1N Q $$&&!%!5!5!7 C XX -6388??83LD )d.H$$]3 --c2EK OO / ) %%d+~&!+ u r2 c V P P ^ 4 V P 4 . pV P 4 ' g V P 4 w r#VP
f RMVP
P
R4 pV P P V4 p\ P VP R4 pVP WEV34 V P P V4 K V# )zlist variables from stream r rq unknown)
r@ r r r r r) rz r r mclass_infogetr+ append)r. varsrk r r) rs infos & r/ list_variables MatFile4Reader.list_variables s Q $$&&!%!5!5!7 C XX -6388??83LD''99#>E ??3::y9D KKd+ , OO / r2 )r rA r r( )r3 r4 r5 r6 r r r0 r r r r r r r9 r:
__classcell__)r r< s @@r/ r
r
< s> !# #
0/".F$ > r2 c p \ W4 p\ V4 ^8 d \ R4 hV P V4 # )a[ Make ``arr`` exactly two dimensional
If `arr` has more than 2 dimensions, raise a ValueError
Parameters
----------
arr : array
oned_as : {'row', 'column'}, optional
Whether to reshape 1-D vectors as row vectors or column vectors.
See documentation for ``matdims`` for more detail
Returns
-------
arr2d : array
2-D version of the array
z=Matlab 4 files cannot save arrays with more than 2 dimensions)r r{ rT reshape)rm oned_asr, s && r/ arr_to_2dr s: " 3 D
4y1} ( ) ) ;;t r2 c Z a ] tR tRt o R tR tR t]]^ 3R lt R t
R t R t R t
R
tV tR # ) r i c J VP V n VP V n R # r( file_streamr )r. file_writers &&r/ r0 VarWriter4.__init__ s &22"** r2 c \ V P P VP R R7 4 R# )rr )ru N)r writer )r. rm s &&r/ write_bytesVarWriter4.write_bytes s! s{{{ 56r2 c < V P P V4 R # r( )r r )r. ss &&r/ write_stringVarWriter4.write_string s q!r2 c \ P ! R \ R, 4 p\ ' * p^ pVR, V^d, , V^
, , V, VR& V^ , VR& V^, VR& WVR& \ V4 ^, VR& V P V4 VR, p V P
V P R 4 4 R
# ) a Write header for given data options
Parameters
----------
name : str
name of variable
shape : sequence
Shape of array as it will be read in matlab
P : int, optional
code for mat4 data type, one of ``miDOUBLE, miSINGLE, miINT32,
miINT16, miUINT16, miUINT8``
T : int, optional
code for mat4 matrix class, one of ``mxFULL_CLASS, mxCHAR_CLASS,
mxSPARSE_CLASS``
imagf : int, optional
flag indicating complex
r rJ rH rL rM rN rF rq Nr )rv emptyr r r{ r r encode)
r. r) rs r^ r_ rN r r[ r] rZ s
&&&&&& r/ write_headerVarWriter4.write_header s $ " .x 89! !
d(c'"b&! v (w (w w t9q=x d{ $++h/0r2 c D \ P P V4 ' d V P W4 R# \ P
! V4 pVP pVP ' g! VP VP R4 4 pVP pV\ P J d \ R4 hV\ P J d \ R4 hV\ P \ P 39 d V P! W4 R# V P# W4 R# )zWrite matrix `arr`, with name `name`
Parameters
----------
arr : array_like
array to write
name : str
name in matlab workspace
N=z!Cannot save object arrays in Mat4z Cannot save void type arrays)r r% issparse write_sparserv asarrayr* isnativer newbyteordertypeobject_rj voidstr_bytes_
write_char
write_numeric)r. rm r) r~ dtts &&& r/ r VarWriter4.write s << % % c ( jjo
YY{{{**R__S 12Cgg "** ?@ @
BGG^ :; ;
RWWbii(
( OOC & 3%r2 c " \ WP 4 pVP P R 8H p \ VP P
R, , pV P VVP V\ VR7 V' d9 V P VP 4 V P VP 4 R# V P V4 R# \ d5 T' d TP R4 pMTP R4 p\ p Li ; i)c:rP NNc128r )r^ r_ rN N)r r r* kind np_to_mtypesr KeyErrorr miDOUBLEr rs rd r realr )r. rm r) rN r^ s &&& r/ r VarWriter4.write_numeric s \\* #% SYY]]2 ./A
$ )) ( % '
SXX & SXX & S ! jj(jj&A s (C D")D
Dc VP P \ P 8X dE VP P \ P ! R 4 P 8w d \ V4 p\
WP 4 pVP pV P VV\ \ R7 VP P R8X dq \ P ! V4 p\ P ! R\! W4 VR7 pVP# 4 P% R4 p\ P ! VRVR7 pV P' V4 R# )r r^ r_ Ur r r Nr )r* r rv r rx r r r rs r miUINT8rf r mathprodr| r itemr r )r. rm r) r, n_charsst_arrsts &&& r/ r VarWriter4.write_char, s 99>>RWW $););rxx~?V?V)V s#C\\*yy
99>>S iioGZZb&6s&D'*,F %%i0B**4tB?C r2 c t VP 4 pVP P R8H p\ P ! VP
^, ^V, 3RR7 pVP VRR1^ 3& VP VRR1^3& VRR1R3;;, ^,
uu& V' d< VP P VRR1^3& VP P VRR1^3& MVP VRR1^3& VP VR& V P VVP \ \ R7 V P V4 R# ) zHSparse matrices are 2-D
See docstring for VarReader4.read_sparse_array
r r r NrO r Nr r )r r )tocoor* r rv zerosnnzrowcolrZ r r rs r r
rh r )r. rm r) ArN ijvs &&& r/ r VarWriter4.write_sparse@ s
IIK #hh 1U7+48UUCRCE
UUCRCE
CRCG CAJCAJCAJggF II
r2 r N)r3 r4 r5 r6 r0 r r r
rd r r r r r r9 r: r; s @r/ r r s< +7" +3l! 1B&:", ( r2 c 8 a ] tR tRt o RtRR ltRR ltRtV tR# )r iY z(Class for writing matlab 4 format files Nc 8 Wn Vf RpW n R V n R # )Nr )r r _matrix_writer)r. r r s &&&r/ r0 MatFile4Writer.__init__[ s & ?G "r2 c \ V 4 V n VP 4 F w r4V P P WC4 K" R# )av Write variables in `mdict` to stream
Parameters
----------
mdict : mapping
mapping with method ``items`` return name, contents pairs
where ``name`` which will appeak in the matlab workspace in
file load, and ``contents`` is something writeable to a
matlab file, such as a NumPy array.
write_header : {None, True, False}
If True, then write the matlab file header before writing the
variables. If None (the default) then write the file header
if we are at position 0 in the stream. By setting False
here, and setting the stream position to the end of the file,
you can append variables to a matlab file
N)r r$ itemsr )r. r r r) vars &&& r/
put_variables MatFile4Writer.put_variablesb s7 ( ) . ID % %c 0 'r2 )r$ r r r( ) r3 r4 r5 r6 r r0 r) r9 r: r; s @r/ r r Y s 3#1 1r2 )r
r r r r r r r r r
miINT16miINT32miSINGLEmiUINT16r rf rd rh r rX ))rH r )rL r )rM r )rN r )rF r )r )1r sysrV r operatorr numpyrv scipy.sparser _miobaser r r r r r r
_mio_utilsr
r functoolsr __all__ byteorderr r
r- r, r+ r. r r r rd rf rh rX r iinfointpmaxry r r r
r r r r r2 r/ r; s
F F F : MMX-
d d T T d T !
$
( 8 8 8((''('' ss}}v (&H
HHRWW ! ! % %$N Nbv] vr 0I I X 1 1r2