<!-- Source: https://docs.biosimulant.com/how-to/web/analyze-results -->

# Analyze Results

Visualize, compare, and export simulation outputs.

**Time estimate**: 15 minutes

## Goal

By the end of this tutorial, you'll be able to:

- Navigate the results viewer
- Compare multiple runs
- Export run outputs

## Accessing Results

### From a Run

After a simulation completes, click **View Results** to open the results viewer.

### From the Dashboard

Navigate to **Runs** to see all your simulations. Click any completed run to view results.

## Results Viewer

The results viewer typically has three main parts:

### Time Series Plot

The main visualization showing variable values over time when a run returns chartable series.

**Interactions**:
- **Hover**: See exact values at any time point
- **Click legend**: Toggle variable visibility
- **Drag**: Zoom into a region
- **Shift+drag**: Pan the view
- **Double-click**: Reset zoom

### Variables Panel

Lists available outputs for the current run. Depending on the model, this may include species, state values, classifier outputs, or other named series.

| Metric | Description |
|--------|-------------|
| **Min** | Minimum value during simulation |
| **Max** | Maximum value during simulation |
| **Final** | Value at end of simulation |
| **Mean** | Average value over time |

Click any variable to highlight it in the plot.

### Run Info Panel

Shows run configuration:
- Lab or model name
- Duration and output points
- Modified parameters
- Start and completion time

## Working with Variables

1. Click series in the legend to hide or show them
2. Use the variable list to focus on the outputs you care about
3. Rerun with fewer tracked outputs if the chart is too noisy

**Tip:**

  Start by isolating one or two outputs. Comparison is much easier when you remove unrelated series first.

## Comparing Runs

### Side-by-Side Comparison

1. From the **Runs** page, select multiple runs (checkbox)
2. Click **Compare**
3. Runs appear in synchronized panels

### Overlay Comparison

1. Open a run's results
2. Click **Add Run**
3. Select another run to overlay
4. Variables from both runs appear on the same plot

**Info:**

  Comparison tools can vary by account or workspace, but the core workflow is the same: start from one run, add another, then inspect the same outputs side by side.

## Exporting Data

### Export Formats

| Format | Best For | Contains |
|--------|----------|----------|
| **CSV** | Spreadsheets, data analysis | Time column + all variables |
| **JSON** | Programmatic access | Full metadata + data |

### Exporting Steps

1. Click **Download** button
2. Select format
3. Choose options, if the UI exposes them
4. Click **Export**

## Analysis Tips

### Finding Steady States

1. Run for long duration
2. Check if final values stabilize
3. Compare min/max to final values

### Identifying Oscillations

1. Look for repeating patterns
2. Use linear scale for amplitude comparison
3. Measure period from peak to peak

### Parameter Sensitivity

1. Run with default parameters
2. Increase/decrease one parameter by 10%
3. Compare: which outputs changed most?

## Best Practices

1. **Document observations**: Note key findings for each run
2. **Save interesting configurations**: Keep the lab and rerun it with explicit parameter changes
3. **Export raw data**: Keep CSV exports for reproducibility
4. **Use meaningful names**: Rename runs with descriptive titles

## Next Steps

- [Compose Models](/how-to/web/compose-models) - Build multi-model simulations
- [Biosimulant Library](/references/library) - Access results with Python
