# Interactive Track Explorer

This page provides an interactive visualization of storm tracks generated by PyStormTracker. It supports filtering by time, intensity, duration, and displacement, and includes both globe and latitude–longitude map projections.

<a href="_static/explorer.html" target="_blank" style="display: block; margin-bottom: 20px; font-weight: bold;">Open in New Tab</a>

<iframe src="_static/explorer.html" width="100%" height="1200px" frameborder="0" style="border: 1px solid #ddd; border-radius: 8px;"></iframe>

## About the Data
The tracks shown above are from the ERA5 Mean Sea Level Pressure (MSL) dataset for the DJF 2025-2026 period, tracked using the Hodges algorithm at 2.5° resolution.

### Filtering Options
*   **Map Projection**: Choose between Globe (3D) or Global (Lat/Lon).
*   **Time Range**: Select a specific time window using the dual-handle slider. Use the **Play** button to animate the cyclone movements over time.
*   **Peak Strength**: Filter tracks by their maximum intensity (Minimum MSL pressure for cyclones or Maximum Vorticity).
*   **Min Duration**: Only show tracks that lasted longer than the specified hours.
*   **Min Displacement**: Only show tracks that traveled further than the specified distance (great-circle distance between start and end points).

## Generating Your Own Explorer

You can generate a standalone HTML explorer for your own tracking results using the `stormtracker convert` command.

### 1. Track your data
Write the tracking results in JSON format:
```bash
stormtracker track -i my_data.nc -v msl -o tracks.json -f json
```

### 2. Convert to HTML
Run the convert command with the `html` output format:
```bash
stormtracker convert -i tracks.json -o explorer.html -f json -F html
```

This produces one `explorer.html` file containing the map code and track data. The file can be opened in a browser or served as a static file.