> For the complete documentation index, see [llms.txt](https://miulien.gitbook.io/bot/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://miulien.gitbook.io/bot/en/other/typhoon.md).

# Typhoon Tracking (typhoon)

Run **`/typhoon`** or **`m!typhoon`** to explore current tropical cyclones and historical typhoon records.

### 🌀 Real-time cyclone tracking

Miulien integrates cyclone data from four meteorological agencies:

| Agency                                          | Maximum sustained wind                 | Wind radii                                                  |
| ----------------------------------------------- | -------------------------------------- | ----------------------------------------------------------- |
| **JMA** (Japan Meteorological Agency)           | **10-minute average**, primarily in kt | Strong wind (15 m/s) and storm-force wind (25 m/s) areas    |
| **CWA** (Taiwan Central Weather Administration) | **10-minute average**, m/s             | Force 7 and Force 10 wind radii, average and four quadrants |
| **CMA** (China Meteorological Administration)   | **2-minute average**, m/s              | 30, 50, 64 kt radii and quadrants                           |
| **JTWC** (Joint Typhoon Warning Center)         | **1-minute average**, kt               | 34, 50, 64 kt radii and quadrants, in nautical miles (nmi)  |

Use dropdowns to change the agency or cyclone. Agencies may analyze the same system differently or cover different ocean basins.

| Data field             | Description                                                                                        |
| ---------------------- | -------------------------------------------------------------------------------------------------- |
| Analysis time          | Time of the observation/analysis, in Taiwan time                                                   |
| Center position        | Latitude and longitude                                                                             |
| Central pressure       | hPa                                                                                                |
| Maximum sustained wind | Wind speed and its averaging period                                                                |
| Movement direction     | Compass heading; JTWC also retains the source angle                                                |
| Movement speed         | JMA/CWA/CMA in km/h; JTWC in kt                                                                    |
| Wind radii             | Reported threshold radii; when available, northeast, southeast, southwest, and northwest quadrants |

Press **🔄 Refresh** to request updated data. If no active storms exist or an agency has no usable data, the panel shows the corresponding state.

> Wind averaging times, radii thresholds, and measurement units **differ between agencies**. Their values are not directly interchangeable. Their latest reports may also arrive at different times.

For JMA wind radii, **All directions** means the radius applies in every direction. Direction labels inside the radii fields follow the selected interface language.

### 📚 Historical typhoon search

Select **📚 Historical Search** from the live panel to browse **JMA Best Track** records dating back to **1951**.

Choose a year and storm through dropdowns, or use **Name / Number Search** with an English name or international storm number. Pagination is available for long lists. **Back to Current Typhoons** returns to the real-time panel.

Historical records show the name, number, first/last record times, minimum central pressure, maximum sustained wind, and the time/location of minimum pressure.

> Historical searches currently use **JMA only**; the four-agency integration applies to real-time tracking. Best Track records may be revised after the event.

### 💡 Notes

Panels use buttons and dropdowns. If a panel expires, rerun the command. Analyses can change; refer to the individual agencies' official bulletins for authoritative weather information.
