Metadata-Version: 2.1
Name: mat73
Version: 0.45
Summary: Load MATLAB .mat 7.3 into Python native data types
Home-page: https://github.com/skjerns/mat7.3
Author: skjerns
Author-email: nomail@nomail.com
License: MIT
Download-URL: https://github.com/skjerns/mat7.3/archive/v0.45.tar.gz
Description: 
        ![Python package](https://github.com/skjerns/mat7.3/workflows/Python%20package/badge.svg)
        
        # mat 7.3
        Load MATLAB 7.3 .mat files into Python.
        
        Starting with MATLAB 7.3, `.mat` files have been changed to store as custom `hdf5` files.
        This means they cannot be loaded by `scipy.io.loadmat` any longer and raise.
        
        ```Python
        NotImplementedError: Please use HDF reader for matlab v7.3 files
        ```
        
        ## Quickstart
        
        This library loads MATLAB 7.3 HDF5 files into a Python dictionary.
        
        ```Python
        import mat73
        data_dict = mat73.loadmat('data.mat')
        ```
        
        As easy as that!
        
        ## Installation
        
        To install, run:
        ```
        pip install mat73
        ```
        
        Alternatively for most recent version:
        ```
        pip install git+https://github.com/skjerns/mat7.3
        ```
        
        ## Datatypes
        
        The following MATLAB datatypes can be loaded
        
        | MATLAB                   | Python            |
        |--------------------------|-------------------|
        | logical                  | np.bool_          |
        | single                   | np.float32        |
        | double                   | np.float64        |
        | int8/16/32/64            | np.int8/16/32/64  |
        | uint8/16/32/64           | np.uint8/16/32/64 |
        | complex                  | np.complex128     |
        | char                     | str               |
        | struct                   | dict              |
        | cell                     | list              |
        | canonical empty          | []                |
        | Other (ie Datetime, ...) | Not supported     |
        
        ## Short-comings
        
        - This library will __only__ load mat 7.3 files. For older versions use `scipy.io.loadmat`
        - Proprietary MATLAB types (e.g `datetime`, `duriation`, etc) are not supported. If someone tells me how to convert them, I'll implement that
        - For now, you can't save anything back to the .mat. Let me know if you need this functionality, would be quick to implement.
        - See also [hdf5storage](https://github.com/frejanordsiek/hdf5storage), which can indeed be used for saving .mat, but has less features for loading
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
