# vye16/shape-of-motion

Repository: https://github.com/vye16/shape-of-motion
Canonical: https://ross.abutalabs.com/products/shape-of-motion
Language: Python
License: MIT
License Family: permissive
Last push: 2025-08-02T02:59:14+00:00

## Health v2 (maintenance only)
Score: 30/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 34, release rhythm 8, longevity 59
- inputs: {"age_days": 838, "days_push": 396, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1302, forks 97 (observed 2026-08-28T04:04:18.036157+00:00)

## What it is
Shape of Motion is a Python research codebase for 4D reconstruction of dynamic scenes from a single monocular video, based on the ICCV 2025 paper of the same name. It fits Gaussian splatting representations (including 2D Gaussian splatting) to video using depth maps, object masks, camera estimates, and 2D tracks.

## Use cases
- reconstruct a 4D dynamic scene from a single video
- train a gaussian splatting model on the iPhone or Nvidia datasets
- fit a dynamic scene model to a custom video with estimated cameras and depths
- evaluate novel view synthesis on monocular video sequences
- use 2D gaussian splatting for better scene geometry

## When to choose
- you need 4D/dynamic scene reconstruction from monocular video
- you want a research baseline for gaussian splatting on dynamic scenes
- you have GPU resources and can run preprocessing pipelines for depth, masks, and tracks

## When to avoid
- you need a production-ready or real-time reconstruction system
- you lack a GPU or cannot run heavy preprocessing dependencies
- you only need static (non-dynamic) scene reconstruction, where simpler splatting tools suffice

## Facets
- artifact type: library
- maturity: active
- function: computer-vision, image-processing, machine-learning, graphics, simulation
- domain: computer-vision, graphics, machine-learning
- platform: python
- tags: 4d-reconstruction, gaussian-splatting, monocular-video, scene-reconstruction, depth-estimation, research-code, research, linux, gpu

## Member repositories
- vye16/shape-of-motion (main) score 30

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:18.036157+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:52:12.034953+00:00, confidence not recorded.
  - readme: https://github.com/vye16/shape-of-motion (fetched 2026-08-28T04:04:18.036157+00:00, sha 476a14ad6eda)
- Data as of 2026-08-30T08:39:29.467469+00:00.