| Server IP : 217.160.0.135 / Your IP : 216.73.217.85 Web Server : Apache System : Linux www 6.18.52-i1-ampere #1203 SMP Mon Sep 14 18:29:59 CEST 2026 aarch64 User : sws1074145052 ( 1074145052) PHP Version : 8.3.32 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /lib/python3/dist-packages/scipy/io/matlab/__pycache__/ |
Upload File : |
�
d�cl2 �
�: � d Z ddlZddlZddlZddlmZ ddlmZ g d�Z
G d� de � � Z G d � d
e � � Z
G d � d e� � Zd
ddddddddd� Z ej e� � Z d� Zd� Zdd�d�ZeZd � Zd%d �Z G d � d � � Z G d!� d"� � Zd#� Zd$� Z dS )&zf
Base classes for MATLAB file stream reading.
MATLAB is a registered trademark of the Mathworks inc.
� N)�doccer� )�_byteordercodes)
�
MatFileReader� MatReadError�MatReadWarning� MatVarReader�
MatWriteError�arr_dtype_number� arr_to_chars�convert_dtypes�doc_dict� docfiller�get_matfile_version�matdims�
read_dtypec � � e Zd ZdZdS )r z"Exception indicating a read issue.N��__name__�
__module__� __qualname__�__doc__� � �:/usr/lib/python3/dist-packages/scipy/io/matlab/_miobase.pyr r s � � � � � �,�,�,�,r r c � � e Zd ZdZdS )r
z#Exception indicating a write issue.Nr r r r r
r
s � � � � � �-�-�-�-r r
c � � e Zd ZdZdS )r z Warning class for read issues.Nr r r r r r s � � � � � �(�(�(�(r r zfile_name : str
Name of the mat file (do not need .mat extension if
appendmat==True) Can also pass open file-like object.z�appendmat : bool, optional
True to append the .mat extension to the end of the given
filename, if not already present. Default is True.a� byte_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).ab struct_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.a long_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.z�oned_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_fields�do_compression�oned_as�unicode_stringsc � � | � � � }|D ]2}t j || � � � |� � ||< �3|S )a� Convert 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)``
)�copy�np�dtype� newbyteorder)�dtype_template�
order_code�dtypes�ks r r
r
� sR � �" �
�
�
"�
"�F�
� A� A���H�V�A�Y�'�'�4�4�Z�@�@��q� � � �Mr c �j � |j }t j d|| � |� � d�� � }|S )af
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* �buffer�order)�itemsizer) �ndarray�read)�
mat_stream�a_dtype� num_bytes�arrs r r r � s@ � �$ � �I�
�*�2�"� &�O�O�I� 6� 6� � � � �C� �Jr T�� appendmatc �z � ddl m} || |�� � 5 }t |� � cddd� � S # 1 swxY w Y dS )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 r �matfile_versionrD � s� � �J )�(�(�(�(�(� � �I�� ;� ;� ;� -�w�#�G�,�,�-� -� -� -� -� -� -� -� -� -� -� -���� -� -� -� -� -� -s �0�4�4c �T � | � d� � | � d� � }t |� � dk rt d� � �t j dt j |�� � }d|v r| � d� � dS | � d� � | � d� � }| � d� � t |d d k � � }t || � � }t |d
|z
� � }||f}|d v r|S t d |z � � �)
Nr � z Mat file appears to be empty)rF �r2 r* r3 �r r �| � �I r )r rJ z%Unknown mat file type, version %s, %s) �seekr7 �lenr r) r6 �uint8�int�
ValueError)rC �
mopt_bytes� mopt_ints�tst_str�maj_ind�maj_val�min_val�rets r rA rA � s � � �L�L��O�O�O�� � �a� � �J�
�:���!����9�:�:�:��
��R�X�j�I�I�I�I��I�~�~�� � �Q�����u� �L�L������l�l�1�o�o�G� �L�L��O�O�O��'�!�*��'�(�(�G��'�'�"�#�#�G��'�!�g�+�&�'�'�G� �G�
�C��&����
�
�<�s�B�
C�
C�Cr �columnc � � | j }|dk rdS t |� � dk r6|d dk rdS |dk r|dz S |dk rd|z S t d |z � � �|S )
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
--------
>>> 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 )r r r r rH rX )r �rowz1-D option "%s" is strange)r2 rM rP )r; r% r2 s r r r � s� � �z
�I�E� ��{�{��v�
�5�z�z�Q��� ��8�q�=�=��6�
��
�
��4�<� �
��
�
��%�<� � � 9� &� '� (� (�
(� �Lr c �$ � e Zd ZdZd� Zd� Zd� ZdS )r z; Abstract class defining required interface for var readersc � � d S )Nr )�self� file_readers r �__init__zMatVarReader.__init__M s � � �r c � � dS )z Returns header Nr �r] s r � read_headerzMatVarReader.read_headerP � � � �r c � � dS )z Reads array given header Nr )r] �headers r �array_from_headerz MatVarReader.array_from_headerT rc r N)r r r r r_ rb rf r r r r r K sG � � � � � �E�E�
�
�
�
�
�
�
�
�
�
�
r r c �L � e Zd ZdZe d d�� � Zd� Zd� Zd� ZdS )
r a
Base 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
NFTc
�, � || _ i | _ |s| � � � }nt j |� � }|| _ || _ |r| � � � n|| _ || _ || _
|| _ | | _ | rd| _ d| _ dS dS )z�
Initializer for mat file reader
mat_stream : file-like
object with file API, open for reading
%(load_args)s
TFN)
r8 r. �guess_byte_order�boc�
to_numpy_code�
byte_order�struct_as_record�set_matlab_compatible�
squeeze_me�chars_as_strings� mat_dtype� verify_compressed_data_integrity�simplify_cells)
r] r8 rl rq ro rp �matlab_compatiblerm rr rs s
r r_ zMatFileReader.__init__c s� � �$ %����� �� 7� �.�.�0�0�J�J� �*�:�6�6�J�$��� 0�� � � '� � &� &� (� (� (� (� (�D�O�$4�D� !� &�D�N�0P��-� ,��� � *� "�D�O�$)�D� !� !� !� *� *r c �0 � d| _ d| _ d| _ dS )z4 Sets options to return arrays as MATLAB loads them TFN)rq ro rp ra s r rn z#MatFileReader.set_matlab_compatible� s � � ��� ��� %�� � � r c � � t j S )z9 As we do not know what file type we have, assume native )rj � native_codera s r ri z MatFileReader.guess_byte_order� s
� ��� r c �� � | j � d� � }| j � � � }| j � |dz
� � t |� � dk S )Nr r )r8 r7 �tellrL rM )r] �b�curposs r �
end_of_streamzMatFileReader.end_of_stream� sT � � �O� � �� #� #��� �%�%�'�'�� �� � �V�A�X�&�&�&��1�v�v��{�r )NFFTFTTF) r r r r r r_ rn ri r| r r r r r Y s� � � � � � �� � � � � !�"&�#(�"&�26� %�#*� #*� #*� �Y�#*�J&� &� &� � � �� � � � r r c �n � t j | j j dd� t |� � z � � S )z3 Return dtype for given number of items per elementNrJ )r) r* �str)r; �nums r r r � s* � �
�8�C�I�M�"�1�"�%��C���0� 1� 1�1r c � � t | j � � }|sdg}|� t | j j dd� � � � � t
j |t | d� � | �� � } | t
j d| j �� � k g}t
j
|� � s| S | � � � } d| t |� � < | S )z$ Convert string array to char array r rJ NrG � )r* � )
�listr2 �appendrO r* r~ r) r6 r �array�anyr( �tuple)r; �dims�emptiess r r r � s� � � �� �?�?�D� � ��s���K�K��C�I�M�!�"�"�%�&�&�'�'�'�
�*�4�+�C��3�3� � !� !� !�C� �b�h�r���3�3�3�3�4�G�
�6�'�?�?� ��
�
�(�(�*�*�C� �C��g���� �Jr )rX ) r �operator� functools�numpyr) �
scipy._libr r� r rj �__all__� Exceptionr r
� UserWarningr r �filldocr r
r rD r rA r r r r r r r r �<module>r� s( ��� �
���� � � � � � � � � � � � � � � $� $� $� $� $� $� � � ��-� -� -� -� -�9� -� -� -�.� .� .� .� .�I� .� .� .�)� )� )� )� )�[� )� )� )�
<�
9�
�
>�
.�
#�
?�
6�
E�a1F� 1F� �h
�F�N�8� $� $� �*�Z� � �.� � �4 -1� '-� '-� '-� '-� '-�T &� �D� D� D�2J� J� J� J�Z
�
�
�
�
�
�
�
� >� >� >� >� >� >� >� >�B2� 2� 2�
� � � � r