Skip to content

Free Motion Capture for Everyone πŸ’€βœ¨

TypeScript

Added documentation in header and fixed some minor bugs

Jakob Welnerf87dcba00690
diff --git a/freemocap/fmc_maya_tools.py b/freemocap/fmc_maya_tools.py
index 41417382..b72e9c75 100644
--- a/freemocap/fmc_maya_tools.py
+++ b/freemocap/fmc_maya_tools.py
@@ -1,4 +1,33 @@
+"""
+# Example code for creating a data_handler
+# populating it by importing a npy dataset
+# setting mapping and parents
+# and writing the data to Maya
+import fmc_trackdata_handler as df
+import fmc_maya_tools as mt
+import openpose_data_mappings as data_mapping
+
+### Make empty data structure
+data_handler = df.FmcTracDataHandler()
+
+### Set mapping
+data_handler.set_parent_mapping(data_mapping.parent_mapping)
+data_handler.set_point_name_mapping(data_mapping.point_name_mapping)
+
+### Load openpose npy data into variable
+import numpy as np
+datafile_path = r"G:\Shared drives\000_projects\cl005_northeasternMarkerlessMocap\incoming\datasets\sesh_21-05-31_111833\DataArrays\openPoseSkel_3d.npy"
+data = np.load(datafile_path)
+
+### Import data into data handler as an actor. Handler can contain multiple actors
+# This step can be repeated for multiple datasets, adding each as an individual actor
+actor_name = "tester"
+data_handler.import_actor_raw_data(actor_name, data)
+
+### Write content of data_handler to Maya
+mt.write_to_maya(data_handler, slice=False)
+"""
import maya.cmds as cmds
import math
@@ -6,11 +35,12 @@ import math
def write_to_maya(fmcDataObj, slice=False, sample_by = 5):
"""
- takes an Actor dictionary dataset and and creates animated maya objects accordingly
+ Takes a trackdata handler object and creates animated maya objects accordingly
input:
- actor_dict: actor dictionary extracted from mmcap_datastructure
+ fmcDataObj: object og type FmcTracDataHandler
slice: if not false should be an int tuple of len=2 defining start and end frame to write to Maya
+ sample_by: only write every n'th frame to Maya
"""
for actor_name in fmcDataObj.list_actors():
### Creating point_names
diff --git a/freemocap/fmc_trackdata_handler.py b/freemocap/fmc_trackdata_handler.py
index 16513ccd..35fc88c9 100644
--- a/freemocap/fmc_trackdata_handler.py
+++ b/freemocap/fmc_trackdata_handler.py
@@ -1,5 +1,42 @@
+"""
+### Data Handler class for wrapping and organizing OpenPose data into a more selfcontained and accessible format.
+
+### Example code:
+
+import fmc_trackdata_handler as df
+import openpose_data_mappings as data_mapping
+
+### Make empty data structure
+data_handler = df.FmcTracDataHandler()
+
+### Set mapping
+data_handler.set_parent_mapping(data_mapping.parent_mapping)
+data_handler.set_point_name_mapping(data_mapping.point_name_mapping)
+
+### Load openpose npy data into variable
+import numpy as np
+datafile_path = r"G:\Shared drives\000_projects\cl005_northeasternMarkerlessMocap\incoming\datasets\sesh_21-05-31_111833\DataArrays\openPoseSkel_3d.npy"
+data = np.load(datafile_path)
+
+### Import data into data handler as an actor.
+# This step can be repeated for multiple datasets, adding each as an individual actor
+actor_name = "tester"
+data_handler.import_actor_raw_data(actor_name, data)
+
+### Saving data handler object to file
+file_path = "/absolute/path/to/file/filename" # Suffix is being set to FILE_SUFFIX automatically
+save_obj_to_file(file_path, data_handler, override=False)
+
+### Loading data handler from file
+file_path = "/absolute/path/to/file/filename.fmcData"
+data_h = df.load_obj_from_file(file_path)
+
+"""
+
+
import numpy as np
from pathlib import Path
+import pickle
FILE_SUFFIX = ".fmcData"
@@ -210,7 +247,7 @@ def load_obj_from_file(file_path):
f = Path(file_path)
if f.is_file():
- if f.suffix.lower() == FILE_SUFFIX:
+ if f.suffix.lower() == FILE_SUFFIX.lower():
print(f"Reading file from: {f.absolute()}")
with open(file_path, "rb") as infile:
data = pickle.load(infile)
@@ -226,11 +263,11 @@ def load_obj_from_file(file_path):
-def save_obj_to_file(self, file_path, fmxDataObj, override=False):
+def save_obj_to_file(file_path, fmxDataObj, override=False):
f = Path(file_path)
f= f.with_suffix(FILE_SUFFIX)
if f.exists() and override == False:
- raise NotImplementedError(f"File already exists, Skipping\nFilepath: {f.absolute()}")
+ raise NotImplementedError(f"File already exists and override set to False, Skipping\nFilepath: {f.absolute()}")
with open(f, 'wb') as handle:
pickle.dump(fmxDataObj, handle, protocol=2)
print(f"Saved file to: {f.absolute()}")
diff --git a/freemocap/openpose_data_mappings.py b/freemocap/openpose_data_mappings.py
index 019bd33a..2dc96311 100644
--- a/freemocap/openpose_data_mappings.py
+++ b/freemocap/openpose_data_mappings.py
@@ -1,3 +1,4 @@
+# define point parents by name. Only points listed will have a parent. If a point is not listed, it will be without parents
# child_name : parent_name
parent_mapping = {
'REye': 'Nose',
@@ -70,6 +71,7 @@ parent_mapping = {
# point name corresponding to Open Pose list indices
+# If the imported list is longer than the point_name_mapping, all residual points will be given a generic name
point_name_mapping = [
"Nose", "Neck", "RShoulder", "RElbow", "RWrist", "LShoulder", # limbs
"LElbow", "LWrist", "MidHip", "RHip", "RKnee", "RAnkle", "LHip", "LKnee", # limbs