Metadata-Version: 2.1
Name: matgrab
Version: 0.0.6
Summary: search and extract field names or variables from MATLAB .mat files and return a pandas Dataframe
Home-page: https://github.com/Aaronearlerichardson/matgrab
Author: Aaronearlerichardson
Author-email: jakdaxter31@gmail.com
License: UNKNOWN
Project-URL: Bug Tracker, https://github.com/Aaronearlerichardson/matgrab/issues
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# matgrab
Search and extract field names or variables from MATLAB .mat files and return a pandas Dataframe

# installation

## PYPI
```
pip install matgrab
```

# usage

## python
```
import matgrab
df = matgrab.mat2df("PATH","VARS")
```
PATH may be a file path, directory path, or list of either
VARS may be a string or list of strings that correspond to field names of desired matlab variables

if your desired data is nested within another named data structure or array, that structure name must proceed the desired variable separated by a "."
```
EEG.mat
├── dataset_description
└── sub-D0048
    ├── anat
    │   ├── T1w
    │   └── CT
    └── ieeg
        ├── channels
        └── values
```
To retrieve the values from the above mat file, the command would be:
```
matgrab.mat2df("EEG.mat",["sub-D0048.anat.T1w","sub-D0048.anat.CT","sub-D0048.ieeg.channels","sub-D0048.ieeg.values"])
```



