Overview
The Model Playground is Veydra’s central workspace where you build, modify, and test your system dynamics models. It provides an interactive environment with real-time feedback and powerful visualization tools.Relationship to Models and Activities
The default playground is the base experience for a model when no explicit activity is selected.- Model owns lifecycle metadata (title, description, model status, repository)
- Default Playground Settings define how the base playground opens (default mode, available modes, library/discoverability)
- Activities are explicit experiences attached to a model and can override mode behavior with activity-specific configuration
- Open model without activity: model default playground settings are used.
- Open explicit activity: activity settings apply and can override defaults.
Playground Modes
The Model Playground is organized around a mode-based workflow that guides you through the full modeling lifecycle. Each mode focuses on a specific phase and adapts the UI — showing relevant panels, controls, and AI assistant context. Switch modes using the color-coded buttons in the top navigation bar.Presentation
Interactive guided walkthrough of the model with slides, quizzes, and embedded content
Design
Build and structure your model — edit parameters, code, and stock-flow diagrams
Calibrate
Fine-tune parameters to match real-world data (Pro)
Experiment
Run what-if scenarios and explore different futures
Decide
Compare multiple scenarios side-by-side for decision analysis (Pro)
Presentation Mode
A read-only guided experience for learning about a model. Content is displayed as scrollable slides with a sticky table of contents sidebar. Slides can include rich text, embedded videos, quizzes, and buttons that navigate to other modes.- No editable controls — Model Controls, System Map, and Code Editor are hidden
- AI Assistant adapts with presentation-specific prompts like “Take a Quick Quiz” and “Summarize this model”
- Ideal for onboarding, classroom use, or sharing insights with stakeholders
Design Mode
The primary building mode where all structural changes happen. Parameter changes in Design mode update the baseline configuration that applies across all scenarios. See the dedicated Design Mode page for details.- Model Editor Panel — Full access to all sliders (stocks, flows, parameters, simulation settings)
- Stock-Flow Diagram — Fully expanded with Flow, Causal, Params, and Loops tabs
- Code Editor — Direct Python code editing with Pyodide execution panel
- Charts are hidden so you can focus on model structure
Changes made in Design mode affect the baseline for ALL scenarios. Use Experiment mode for what-if analysis.
Calibrate Mode
Fine-tune your model to match historical or real-world data. See the dedicated Calibration page for details.Experiment Mode
Run what-if scenarios using your calibrated baseline. Slider changes only affect the current scenario’s post-intervention behavior — the baseline stays fixed for comparison.- Model Controls — Shows parameter sliders (not simulation settings) with save/load scenario support
- Compare Mode — Enabled by default, showing baseline vs. scenario on charts
- Scenario Selector — Save, load, rename, and delete named scenarios
- Specialized visualizations — Gantt charts, wait-time scatter plots, spatial visualizations (for applicable models)
Decide Mode (Pro)
Compare multiple saved scenarios side-by-side to make strategic decisions. Automatically selects the baseline plus up to two user scenarios for comparison.- Multi-Scenario Selector — Choose which scenarios to overlay on charts
- Multi-Stock Chart Area — All stocks shown with scenario overlays
- Analysis Card — Aggregated comparison metrics across scenarios
- System Map is fully hidden to maximize chart space
Mode Availability
Not all modes appear for every model. The available modes are determined by the model’s metadata:| Mode | Default | Notes |
|---|---|---|
| Design | Always available | Core building mode |
| Calibrate | Always available | Pro features gated |
| Experiment | Always available | Primary analysis mode |
| Presentation | Opt-in per model | Requires slide content |
| Decide | Opt-in per model | Pro-gated |
AI Assistant Per Mode
The AI Assistant panel automatically adapts to the current mode with a matching color theme, contextual welcome message, and mode-specific action buttons. For example, Design mode offers “Start a guided tutorial” while Decide mode offers “Strategy Comparison” and “Risk Analysis”.Key Components
Model Controls
Parameter adjustment and simulation controls
Stock-Flow Diagram
Visual representation of your model structure
Chart Area
Real-time simulation results and comparisons
Code Editor
Direct Python code editing and customization
Workflow Example
Model Setup
- Load or create a new model
- Review the stock-flow diagram
- Identify key parameters to activate
Parameter Configuration
- Mark important parameters as “Active”
- Set initial values using sliders
- Configure simulation time range
Calibration
- Switch to Calibrate mode
- Adjust parameters so baseline behavior matches expectations
- Changes apply to both baseline and current scenario
Experimentation
- Switch to Experiment mode
- Adjust parameters to explore what-if scenarios
- Compare different scenarios against the calibrated baseline
Next Steps
Calibration
Learn how to calibrate your model with manual, automated, and data-driven methods
Simulation Features
Learn about advanced simulation capabilities
Model Controls Guide
Detailed guide to parameter management
Activities
Transform models into interactive games and assessments

