Skip to content

feat(gds-viz): dynamical systems visualization (phase portraits, trajectories) #126

@rororowyourboat

Description

@rororowyourboat

Problem

gds-viz renders structural diagrams (Mermaid) for GDS specifications — block diagrams, canonical decomposition, traceability matrices. It does not produce dynamical behavior visualizations.

Proposed Solution

Add visualization types for simulation output:

  • Phase portraits / vector fields
  • Trajectory plots (state vs time, state vs state)
  • Reachable set / isochrone visualization
  • Time-stepping animation (trajectory build-up with slider)
  • Conservation diagnostic plots (invariant drift over time)

Could use matplotlib or plotly as backend, integrated into marimo notebooks.

Motivation

The Homicidal Chauffeur notebook produces 10 distinct visualization types including optimal vector fields, backward trajectory families, physical chase animations, reachable sets with isochrones, and conservation diagnostics. These dynamical visualizations are essential for understanding simulation output.

Scope

Separate from structural Mermaid rendering. Could be a new module in gds-viz or a standalone visualization layer operating on gds-sim Results.

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions