[SIGGRAPH Asia 2026] UniMate: One Unified Model to Animate Diverse Skeletons
Python
#!/bin/bash
# Stage 4 — process exported NPZ motions into canonicalized training clips.
#
# Usage:
# bash data_process/scripts/run_extract_features.sh truebones
# bash data_process/scripts/run_extract_features.sh objaverse
# bash data_process/scripts/run_extract_features.sh mixamo
# APPLY_CLIP=1 bash data_process/scripts/run_extract_features.sh truebones
# NUM_WORKERS=8 NO_VIS=1 bash data_process/scripts/run_extract_features.sh objaverse
# bash data_process/scripts/run_extract_features.sh general # extra assets, objaverse rules
#
# Env overrides:
# DATA_DIR Stage-1 export directory (default: dataset/export/<dataset>)
# SAVE_DIR Output directory (default: dataset/features/<dataset>)
# APPLY_CLIP If 1/true, crop long motions into overlapping fixed-length
# clips; otherwise (default) keep only the first max_clip_len frames.
# NUM_WORKERS Parallel worker processes over object types (default: 1)
# NO_VIS If 1/true, skip the per-clip MP4 previews
# SAVE_GLB If 1/true, also bake the export's rigs/<asset>.glb into the
# canonical frame: canonical_assets/<dataset>/<object_type>.glb
# beside the features root (dataset/canonical_assets/<dataset>),
# driven by the feature clips with no cond.npy (canonical_assets.py)
# CANONICAL_ASSETS_DIR where SAVE_GLB writes instead (default above; a
# SAVE_DIR outside a features root gives <SAVE_DIR>_canonical_assets)
# Extra arguments are passed through to extract_features.py.
set -euo pipefail
source "$(dirname "${BASH_SOURCE[0]}")/_common.sh"
handle_help "$@"
DATASET=${1:?Usage: run_extract_features.sh <truebones|mixamo|objaverse|general> [extra args...]}
shift
require_dataset "$DATASET"
DATA_DIR=${DATA_DIR:-$(export_dir "$DATASET")}
SAVE_DIR=${SAVE_DIR:-$(features_dir "$DATASET")}
EXTRA_ARGS=()
# Per-dataset joint-count range (skeletons outside it are skipped here, not
# at export — the exports stay complete). Defaults in extract_features.py
# are 8..150; objaverse (and general, built like it) uses a wider range.
case "$DATASET" in
objaverse|general) EXTRA_ARGS+=(--min_joints 4 --max_joints 180) ;;
esac
case "${APPLY_CLIP:-0}" in
1|true|TRUE) EXTRA_ARGS+=(--apply_clip) ;;
esac
case "${NO_VIS:-0}" in
1|true|TRUE) EXTRA_ARGS+=(--no-vis) ;;
esac
case "${SAVE_GLB:-0}" in
1|true|TRUE) EXTRA_ARGS+=(--save_glb) ;;
esac
[[ -n "${CANONICAL_ASSETS_DIR:-}" ]] && EXTRA_ARGS+=(--canonical_assets_dir="$CANONICAL_ASSETS_DIR")
[[ "${NUM_WORKERS:-1}" -gt 1 ]] && EXTRA_ARGS+=(--num_workers="$NUM_WORKERS")
python -m data_process.feature_extraction.extract_features \
--dataset_type="$DATASET" \
--data_dir="$DATA_DIR" \
--save_dir="$SAVE_DIR" \
"${EXTRA_ARGS[@]}" "$@"