gapfill
GapFill: gap filling functions for motion capture marker data
Science Score: 23.0%
This score indicates how likely this project is to be science-related based on various indicators:
-
○CITATION.cff file
-
○codemeta.json file
-
○.zenodo.json file
-
✓DOI references
Found 7 DOI reference(s) in README -
✓Academic publication links
Links to: zenodo.org -
○Committers with academic emails
-
○Institutional organization owner
-
○JOSS paper metadata
-
○Scientific vocabulary similarity
Low similarity (8.5%) to scientific vocabulary
Keywords
Repository
GapFill: gap filling functions for motion capture marker data
Basic Info
Statistics
- Stars: 9
- Watchers: 2
- Forks: 2
- Open Issues: 0
- Releases: 0
Topics
Metadata Files
README.md
GapFill
GapFill: A Python module of gap filling functions for motion capture marker data
Description
Collection of several functions for gap filling and recovering of motion capture marker data
Installation
GapFill can be installed from PyPI using pip on Python>=3.7.
bash
pip install gapfill
Usage
Rows of ndarray values for marker coordinates should be filled with numpy.nan for occluded (blocked) frames. ```python import gapfill as gf
numpy is required in order to provide necessary markers' coordinate values
import numpy as np
'fillmarkergap_interp()' function will update the given ndarray by filling its gaps using bspline interpolation
'tgtmkrpos0': a 2D (n, 3) ndarray of a target marker position to fill the gaps
'n' is the total number of frames
tgtmkrpos0 = np.array((n, 3), dtype=np.float32)
'ret0': either True or False, True if there is any frame updated, False if there is no frame updated
'updatedfrsmask0': a boolean ndarray to indicate which frames are updated
ret0, updatedfrsmask0 = gf.fillmarkergapinterp(tgtmkr_pos0)
'fillmarkergap_pattern()' function will update the given ndarray by filling its gaps using a donor marker
'tgtmkrpos1': a 2D (n, 3) ndarray of a target marker position to fill the gaps
'n' is the total number of frames
tgtmkrpos1 = np.array((n, 3), dtype=np.float32)
'dnrmkrpos': a 2D (n, 3) ndarray of a donor marker position
'n' is the total number of frames
dnrmkrpos = np.array((n, 3), dtype=np.float32)
'ret1': either True or False, True if there is any frame updated, False if there is no frame updated
'updatedfrsmask1': a boolean ndarray to indicate which frames are updated
ret1, updatedfrsmask1 = gf.fillmarkergappattern(tgtmkrpos1, dnrmkr_pos)
'fillmarkergap_rbt()' function will update the given ndarray by filling its gaps using a cluster of 3 markers
'tgtmkrpos2': a 2D (n, 3) ndarray of a target marker position to fill the gaps
'n' is the total number of frames
tgtmkrpos2 = np.array((n, 3), dtype=np.float32)
'clmkrpos': a 3D (m, n, 3) ndarray of the cluster markers
'm' (at least 3) is the number of markers, and 'n' is the total number of frames
clmkrpos = np.array((m, n, 3), dtype=np.float32)
'ret2': either True or False, True if there is any frame updated, False if there is no frame updated
'updatedfrsmask2': a boolean ndarray to indicate which frames are updated
ret2, updatedfrsmask2 = gf.fillmarkergaprbt(tgtmkrpos2, clmkr_pos) ```
Dependencies
References
- Smolka, J. and Lukasik, E., 2016, July. The rigid body gap filling algorithm. In 2016 9th International Conference on Human System Interactions (HSI) (pp. 337-343). IEEE.
- Arun, K.S., Huang, T.S. and Blostein, S.D., 1987. Least-squares fitting of two 3-D point sets. IEEE Transactions on pattern analysis and machine intelligence, (5), pp.698-700.
- Wikipedia: Kabsch algorithm
- Kwon3D: Computation of the Rotation Matrix
- Vicon: What Gap Filling Algorithms are used Nexus 2?
- Qualisys: Featuring the Trajectory Editor in QTM
How to cite this work
License
Owner
- Name: Moon Ki Jung
- Login: mkjung99
- Kind: user
- Location: Seoul, South Korea
- Company: HMC
- Repositories: 4
- Profile: https://github.com/mkjung99
Senior Research Engineer
GitHub Events
Total
Last Year
Committers
Last synced: 7 months ago
Top Committers
| Name | Commits | |
|---|---|---|
| Moon Ki Jung | m****g@o****m | 14 |
Issues and Pull Requests
Last synced: 7 months ago
All Time
- Total issues: 0
- Total pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Total issue authors: 0
- Total pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Past Year
- Issues: 0
- Pull requests: 0
- Average time to close issues: N/A
- Average time to close pull requests: N/A
- Issue authors: 0
- Pull request authors: 0
- Average comments per issue: 0
- Average comments per pull request: 0
- Merged pull requests: 0
- Bot issues: 0
- Bot pull requests: 0
Top Authors
Issue Authors
Pull Request Authors
Top Labels
Issue Labels
Pull Request Labels
Packages
- Total packages: 1
-
Total downloads:
- pypi 30 last-month
- Total dependent packages: 0
- Total dependent repositories: 1
- Total versions: 5
- Total maintainers: 1
pypi.org: gapfill
GapFill: A Python module of gap filling functions for motion capture marker data
- Homepage: https://github.com/mkjung99/gapfill
- Documentation: https://gapfill.readthedocs.io/
- License: MIT License
-
Latest release: 0.0.7
published over 5 years ago