How ameliacmu/ameliascenes works
AmeliaScenes turns AmeliaSWIM airport trajectory files into scene pickles, optionally scores those scenes with agent- and scene-level metadata, and provides visualization and characterization tools. A separate workflow creates train/validation/test splits using random, daily, or monthly strategies. The graph preserves the documented capabilities and sampled module relationships; some visualization and processing internals were not excerpted, so their links are shown only where the README or SOURCE INDEX supports them.
Main entry points: scene_meta_processor.py Metadata generation · scene_processor.py Scene generation · scene_viz.py Scene visualization router · viz_characterization.py Agent characterization
Components 22
Scene processing
- Processor entry point
amelia_scenes/run_processor.py - Scene generation
amelia_scenes/processing/scene_processor.py - Scene pickles
- Metadata generation
amelia_scenes/processing/scene_meta_processor.py - Scene metadata
- Shared data utilities
amelia_scenes/utils/common.py - Trajectory field masks
amelia_scenes/utils/global_masks.py
Scoring and characterization
- Kinematic scoring
amelia_scenes/scoring/kinematic.py - Interaction scoring
amelia_scenes/scoring/interactive.py - Crowdedness scoring
amelia_scenes/scoring/crowdedness.py - Critical scoring
amelia_scenes/scoring/critical.py - Agent characterization
amelia_scenes/viz_characterization.py
Visualization
- Scene visualization router
amelia_scenes/visualization/scene_viz.py - Plotting primitives
amelia_scenes/visualization/common.py - Benchmark plots
amelia_scenes/visualization/benchmark_viz.py - Marginal prediction plots
amelia_scenes/visualization/marginal_predictions.py - Score plots
amelia_scenes/visualization/scoring_viz.py
Dataset preparation
- Dataset access
amelia_scenes/utils/dataset.py - Split generation
amelia_scenes/run_create_splits.py - Train/val/test lists
Other components
- Dataset user
- Raw trajectories
Connections 36
- Dataset user → Processor entry point: runs processing
README.md - Raw trajectories → Scene generation: supplies trajectories
README.md - Processor entry point → Scene generation: dispatches processing
amelia_scenes/run_processor.py - Scene generation → Scene pickles: writes scenes
README.md - Processor entry point → Metadata generation: dispatches metadata
amelia_scenes/run_processor.py - Metadata generation → Scene pickles: reads scenes
amelia_scenes/processing/scene_meta_processor.py - Metadata generation → Scene metadata: writes scores
amelia_scenes/processing/scene_meta_processor.py - Scene generation → Shared data utilities: uses utilities
amelia_scenes/processing/scene_processor.py - Scene generation → Dataset access: uses dataset helpers
amelia_scenes/processing/scene_processor.py - Scene generation → Trajectory field masks: uses field masks
amelia_scenes/processing/scene_processor.py - Metadata generation → Shared data utilities: uses utilities
amelia_scenes/processing/scene_meta_processor.py - Metadata generation → Kinematic scoring: computes scores
amelia_scenes/processing/scene_meta_processor.py - Metadata generation → Interaction scoring: computes scores
amelia_scenes/processing/scene_meta_processor.py - Metadata generation → Crowdedness scoring: computes scores
amelia_scenes/processing/scene_meta_processor.py - Metadata generation → Critical scoring: aggregates scores
amelia_scenes/processing/scene_meta_processor.py - Kinematic scoring → Shared data utilities: uses constants
amelia_scenes/scoring/kinematic.py - Kinematic scoring → Trajectory field masks: indexes trajectories
amelia_scenes/scoring/kinematic.py - Interaction scoring → Shared data utilities: uses constants
amelia_scenes/scoring/interactive.py - Interaction scoring → Trajectory field masks: indexes trajectories
amelia_scenes/scoring/interactive.py - Crowdedness scoring → Shared data utilities: reads weights
amelia_scenes/scoring/crowdedness.py - Dataset user → Split generation: requests split
README.md - Split generation → Dataset access: uses dataset helpers
amelia_scenes/run_create_splits.py - Split generation → Train/val/test lists: writes split lists
README.md - Dataset user → Agent characterization: runs characterization
amelia_scenes/viz_characterization.py - Agent characterization → Dataset access: loads assets
amelia_scenes/viz_characterization.py - Agent characterization → Kinematic scoring: computes features
amelia_scenes/viz_characterization.py - Agent characterization → Interaction scoring: computes features
amelia_scenes/viz_characterization.py - Agent characterization → Scene visualization router: renders scenes
amelia_scenes/viz_characterization.py - Dataset user → Scene visualization router: requests visualization
README.md - Scene visualization router → Benchmark plots: routes benchmark plots
amelia_scenes/visualization/scene_viz.py - Scene visualization router → Marginal prediction plots: routes prediction plots
amelia_scenes/visualization/scene_viz.py - Scene visualization router → Score plots: routes score plots
amelia_scenes/visualization/scene_viz.py - Scene visualization router → Plotting primitives: uses plotting tools
amelia_scenes/visualization/scene_viz.py - Benchmark plots → Plotting primitives: uses plotting tools
amelia_scenes/visualization/benchmark_viz.py - Marginal prediction plots → Plotting primitives: uses plotting tools
amelia_scenes/visualization/marginal_predictions.py - Score plots → Plotting primitives: uses plotting tools
amelia_scenes/visualization/scoring_viz.py