deep-motion-editing

Files (34)

• SKILL.md
• architecture-overview.md · references/
• repo-provenance.md · references/
• repo-routing-metadata.json · references/
• troubleshooting.md · references/
• check_environment.py · scripts/
• SKILL.md · sub-skills/animation-data/
• api-reference.md · sub-skills/animation-data/references/
• data-formats.md · sub-skills/animation-data/references/
• troubleshooting.md · sub-skills/animation-data/references/
• inspect_bvh.py · sub-skills/animation-data/scripts/
• validate_openpose_json.py · sub-skills/animation-data/scripts/
• SKILL.md · sub-skills/blender-visualization/
• conversion-and-skinning.md · sub-skills/blender-visualization/references/
• loading-and-rendering.md · sub-skills/blender-visualization/references/
• troubleshooting.md · sub-skills/blender-visualization/references/
• build_blender_command.py · sub-skills/blender-visualization/scripts/
• fbx_to_bvh.py · sub-skills/blender-visualization/scripts/
• SKILL.md · sub-skills/motion-retargeting/
• api-reference.md · sub-skills/motion-retargeting/references/
• data-preparation.md · sub-skills/motion-retargeting/references/
• troubleshooting.md · sub-skills/motion-retargeting/references/
• workflows.md · sub-skills/motion-retargeting/references/
• run_retargeting.py · sub-skills/motion-retargeting/scripts/
• run_training.py · sub-skills/motion-retargeting/scripts/
• validate_retargeting_data.py · sub-skills/motion-retargeting/scripts/
• SKILL.md · sub-skills/motion-style-transfer/
• configuration.md · sub-skills/motion-style-transfer/references/
• data-formats.md · sub-skills/motion-style-transfer/references/
• troubleshooting.md · sub-skills/motion-style-transfer/references/
• workflows.md · sub-skills/motion-style-transfer/references/
• prepare_style_dataset.py · sub-skills/motion-style-transfer/scripts/
• run_style_transfer.py · sub-skills/motion-style-transfer/scripts/
• run_training.py · sub-skills/motion-style-transfer/scripts/

SKILL.md (first lines)

# Deep Motion Editing

Use this repo skill when a task names Deep Motion Editing, BVH motion editing,
skeleton-aware retargeting, unpaired motion style transfer, OpenPose motion
style, Mixamo BVHs, or Blender rendering/skinning. It is a script-oriented
research checkout, not a conventional installable Python package. Read
[`references/repo-provenance.md`](references/repo-provenance.md) before
assuming the skill matches a new checkout.

## Start safely

This source snapshot has no `setup.py`, `pyproject.toml`, requirements file, or
console entry point; do not invent `pip install deep-motion-editing`. For the
selected Python workflows, install only the route dependencies in a disposable
environment, for example:

```bash
python -m pip install "numpy<2" scipy pyyaml tqdm torch
# Add these only for training/logging/probe work:
python -m pip install tensorboardX tensorboard matplotlib scikit-learn
```

Use Python 3.7+ as documented by the project. CUDA is recommended for model
inference/training; CPU is useful for format checks but is only a partial
neural substitute. Use Blender 2.80-era or a tested newer Blender for `bpy`
workflows; ordinary Python cannot import `bpy`. Keep datasets, checkpoints,
OpenPose outputs, FBX assets, and generated results outside the skill tree. Do
not download or overwrite them implicitly. Run the read-only environment probe
  [`scripts/check_environment.py`](scripts/check_environment.py) before a new
  task. Read [`references/troubleshooting.md`](references/troubleshooting.md)
  for legacy imports, paths, optional dependencies, and backend failures.

## Route to the focused workflow

| User intent | Read next |
|---|---|
| BVH parsing/writing, topology, JSON validation, kinematics, cleanup | [`sub-skills/animation-data/SKILL.md`](sub-skills/animation-data/SKILL.md) |
| Mixamo/custom data, intra/cross retargeting, evaluation, training | [`sub-skills/motion-retargeting/SKILL.md`](sub-skills/motion-retargeting/SKILL.md) |
| 3D/2D style transfer, normalization, Xia/BFA preparation, training | [`sub-skills/motion-style-transfer/SKILL.md`](sub-skills/motion-style-transfer/SKILL.md) |
| Blender BVH load/render, FBX skinning or conversion | [`sub-skills/blender-visualization/SKILL.md`](sub-skills/blender-visualization/SKILL.md) |

The central cross-workflow contract is: validate BVH hierarchy and frame data
first, preserve source inputs, write new outputs, then validate the result
before neural comparison or rendering. Sibling routes link to each other when
a task crosses that boundary.

## Verification boundary

A parser/help check does not reproduce a paper result. Meaningful neural runs
need the correct pretrained checkpoints, normalization files, dataset layout,
model configuration, and a suitable backend. Blender routes additionally need
a Blender executable and compatible FBX assets. This generated skill was built
from a 2021 source snapshot and intentionally omits large binaries and
external data; those limitations are recorded in the references and external
verification artifacts, not hidden.

From VectorSpaceLab/AREX-Skill, Apache-2.0.

More from VectorSpaceLab/AREX-Skill