# Visualization Snapshots

This page showcases examples of Larvaworld visualizations across different modes.

---

## Figure: Visualization Snapshots

![Visualization Examples](../figures_tables_from_paper/figures/fig2a_replay_black.png)

**Figure**: Replay mode with black background showing larva trajectories.

---

![Replay Zoom](../figures_tables_from_paper/figures/fig2b_replay_zoom.png)

**Figure**: Zoomed view of individual larva with midline and contour.

---

![Preference Test](../figures_tables_from_paper/figures/fig2c_sim_preference.png)

**Figure**: Olfactory preference test simulation showing larvae navigating between odor sources.

---

![Game Simulation](../figures_tables_from_paper/figures/fig2d_sim_game.png)

**Figure**: Multi-agent game simulation ("capture the flag").

---

## Visualization Modes

### 1. Real-Time Display

**Purpose**: Interactive exploration

```python
from larvaworld.lib.sim import ExpRun

run = ExpRun(
    experiment="dish",
    N=10,
    duration=0.1,  # minutes (short demo)
    screen_kws={"vis_mode": "video"},
)
run.simulate()
```

**Features**:

- Real-time rendering
- Interactive controls (see {doc}`keyboard_controls`)
- Adjustable drawing options

---

### 2. Video Export

**Purpose**: Create videos for presentations

```python
run = ExpRun(
    experiment="chemotaxis",
    N=20,
    duration=0.1,  # minutes (short demo)
    screen_kws={
        "vis_mode": "video",
        "save_video": True,
        "video_file": "chemotaxis",  # saved as {media_dir}/chemotaxis.mp4
        "fps": 10,
        # "media_dir": ".cache/docs_media",  # optional override (defaults to run.dir)
    },
)
run.simulate()
```

**Supported Formats**: MP4

---

### 3. Image Snapshots

**Purpose**: Save specific frames

```python
run = ExpRun(
    experiment="dish",
    N=5,
    duration=0.1,  # minutes (short demo)
    screen_kws={
        "vis_mode": "image",
        "image_mode": "snapshots",
        "snapshot_interval_in_sec": 60,  # seconds between snapshots
        # "media_dir": ".cache/docs_media",  # optional override (defaults to run.dir)
    },
)
run.simulate()
```

---

## Drawing Options

### Midline

Shows the body midline:

```python
screen_kws = {"draw_midline": True}
```

### Contour

Shows full body outline:

```python
screen_kws = {"draw_contour": True}
```

### Trails

Shows trajectory history:

```python
screen_kws = {"visible_trails": True, "trail_dt": 5.0}  # 5 seconds
```

### Color by Behavior

Colors indicate behavior state:

```python
screen_kws = {"color_behavior": True}
```

- **Green**: Running
- **Red**: Paused
- **Blue**: Turning

---

## Related Documentation

- {doc}`keyboard_controls` - Interactive controls
- {doc}`web_applications` - Web-based dashboards
- {doc}`plotting_api` - Analysis plots