Consolidate evaluation projectors into two dataset bundles

evaluation/body_pose_v1/README.md

@@ -1,20 +0,0 @@
-# Body Pose evaluation projectors
-
-Use these projectors with GEM-X's Body Pose evaluation on 3DPW test and EMDB-1.
-They expect SOMA 0.3.3 MID meshes with 18,056 vertices in metres, in the vertex
-order returned by the released Body Pose predictor. Load the files with
-`gem.pose.evaluation.body.BodyJointProjector.from_asset`.
-
-| File | Output joint order | Evaluated subset and pelvis |
-| --- | --- | --- |
-| `3dpw_projector.pt` | Complete 44-joint benchmark layout | Score 25–37 and 43; center on 39 |
-| `emdb_projector.pt` | SMPL24 | Score all 24; center on the mean of 1 and 2 |
-
-Indices start at zero. These are joint evaluation assets: they do not provide
-PVE or a temporal Motion evaluation protocol. Datasets, ground-truth labels and
-SMPL model files are obtained separately by each user.
-
-See the [Body Pose benchmark guide](https://github.com/NVlabs/GEM-X/blob/main/docs/BODY_BENCHMARKS.md)
-for data preparation and fixed evaluation configurations.
-
-Evaluation code is available in [GEM-X PR #34](https://github.com/NVlabs/GEM-X/pull/34) while its merge is pending.

evaluation/motion_v1/3dpw_j14.pt

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:cb55ad8a086d0c3452633515aefad343856d679d8a85b0ce94ebb647a3761bc7
-size 3901534

evaluation/motion_v1/README.md

@@ -1,25 +0,0 @@
-# Body Motion evaluation projectors
-
-These assets support GEM-X's complete-sequence Motion evaluation. Inputs are
-SOMA 0.3.3 MID meshes with 18,056 vertices in metres, using the Motion evaluation
-geometry profile without pose correctives. They are separate from the Body Pose
-evaluation bundle.
-
-| Asset | Usage |
-| --- | --- |
-| `smpl24.pt` | SMPL24 joint order for EMDB-1 and EMDB-2; pelvis is the midpoint of joints 1 and 2 |
-| `3dpw_j14.pt` | Motion's 14-joint 3DPW order; pelvis is the midpoint of joints 2 and 3 |
-| `mesh_projector/` | Corresponding 6,890-vertex output for EMDB-1 PVE and EMDB-2 foot sliding |
-
-Joint indices start at zero. Load the joint files with
-`gem.motion.evaluation.geometry.SomaJointRegressor`; load the directory with
-`SomaMeshProjector`. The mesh directory requires all four files together:
-`face_vertex_indices.pt`, `tet_vertex_indices.pt`, `smpl_vertex_face_ids.pt`, and
-`smpl_vertex_barycentric.pt`.
-
-Users obtain benchmark data and SMPL models separately and prepare their own
-ground truth locally. See the [Motion benchmark guide](https://github.com/NVlabs/GEM-X/blob/main/docs/MOTION_BENCHMARKS.md)
-for matching models, preparation, frame masks, camera inputs and raw/Contact-IK
-evaluation commands.
-
-Evaluation code is available in [GEM-X PR #34](https://github.com/NVlabs/GEM-X/pull/34) while its merge is pending.

evaluation/motion_v1/mesh_projector/face_vertex_indices.pt

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:547b1eb1bf14ab7c58f7698b5516682346fdc10d395a183a3c553cda6b3da30c
-size 868221

evaluation/motion_v1/mesh_projector/smpl_vertex_barycentric.pt

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:2cdf0283168ebfcc47e4bc6d3fd2b48e82ce27c4a047fcfbafd617e3e463d95d
-size 111961

evaluation/motion_v1/mesh_projector/smpl_vertex_face_ids.pt

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:8900ad9f5d004a7ebc044f65ac51c6947728cec96674a58d9f59a5dc1f9cac7b
-size 56772

evaluation/motion_v1/mesh_projector/tet_vertex_indices.pt

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:b3ff920312b88ffb00071b3b2fe2c63f19ba736c3ad2a0326c3c78737279e18f
-size 1157110

evaluation/motion_v1/smpl24.pt

@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:d3a297f63cc4b2b1471c8c52c62240f58245a9b26002672678c3b35adeb98a64
-size 6067986

evaluation/{body_pose_v1 → projectors_v1}/3dpw_projector.pt

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e71c6f8026448a4f6fc8ce1ba1da6776a2af0b84c84a554922236083012dc04d
-size 10401437
+oid sha256:0ad7e1f1d7327fd38c9a2fe8db03cb1328e7ad35fe1bfeada09977facf73e416
+size 13434629

evaluation/projectors_v1/README.md

@@ -0,0 +1,26 @@
+# GEM-X evaluation projectors
+
+Download the two files for Body Pose and Body Motion evaluation:
+
+```bash
+hf download nvidia/GEM-X --include 'evaluation/projectors_v1/*' --local-dir weights
+```
+
+| File | Use |
+| --- | --- |
+| `emdb_projector.pt` | Shared EMDB SMPL24 joints; also includes the mesh mapping for Motion PVE and foot sliding |
+| `3dpw_projector.pt` | Body Pose and Motion 3DPW joint protocols; the evaluator selects the appropriate layout |
+
+Both files accept SOMA MID meshes with 18,056 vertices in metres. Body Pose
+uses its matching geometry profile; Motion evaluates MID geometry without pose
+correctives. The 3DPW protocols have different joint and pelvis definitions;
+sharing the file does not interchange those definitions.
+
+Use `BodyJointProjector.from_asset` for Pose and `SomaJointRegressor` for Motion.
+For Motion mesh metrics, pass `emdb_projector.pt` to `SomaMeshProjector` as well;
+there is no separate mesh directory to download.
+
+Datasets, SMPL models and prepared ground truth are obtained separately by each
+user. Setup and evaluation instructions are in [GEM-X PR #34](https://github.com/NVlabs/GEM-X/pull/34)
+and the repository's [Body Pose](https://github.com/NVlabs/GEM-X/blob/main/docs/BODY_BENCHMARKS.md)
+and [Motion](https://github.com/NVlabs/GEM-X/blob/main/docs/MOTION_BENCHMARKS.md) guides.

evaluation/{body_pose_v1 → projectors_v1}/emdb_projector.pt

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:e1d2e1bc34116462baae51d743b2b1ea905ee62069e98f25fcf36d9ecba2c940
-size 6068317
+oid sha256:45dba2e5f80afd994ecc3924cea51b2f0e02910e8f8a3420c4fc4d2792f7ee1d
+size 7389707