pymomentum-cpu 0.1.77.post27__cp313-cp313-macosx_15_0_arm64.whl → 0.1.78.post24__cp313-cp313-macosx_15_0_arm64.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of pymomentum-cpu might be problematic. Click here for more details.

Binary file
lib/libaxel.a CHANGED
Binary file
Binary file
Binary file
Binary file
Binary file
lib/libmomentum_common.a CHANGED
Binary file
lib/libmomentum_diff_ik.a CHANGED
Binary file
lib/libmomentum_io.a CHANGED
Binary file
Binary file
lib/libmomentum_io_fbx.a CHANGED
Binary file
lib/libmomentum_io_gltf.a CHANGED
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file
lib/libmomentum_io_urdf.a CHANGED
Binary file
Binary file
lib/libmomentum_math.a CHANGED
Binary file
Binary file
Binary file
lib/libmomentum_rerun.a CHANGED
Binary file
Binary file
Binary file
Binary file
lib/libmomentum_solver.a CHANGED
Binary file
lib/librerun_sdk.a CHANGED
Binary file
@@ -0,0 +1,121 @@
1
+ Metadata-Version: 2.1
2
+ Name: pymomentum-cpu
3
+ Version: 0.1.78.post24
4
+ Summary: A library providing foundational algorithms for human kinematic motion and numerical optimization solvers to apply human motion in various applications (CPU-only version for Linux, macOS Intel, and macOS ARM)
5
+ Keywords: kinematics,motion,optimization,human-motion,inverse-kinematics,forward-kinematics,body-tracking,motion-capture,character-animation,robotics,cpu
6
+ Author-Email: Meta Reality Labs Research <jeongseok@meta.com>
7
+ License: MIT
8
+ Classifier: Development Status :: 4 - Beta
9
+ Classifier: Intended Audience :: Developers
10
+ Classifier: Intended Audience :: Science/Research
11
+ Classifier: License :: OSI Approved :: MIT License
12
+ Classifier: Operating System :: POSIX :: Linux
13
+ Classifier: Operating System :: MacOS
14
+ Classifier: Programming Language :: C++
15
+ Classifier: Programming Language :: Python :: 3
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Programming Language :: Python :: 3.13
18
+ Classifier: Programming Language :: Python :: Implementation :: CPython
19
+ Classifier: Topic :: Scientific/Engineering
20
+ Classifier: Topic :: Scientific/Engineering :: Mathematics
21
+ Classifier: Topic :: Scientific/Engineering :: Physics
22
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
+ Project-URL: Homepage, https://github.com/facebookresearch/momentum
24
+ Project-URL: Documentation, https://facebookresearch.github.io/momentum/
25
+ Project-URL: Repository, https://github.com/facebookresearch/momentum
26
+ Project-URL: Bug tracker, https://github.com/facebookresearch/momentum/issues
27
+ Project-URL: Changelog, https://github.com/facebookresearch/momentum/releases
28
+ Requires-Python: <3.14,>=3.13
29
+ Requires-Dist: numpy>=1.20.0
30
+ Requires-Dist: scipy>=1.7.0
31
+ Requires-Dist: torch<2.9,>=2.8.0; platform_system == "Linux" and python_version == "3.12"
32
+ Requires-Dist: torch<2.9,>=2.8.0; platform_system == "Linux" and python_version == "3.13"
33
+ Requires-Dist: torch<2.3,>=2.2.0; platform_system == "Darwin" and python_version == "3.12"
34
+ Requires-Dist: torch<2.7,>=2.6.0; platform_system == "Darwin" and python_version == "3.13"
35
+ Description-Content-Type: text/markdown
36
+
37
+ # Momentum
38
+
39
+ [![CI Windows][ci-windows-badge]][ci-windows]
40
+ [![CI macOS][ci-macos-badge]][ci-macos]
41
+ [![CI Ubuntu][ci-ubuntu-badge]][ci-ubuntu]
42
+ [![Publish Website][website-badge]][website]
43
+
44
+ [ci-windows-badge]: https://github.com/facebookresearch/momentum/actions/workflows/ci_windows.yml/badge.svg
45
+ [ci-windows]: https://github.com/facebookresearch/momentum/actions/workflows/ci_windows.yml
46
+ [ci-macos-badge]: https://github.com/facebookresearch/momentum/actions/workflows/ci_macos.yml/badge.svg
47
+ [ci-macos]: https://github.com/facebookresearch/momentum/actions/workflows/ci_macos.yml
48
+ [ci-ubuntu-badge]: https://github.com/facebookresearch/momentum/actions/workflows/ci_ubuntu.yml/badge.svg
49
+ [ci-ubuntu]: https://github.com/facebookresearch/momentum/actions/workflows/ci_ubuntu.yml
50
+ [website-badge]: https://github.com/facebookresearch/momentum/actions/workflows/publish_website.yml/badge.svg
51
+ [website]: https://github.com/facebookresearch/momentum/actions/workflows/publish_website.yml
52
+
53
+ Momentum provides foundational algorithms for human kinematic motion and
54
+ numerical optimization solvers to apply human motion in various applications.
55
+
56
+ <p align="center">
57
+ <img src="momentum/website/static/img/momentum_1.png" width="30%" alt="Forward and Inverse Kinematics with Interpretable Parameterization" />
58
+ <img src="momentum/website/static/img/momentum_3.png" width="30%" alt="RGBD Body Tracking Solver" />
59
+ <img src="momentum/website/static/img/momentum_4.png" width="30%" alt="Monocular RGB Body Tracking Solver" />
60
+ </p>
61
+
62
+ ## Quick Start
63
+
64
+ ### Installation
65
+
66
+ Pre-built binaries are available for Windows, macOS, and Linux:
67
+
68
+ ```bash
69
+ # Python (PyPI)
70
+ pip install pymomentum-cpu # CPU version
71
+ pip install pymomentum-gpu # GPU version with CUDA
72
+
73
+ # Python (Conda/Pixi)
74
+ pixi add pymomentum # Auto-detects GPU/CPU
75
+ conda install -c conda-forge pymomentum
76
+
77
+ # C++ (Conda/Pixi only)
78
+ pixi add momentum-cpp
79
+ conda install -c conda-forge momentum-cpp
80
+ ```
81
+
82
+ **📦 Browse packages:** [PyPI](https://pypi.org/search/?q=pymomentum) • [conda-forge](https://anaconda.org/conda-forge/momentum) • [prefix.dev](https://prefix.dev/channels/conda-forge/packages/momentum)
83
+
84
+ ### Quick Example
85
+
86
+ ```bash
87
+ # Install and run
88
+ pip install pymomentum-cpu
89
+ python -c "import pymomentum as pm; print(pm.__version__)"
90
+ ```
91
+
92
+ ### Building from Source
93
+
94
+ ```bash
95
+ git clone https://github.com/facebookresearch/momentum
96
+ cd momentum
97
+ pixi run build # Builds C++ library and Python bindings
98
+ pixi run test # Runs tests
99
+ pixi run hello_world # Runs example
100
+ ```
101
+
102
+ **For detailed instructions**, see the comprehensive guides on our website:
103
+ - 📘 [**Python Getting Started**](https://facebookresearch.github.io/momentum/pymomentum/user_guide/getting_started) - Installation, building from source, troubleshooting
104
+ - 📗 [**C++ Getting Started**](https://facebookresearch.github.io/momentum/docs/user_guide/getting_started) - Full build instructions, FBX support, examples
105
+
106
+ ## 📖 Documentation
107
+
108
+ Visit our [**documentation website**](https://facebookresearch.github.io/momentum/) for comprehensive guides, examples, and API references:
109
+
110
+ - 🐍 [**Python API Reference**](https://facebookresearch.github.io/momentum/python_api_doc/index.html) - Complete Python API documentation
111
+ - ⚙️ [**C++ API Reference**](https://facebookresearch.github.io/momentum/doxygen/index.html) - Complete C++ API documentation
112
+
113
+ ## Contributing
114
+
115
+ Check our [contributing guide](CONTRIBUTING.md) to learn about how to contribute
116
+ to the project.
117
+
118
+ ## License
119
+
120
+ Momentum is licensed under the MIT License. A copy of the license
121
+ [can be found here.](LICENSE)
@@ -462,35 +462,35 @@ lib/cmake/rerun_sdk/rerun_sdkConfigVersion.cmake,sha256=pkP-Dk2ua51-lUaTXsyrol2-
462
462
  lib/cmake/rerun_sdk/rerun_sdkTargets-release.cmake,sha256=oJmUbA8vo_Af5olAGr7JcaiuRPU4dihtdClmCq11ADY,824
463
463
  lib/cmake/rerun_sdk/rerun_sdkTargets.cmake,sha256=BNlHggsz8G6CC3ypFIFo4xMQVy5c2aSaGJr7nQTmLIM,4255
464
464
  lib/libarrow.a,sha256=X6vJ_gNv2F7lIel-waT1em3FvXRaqQTAWCaYCEUJORU,22109512
465
- lib/libarrow_bundled_dependencies.a,sha256=mKm_ajXGoAl2CTyoqxDkUahs6152fDxElFnE96mZhj0,155360
466
- lib/libaxel.a,sha256=tGRRxgIzh1JKoLH5W_PNKjcmdJLwvxeN5KsoNCwxR_g,674040
467
- lib/libmomentum_app_utils.a,sha256=o-MK5f_wIBHh5lPP9PkwdPK7px6yFT_4_4RPEA8XAxM,453224
468
- lib/libmomentum_character.a,sha256=6F1enLaB5u5BIY3mf8Q_00txMswNGJZb0bXcRUfuuYs,1825392
469
- lib/libmomentum_character_sequence_solver.a,sha256=bxQOanzZLPlleqTYtRBM1z6qv9PuU7ZjzcQIkLbjhTU,2350600
470
- lib/libmomentum_character_solver.a,sha256=ZLo1fhlHj2WA934IRgyfj0_h-RVNByvKRQyb2fVTK8Y,5552824
471
- lib/libmomentum_common.a,sha256=iYlr_lqvgNqLS8iC5kOvqi4hYPgK_587pddWQ9TBwEw,499016
472
- lib/libmomentum_diff_ik.a,sha256=cL-i6jv5ae-FDWdtWSH6Waz-BRCAhgIPVu0_sZxjUds,2842824
473
- lib/libmomentum_io.a,sha256=6lV2gg2Phe6tyImpMs52yO-Un1KQmzKRgJ9AuFu_3Vs,152264
474
- lib/libmomentum_io_common.a,sha256=OKVXuofAzQxdfsf6EFMM3IfglHiNZ_CzuoET55KkB4U,151096
475
- lib/libmomentum_io_fbx.a,sha256=kc5hFgUizikV_O5g2RHCMNGD-3oIX2eHtSJG5k6rRPc,879568
476
- lib/libmomentum_io_gltf.a,sha256=qa3AS4TjJFK0_u_Xp2XlYvd9kVxxAJlfj_ppUOd6GaY,3072616
477
- lib/libmomentum_io_legacy_json.a,sha256=5knbp0A0H8tckVOMR4ipsS4EPkHLmNsgGjmdQa6KjWM,503832
478
- lib/libmomentum_io_marker.a,sha256=Qg5UgH_VdEHnzjyPU5COr6HD7KKgEPYAohzFagj_ot0,1423080
479
- lib/libmomentum_io_motion.a,sha256=QvowATyxt7kgR9f1ZLkKst3ImGP5ZSJZlIRYUVHDLBo,484584
480
- lib/libmomentum_io_shape.a,sha256=C8LRlk357HCzrHf18xjiUhhLtqflEfDsl-S52KG3tFQ,170584
481
- lib/libmomentum_io_skeleton.a,sha256=nc_FGkhJgFI_pIendnppTY9z90hSDGjG7VxeNNGWGYM,1419656
482
- lib/libmomentum_io_urdf.a,sha256=zA5dpo1PSG4fyEc_WueZYvSxCVPMEMqkL3O9nxgOKYI,274680
483
- lib/libmomentum_marker_tracker.a,sha256=km0uxJQMtjXxD2wVa4qf1X-BIJh4mVU5nYgG-5U2iQ8,1224624
484
- lib/libmomentum_math.a,sha256=DHxZU7D2zUk8mwmBzmSqasWFY5X4wTsG1k5gZw51ybQ,1252112
485
- lib/libmomentum_online_qr.a,sha256=pxQKFbinpeMgyU8aZ4cMA6meN2NWqVL2xRez5KOuGyQ,167424
486
- lib/libmomentum_process_markers.a,sha256=rjPkS6sFlYp6ccV23GW8c6a8k76KnmzCVhhrgLSlklk,613624
487
- lib/libmomentum_rerun.a,sha256=5SlRAFumVHn0gMJfcTnsatOO_YG2jBAcTM9nka2AtLc,747960
488
- lib/libmomentum_simd_constraints.a,sha256=lncmv5KTcmy00P_tKePeJ9v7JKAWZy7m-EAp50_3SD4,381080
489
- lib/libmomentum_simd_generalized_loss.a,sha256=iGIpxLxKAekLiqB1WZkJqUv_HVHc82YCGQWzd1gp4aM,459792
490
- lib/libmomentum_skeleton.a,sha256=TNavpsO7oYE5r7GY7evV86ZuU8WjZk4Zibcbt3rgqyQ,553184
491
- lib/libmomentum_solver.a,sha256=jO8k2UBL72rdL1ReHqyjJJF5tHlSlG_JafAMH4fO_oE,1096216
465
+ lib/libarrow_bundled_dependencies.a,sha256=nRgRZ8zJPrwhWgiaNb7SWAspqUlU5yGOsPeMzgEj330,155360
466
+ lib/libaxel.a,sha256=29MSuGryG8iBzwuyP8wfgcz2spo7z10-TNkeLnqTQnc,674040
467
+ lib/libmomentum_app_utils.a,sha256=f5Otru8q5F-3ZR1tEZpwpPwkmkRahSGDsRYFL8kO1k4,453224
468
+ lib/libmomentum_character.a,sha256=sVP9xPFW2h9sRbupkOPoCeY_Zulri2fAw75CyUaAqgg,1825392
469
+ lib/libmomentum_character_sequence_solver.a,sha256=4lyeRBeOxFke_kyiCwm0iWpz8o8pdAZqeUQeivYAZ54,2350600
470
+ lib/libmomentum_character_solver.a,sha256=lnv0ruSum53TmaElrCmQp1F2Mq5b6iBc98q02FmYdc0,5552824
471
+ lib/libmomentum_common.a,sha256=CAOpXu3QRP8v2XW1fkv65zISK7aRWIpCFb-LVVfFrz8,499016
472
+ lib/libmomentum_diff_ik.a,sha256=kOVfov6wqXAy9GxVU-2bsAbc0HuoL2LCjOeoHFk77tM,2842824
473
+ lib/libmomentum_io.a,sha256=-PFw-pb3bH5FgPRAk1fvojOQ_mpJHCoJ7qw5I9o0zRo,152264
474
+ lib/libmomentum_io_common.a,sha256=8VZgbvZOxdlAF-LL_YqPg0DEDJRwalwZT7Ynm8RFca0,151096
475
+ lib/libmomentum_io_fbx.a,sha256=F4P7kDXTSp79yjCEtyHGoPc4rjD8LkvvHE8LW0EtjoE,879568
476
+ lib/libmomentum_io_gltf.a,sha256=X49OLXkTgzIVxIeIj-kfGPLfYPqnvx0mVI4VEWxvIys,3072616
477
+ lib/libmomentum_io_legacy_json.a,sha256=V4PtNy1No50GMakJ3qoMceMj7fpFDGvFRZKg8cL5sdE,503832
478
+ lib/libmomentum_io_marker.a,sha256=AYQ9ay72arxA6lFivG-bLEaxlhyuuK7WebbVRk-5jiE,1423080
479
+ lib/libmomentum_io_motion.a,sha256=fZWwThBmzyHgMIlGwynOCxSTYz0gnz6VITwvoTIx-9U,484584
480
+ lib/libmomentum_io_shape.a,sha256=LpzW3hu0WleMSSb52j_N58yG6IKUbBXJ9tR2OUersmA,170584
481
+ lib/libmomentum_io_skeleton.a,sha256=hs_cHCNjO3BKlT8PV23XK2z0VonUUQjhVGf1jjWJa3E,1419656
482
+ lib/libmomentum_io_urdf.a,sha256=XLPMiPuqQYU_kIRPEbLcykI0GHWeX5YNNkGk0nQUn8k,274680
483
+ lib/libmomentum_marker_tracker.a,sha256=T1xKBkntGrbd6ClzJQ0Ns13aySCZrM_etypRm1getm0,1224624
484
+ lib/libmomentum_math.a,sha256=ylV_JGpwb3pFJn_p-ungp2uWLV6Cc_RxhzVvyahgkF8,1252112
485
+ lib/libmomentum_online_qr.a,sha256=rdb1JO0MtMOFktXCRbl1wu4DPOLX3kMa4c5WO1s_NYo,167424
486
+ lib/libmomentum_process_markers.a,sha256=N8WtmbbVY8tVzjcyEpGyBfp7x8nav2jF-ebdbI_l7AU,613624
487
+ lib/libmomentum_rerun.a,sha256=n6QzRrWyLuqydtBMOZPXrJzyUdHIsEDJELx3yI5fA1M,747960
488
+ lib/libmomentum_simd_constraints.a,sha256=lCY6Mjq5bBEuNv9xHEiuY4BOA64gZBLgfYLBfvqPO7E,381080
489
+ lib/libmomentum_simd_generalized_loss.a,sha256=YWRYLgvdQvqAJiA-bIrsRLcogf3jf5l8w7kO5CD5OBA,459792
490
+ lib/libmomentum_skeleton.a,sha256=sI4ipPokHIVAIRsia6Rt1lPBMnLx37f2TN17bZlMrkA,553184
491
+ lib/libmomentum_solver.a,sha256=HI6idCip3sYZzzHZMJXSJsDTsERVs1mj6iGp7zjPN3A,1096216
492
492
  lib/librerun_c__macos_arm64.a,sha256=a3Gvax7JYoksntKvckNzSDkb4udPz8oFZlxbObAaU-M,82639440
493
- lib/librerun_sdk.a,sha256=BNjPXlgfMpdFSbk3Y9CpCb2Uv92jEQ5N-ADcod8OXyI,3265352
493
+ lib/librerun_sdk.a,sha256=-uNXzGzI5EIcl-JkNqpegux50-1LDyyOJ920zWnY4JI,3265352
494
494
  pymomentum/axel.cpython-313-darwin.so,sha256=v6kPhCAsihOC7GMB5E3u3cqEZHj0i7inu11Zzscfz7Y,668656
495
495
  pymomentum/backend/__init__.py,sha256=6tzrxIJl9w1eM-gqf7YwTZ33WkJ6lnq9h4-TsTuOtuc,476
496
496
  pymomentum/backend/skel_state_backend.py,sha256=tsd2iqtkbyvC7kmvZcApKGu16QbkZuEq2_ysWv6p89Y,25883
@@ -506,7 +506,7 @@ pymomentum/torch/character.py,sha256=y_Ov7tkTobKdmNP1b2oNwFpPuVBUj8sRCJ7G2J5jh-s
506
506
  pymomentum/torch/parameter_limits.py,sha256=Db89tUaJbsOjbOFqhJPFPbMPZDtErAf65ssZvxJ959c,19762
507
507
  pymomentum/torch/utility.py,sha256=_FsIVlhcQusSz_6aVLPKpRRHgSjIwmd0uCWxNVKqRtY,608
508
508
  pymomentum/trs.py,sha256=jwvOR2DDMpAqOE9zFh0TJnigsDpfRi2guUfayQklVqk,17624
509
- pymomentum_cpu-0.1.77.post27.dist-info/METADATA,sha256=SPAq4-tWZv2C8jKocVX9JUqwIkCryQ0Vz_7baZbEOyg,7384
510
- pymomentum_cpu-0.1.77.post27.dist-info/WHEEL,sha256=JSo1iC6TQjCjeMP-LeW5E74uIcwH54R3BMJnd41Jx4o,114
511
- pymomentum_cpu-0.1.77.post27.dist-info/licenses/LICENSE,sha256=2m03A-0Ry-Qr0hLHJZV8mNojy_8ZmMBfpLPZdtGljpM,1088
512
- pymomentum_cpu-0.1.77.post27.dist-info/RECORD,,
509
+ pymomentum_cpu-0.1.78.post24.dist-info/METADATA,sha256=nvZFBuG2yY59M6RZBxtPZt0NTgBmoWQs2IpA65QmHKU,5740
510
+ pymomentum_cpu-0.1.78.post24.dist-info/WHEEL,sha256=4_jX0upxjX0LKUCkmjR4pdtxHJL5S08CQhQ_hmW8O_4,114
511
+ pymomentum_cpu-0.1.78.post24.dist-info/licenses/LICENSE,sha256=2m03A-0Ry-Qr0hLHJZV8mNojy_8ZmMBfpLPZdtGljpM,1088
512
+ pymomentum_cpu-0.1.78.post24.dist-info/RECORD,,
@@ -1,5 +1,5 @@
1
1
  Wheel-Version: 1.0
2
- Generator: scikit-build-core 0.11.6
2
+ Generator: scikit-build-core 0.10.7
3
3
  Root-Is-Purelib: false
4
4
  Tag: cp313-cp313-macosx_15_0_arm64
5
5
 
@@ -1,208 +0,0 @@
1
- Metadata-Version: 2.1
2
- Name: pymomentum-cpu
3
- Version: 0.1.77.post27
4
- Summary: A library providing foundational algorithms for human kinematic motion and numerical optimization solvers to apply human motion in various applications (CPU-only version for Linux, macOS Intel, and macOS ARM)
5
- Keywords: kinematics,motion,optimization,human-motion,inverse-kinematics,forward-kinematics,body-tracking,motion-capture,character-animation,robotics,cpu
6
- Author-Email: Meta Reality Labs Research <jeongseok@meta.com>
7
- License: MIT
8
- Classifier: Development Status :: 4 - Beta
9
- Classifier: Intended Audience :: Developers
10
- Classifier: Intended Audience :: Science/Research
11
- Classifier: License :: OSI Approved :: MIT License
12
- Classifier: Operating System :: POSIX :: Linux
13
- Classifier: Operating System :: MacOS
14
- Classifier: Programming Language :: C++
15
- Classifier: Programming Language :: Python :: 3
16
- Classifier: Programming Language :: Python :: 3.12
17
- Classifier: Programming Language :: Python :: 3.13
18
- Classifier: Programming Language :: Python :: Implementation :: CPython
19
- Classifier: Topic :: Scientific/Engineering
20
- Classifier: Topic :: Scientific/Engineering :: Mathematics
21
- Classifier: Topic :: Scientific/Engineering :: Physics
22
- Classifier: Topic :: Software Development :: Libraries :: Python Modules
23
- Project-URL: Homepage, https://github.com/facebookresearch/momentum
24
- Project-URL: Documentation, https://facebookresearch.github.io/momentum/
25
- Project-URL: Repository, https://github.com/facebookresearch/momentum
26
- Project-URL: Bug Tracker, https://github.com/facebookresearch/momentum/issues
27
- Project-URL: Changelog, https://github.com/facebookresearch/momentum/releases
28
- Requires-Python: >=3.12
29
- Requires-Dist: numpy>=1.20.0
30
- Requires-Dist: scipy>=1.7.0
31
- Requires-Dist: torch<2.9,>=2.8.0
32
- Description-Content-Type: text/markdown
33
-
34
- # Momentum
35
-
36
- [![CI Windows][ci-windows-badge]][ci-windows]
37
- [![CI macOS][ci-macos-badge]][ci-macos]
38
- [![CI Ubuntu][ci-ubuntu-badge]][ci-ubuntu]
39
- [![Publish Website][website-badge]][website]
40
-
41
- [ci-windows-badge]: https://github.com/facebookresearch/momentum/actions/workflows/ci_windows.yml/badge.svg
42
- [ci-windows]: https://github.com/facebookresearch/momentum/actions/workflows/ci_windows.yml
43
- [ci-macos-badge]: https://github.com/facebookresearch/momentum/actions/workflows/ci_macos.yml/badge.svg
44
- [ci-macos]: https://github.com/facebookresearch/momentum/actions/workflows/ci_macos.yml
45
- [ci-ubuntu-badge]: https://github.com/facebookresearch/momentum/actions/workflows/ci_ubuntu.yml/badge.svg
46
- [ci-ubuntu]: https://github.com/facebookresearch/momentum/actions/workflows/ci_ubuntu.yml
47
- [website-badge]: https://github.com/facebookresearch/momentum/actions/workflows/publish_website.yml/badge.svg
48
- [website]: https://github.com/facebookresearch/momentum/actions/workflows/publish_website.yml
49
-
50
- Momentum provides foundational algorithms for human kinematic motion and
51
- numerical optimization solvers to apply human motion in various applications.
52
-
53
- <p align="center">
54
- <img src="momentum/website/static/img/momentum_1.png" width="30%" alt="Forward and Inverse Kinematics with Interpretable Parameterization" />
55
- <img src="momentum/website/static/img/momentum_3.png" width="30%" alt="RGBD Body Tracking Solver" />
56
- <img src="momentum/website/static/img/momentum_4.png" width="30%" alt="Monocular RGB Body Tracking Solver" />
57
- </p>
58
-
59
- ## Getting Started
60
-
61
- This page guides you through the process of building Momentum and running the examples.
62
-
63
- ### Installing Momentum and PyMomentum
64
-
65
- Momentum binary builds are available for Windows, macOS, and Linux via [Pixi](https://prefix.dev/) or the Conda package manager.
66
-
67
- For Windows, please install [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) or greater.
68
-
69
- #### [Pixi](https://prefix.dev/channels/conda-forge/packages/momentum)
70
-
71
- ```
72
- # C++ only
73
- pixi add momentum-cpp
74
-
75
- # Python only (auto-detects GPU/CPU)
76
- pixi add pymomentum
77
-
78
- # Python with specific backend
79
- pixi add pymomentum-gpu # or pymomentum-cpu
80
-
81
- # Both C++ and Python
82
- pixi add momentum
83
- ```
84
-
85
- #### [Conda](https://anaconda.org/conda-forge/momentum)
86
-
87
- ```
88
- # Replace 'pixi add' with 'conda install -c conda-forge'
89
- conda install -c conda-forge momentum-cpp
90
- conda install -c conda-forge pymomentum
91
- conda install -c conda-forge pymomentum-gpu # or pymomentum-cpu
92
- conda install -c conda-forge momentum
93
- ```
94
-
95
- ### Building Momentum from Source
96
-
97
- #### Prerequisite
98
-
99
- Complete the following steps only once:
100
-
101
- 1. Install Pixi by following the instructions on https://prefix.dev/
102
-
103
- 1. Clone the repository and navigate to the root directory:
104
-
105
- ```
106
- git clone https://github.com/facebookresearch/momentum
107
- cd momentum
108
- ```
109
-
110
- Ensure that all subsequent commands are executed in the project's root directory unless specified otherwise.
111
-
112
- #### Build and Test
113
-
114
- - Build the project with the following command (note that the first run may take a few minutes as it installs all dependencies):
115
-
116
- ```
117
- pixi run build
118
- ```
119
-
120
- - Run the tests with:
121
-
122
- ```
123
- pixi run test
124
- ```
125
-
126
- To view all available command lines, run `pixi task list`.
127
-
128
- #### Hello World Example
129
-
130
- To run the `hello_world` example:
131
-
132
- ```
133
- pixi run hello_world
134
- ```
135
-
136
- Alternatively, you can directly run the executable:
137
-
138
- ```
139
- # Linux and macOS
140
- ./build/hello_world
141
-
142
- # Windows
143
- ./build/Release/hello_world.exe
144
- ```
145
-
146
- #### Running Other Examples
147
-
148
- To run other examples:
149
-
150
- ```
151
- pixi run glb_viewer --help
152
- ```
153
-
154
- For more examples, please refer to the [Examples](https://facebookresearch.github.io/momentum/docs/examples/viewers) page.
155
-
156
- #### Clean Up
157
-
158
- If you need to start over for any reason:
159
-
160
- ```
161
- pixi run clean
162
- ```
163
-
164
- Momentum uses the `build/` directory for CMake builds, and `.pixi/` for the Pixi virtual environment. You can clean up everything by either manually removing these directories or by running the command above.
165
-
166
- #### FBX Support
167
-
168
- Momentum uses OpenFBX to load Autodesk's FBX file format, which is enabled by default. To save files in FBX format, you must install the FBX SDK 2020.3.
169
-
170
- ##### Linux
171
-
172
- The FBX SDK will be automatically installed when you run `pixi run config`, so no additional steps are required.
173
-
174
- ##### macOS and Windows
175
-
176
- You can download it from Autodesk's [website](https://aps.autodesk.com/developer/overview/fbx-sdk) or use direct links ([macOS](https://damassets.autodesk.net/content/dam/autodesk/www/files/fbx202037_fbxsdk_clang_mac.pkg.tgz), [Windows](https://damassets.autodesk.net/content/dam/autodesk/www/files/fbx202037_fbxsdk_vs2019_win.exe)). After installing the SDK, build Momentum from source with `MOMENTUM_BUILD_WITH_FBXSDK=ON` option as:
177
-
178
- ```
179
- # macOS
180
- MOMENTUM_BUILD_WITH_FBXSDK=ON pixi run <target>
181
-
182
- # Windows (Powershell)
183
- $env:MOMENTUM_BUILD_WITH_FBXSDK = "ON"; pixi run <target>
184
-
185
- # Windows (cmd)
186
- set MOMENTUM_BUILD_WITH_FBXSDK=ON && pixi run <target>
187
- ```
188
-
189
- For example, file conversion can be run as follows:
190
-
191
- ```
192
- # Windows (Powershell)
193
- $env:MOMENTUM_BUILD_WITH_FBXSDK = "ON"; pixi run convert_model -d <input.glb> -o <out.fbx>
194
- ```
195
-
196
- ## 📖 Documentation
197
-
198
- The full documentation for Momentum can be found on our [website](https://facebookresearch.github.io/momentum/) and the C++ API documentation is available [here](https://facebookresearch.github.io/momentum/doxygen/index.html).
199
-
200
- ## Contributing
201
-
202
- Check our [contributing guide](CONTRIBUTING.md) to learn about how to contribute
203
- to the project.
204
-
205
- ## License
206
-
207
- Momentum is licensed under the MIT License. A copy of the license
208
- [can be found here.](LICENSE)