Metadata-Version: 2.1
Name: mvnx
Version: 0.1.18
Summary: A lightweight commandline parser for the MVNX motion capture file format
Home-page: https://github.com/alexharston/mvnx
Author: Alex Harston
Author-email: alex@harston.io
License: MIT
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
License-File: LICENSE

# mvnx

### A Python parser for the MVNX motion capture file format (.mvnx)

You can install the library using `pip install mvnx`

The simplest way to run the tool is in the following way:

```python
from mvnx.mvnx import MVNX
yourfile = MVNX('path/to/file.mvnx')
```
This creates an MVNX object, the data in which can then be read using standard Python dot notation, like so:

```python
yourfile.orientation 
yourfile.jointAngle
yourfile.angularVelocity
yourfile.segments
yourfile.joints
```
or you can parse individual modalities (all in camelCase) , as below:
```
yourfile = MVNX('path/to/file.mvnx')
yourfile.parse_modality('orientation')
yourfile.parse_modality('angularVelocity')
```

### Alternatively, once installed, you can run the tool from the command line, using `mvnx`.
You can provide `mvnx` a filepath to your .mvnx file and an output path, and it will read the info into a .npy file

Run it using: `mvnx --file path/to/file.mvnx --output /path/to/output.npy`

Note: the parser at present is doing no batch processing or multiprocessing when parsing the file into an object - it will read directly into memory, so be careful when parsing larger files as it can put load on your system.


