https://github.com/davidpagnon/maya-mocap
A set of tools for mocap in Maya
https://github.com/davidpagnon/maya-mocap
camera imports maya mocap trc
Last synced: 11 months ago
JSON representation
A set of tools for mocap in Maya
- Host: GitHub
- URL: https://github.com/davidpagnon/maya-mocap
- Owner: davidpagnon
- License: bsd-3-clause
- Created: 2021-03-19T11:35:28.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2024-06-28T07:04:25.000Z (about 2 years ago)
- Last Synced: 2024-06-28T08:28:02.016Z (about 2 years ago)
- Topics: camera, imports, maya, mocap, trc
- Language: Python
- Homepage:
- Size: 110 KB
- Stars: 8
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Maya Mocap
> **N.B.: This toolbox is not maintained anymore. You can switch to [Pose2Sim_Blender](https://github.com/davidpagnon/Pose2Sim_Blender) to get access to similar tools (and more).**
**[Maya Mocap](https://github.com/davidpagnon/Maya-Mocap)** is a collection of open-source tools for Motion Capture in Maya.
Tested on Maya 2018 (python 2) and on Maya 2022 (python 3). Not tested on Linux nor MacOS yet.
## Contents
1. [How to](#how-to)
2. [Camera toolbox](#camera-toolbox)
3. [Imports](#imports)
1. [OBJ sequence import](#obj-sequence-import)
2. [Opensim import](#opensim-import)
3. [TRC import](#trc-import)
4. [C3D import](#c3d-import)
5. [BVH import](#bvh-import)
6. [FBX import](#fbx-import)
4. [Others](#others)
1. [C3D to TRC](#c3d-to-trc)
5. [To-do list](#to-do-list)
6. [Send Us Feedback!](#send-us-feedback)
9. [Contributers](#contributers)
10. [Citation](#citation)
11. [License](#license)
## How to
1. First you need to install python packages in Maya.
Open a command prompt (Windows -> cmd).\
Type the following (replace `` with your version):
```
"C:\Program Files\Autodesk\Maya\bin\mayapy" -m pip install opencv-python pandas c3d numpy anytree toml
```
  If it does not work, check [there](http://mgland.com/qa/en/?qa=1748/how-to-use-pip-with-maya).
2. Clone the repository or just download the python pieces of code you need.
3. Open file at `\maya\\maya.env`. Create it if it does't exist.\
Type the following (replace what's in capital letters):
```
MAYA_SHELF_PATH = \shelves
PYTHONPATH = \scripts
MAYA_PLUG_IN_PATH = \plug-ins
```
You may also need to add this PYTHONPATH to your environment variables.\
`Windows -> Environment Variables -> New -> Name: PYTHONPATH, Value: \scripts`
That's it! After opening Maya, you should get a new shelf with new tools ready to be used.\
## Camera toolbox
`maya_camToolbox.py` is a toolbox for various operations on cameras in Maya.\
Lets you:
* set cameras in scene from chosen specs.
* or set cameras from calibration file (.toml).
* save a calibration file from cameras in scene.
* film image sequences from the cameras in scene.
* display image sequences in scene.
* reproject selected objects on image camera planes.
* display 3D path of selected objects (due to a bug in Maya 2018, works only for "all frames" in this version).
## Imports
### OBJ sequence import
`maya_objs.py` lets you:
* Displays a sequence of OBJ files in an "objStreamNode" (uses plug-in `objStreamNode`).
* These OBJ don't need to be coherent in time (e.g. vertex number, etc).
* Assign textures to the meshes.
### Opensim import
...Coming soon...\
`maya_osim.py` lets you:
* Import an .osim model.
* Animate it with .mot inverse kinematics.
### TRC import
`maya_trc.py` lets you:
* Import trc files.
* Choose if you only want to display the markers, or also to construct the skeleton.
* In case you want the skeleton (and it's not Openpose body_25b), please refer to the section SKELETON DEFINITION.
### C3D import
`maya_c3d.py` lets you:
* First convert c3d to trc files using `c3d2trc.py`.
* Then import resulting trc files.
* Choose if you only want to display the markers, or also to construct the skeleton.
* In case you want the skeleton (and it's not Openpose body_25b), please refer to SKELETON DEFINITION in trc import.
* :warning: Beware that it only allows you to retrieve 3D points, you won't get analog data with this code.
### BVH import
Jeroen Hoolmans wrote an awesome free [BVH (BioVision Hierarchy) importer](https://github.com/jhoolmans/mayaImporterBVH).\
It is slightly adapted here to be made compatibly with python 3 (Maya 2022 and above).
### FBX import
Instructions for importing FBX files can be found [at this address](https://www.instructables.com/How-To-Use-Mocap-Files-In-Maya-BVH-or-FBX/).
## Others
### C3D to TRC
`c3d2trc.py` lets you:
* Convert c3d binary files to trc format.
* Usage: Open a command line in your cloned repository. \
Type `python c3d2trc -i '`
or `python c3d2trc.py -i -o `.
* :warning: Beware that it only allows you to retrieve 3D points, you won't get analog data with this code.**
## To-do list
This repository is meant to get more tools in the future. Please feel free to add your suggestions and/or code!
Among others, I'd like to add:
- An Xsens importer.
- An Opensim importer (.osim model, and .mot inverse kinematics).
## Send Us Feedback!
This library is open source for research purposes, and I want to improve it! So let me know (create a new GitHub issue or pull request, email us, etc.) if you:
1. Find/fix any bug or know how to improve anything.
2. Want to add/show some cool functionality/demo/project regarding motion capture in Maya. We would love to integrate your project to this repository!
## Contributers
David Pagnon (maintainer), contact@david-pagnon.com\
Lionel Reveret, lionel.reveret@inria.fr
## Citation
If you find our work useful in your research, please cite it.
## License
The code found on this repository is free to use, edit, and redistribute under the BSD-3 licensing terms.