Introduce Trackformer 1.2 with a focused showcase and verified daily metrics
Browse files
README.md
CHANGED
|
@@ -44,7 +44,7 @@ This selected example illustrates the model, not typical skill. Observations are
|
|
| 44 |
|
| 45 |
Trackformer 1.1 predicts track and scalar intensity/structure outputs. **1.2 adds evolving sea-level-pressure fields and a moving pressure core**, giving the route forecast a spatial weather representation that can be inspected on a map.
|
| 46 |
|
| 47 |
-
, then run with PyTorch and NumPy:
|
| 92 |
|
|
@@ -94,7 +94,15 @@ Prepare a normalized causal issue packet following the [input schema](https://hu
|
|
| 94 |
python models/trackformer_1_2_field/predict.py causal_issue_packet.npz forecast.npz --device mps
|
| 95 |
```
|
| 96 |
|
| 97 |
-
Use `--device cuda` on a compatible NVIDIA setup or `--device cpu` for CPU inference. The packet is user-prepared, not a bundled live downloader. This command produces **one clean forecast**, not the benchmark's 50-member mean. Outputs include track coordinates, central pressure and basin
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 98 |
|
| 99 |
The inference weight SHA-256 is `db49f36e85a3766defc4c172746897a1f783705d1ce8e6f9dfb8e87ae1d902cb`.
|
| 100 |
|
|
|
|
| 44 |
|
| 45 |
Trackformer 1.1 predicts track and scalar intensity/structure outputs. **1.2 adds evolving sea-level-pressure fields and a moving pressure core**, giving the route forecast a spatial weather representation that can be inspected on a map.
|
| 46 |
|
| 47 |
+

|
| 48 |
|
| 49 |
| Development metric · lower is better | 1.1 | 1.2 · mean of 50 | Shared coverage |
|
| 50 |
| --- | ---: | ---: | --- |
|
|
|
|
| 64 |
|
| 65 |
## How Trackformer 1.2 works
|
| 66 |
|
| 67 |
+

|
| 68 |
|
| 69 |
1. **Initialize from the past.** Nine six-hour analyses provide MSLP, 500 hPa height and winds at 850/500/200 hPa, ending at issue time. Static geography, the current observed centre, recent motion, current intensity and validity masks accompany the history. Native regional pressure detail is used when available; missing detail stays flagged. Current observations initialize the core, not future labels.
|
| 70 |
2. **Evolve the environment.** A convolutional recurrent network combines steering-based advection with learned pressure tendencies. Multiscale spatial tokens and attention condition the environmental memory.
|
|
|
|
| 86 |
|
| 87 |
## Get started
|
| 88 |
|
| 89 |
+
[Download weights and the complete pressure-map exporter](https://github.com/yu314-coder/typhoon-predict/releases/download/trackformer-1.2/trackformer_1_2_field_pressure_export_v2.tar.gz), or use this repository with the [Hugging Face weights](https://huggingface.co/euler314/typhoon-predict/resolve/main/models/trackformer_1_2_field/weights.pt). Put `weights.pt` in `models/trackformer_1_2_field/`. The inference weights and learned model equations are unchanged; the package includes the moving-core output and map renderer.
|
| 90 |
|
| 91 |
Prepare a normalized causal issue packet following the [input schema](https://huggingface.co/euler314/typhoon-predict/blob/main/models/trackformer_1_2_field/README.md), then run with PyTorch and NumPy:
|
| 92 |
|
|
|
|
| 94 |
python models/trackformer_1_2_field/predict.py causal_issue_packet.npz forecast.npz --device mps
|
| 95 |
```
|
| 96 |
|
| 97 |
+
Use `--device cuda` on a compatible NVIDIA setup or `--device cpu` for CPU inference. The packet is user-prepared, not a bundled live downloader. This command produces **one clean forecast**, not the benchmark's 50-member mean. Outputs include track coordinates, central pressure and basin, fixed regional and **moving-core MSLP grids in physical hPa through +120 h**, with geographic coordinates, coverage masks and exact valid times. The 20-km core is learned reconstruction, not native high-resolution observations.
|
| 98 |
+
|
| 99 |
+
For an immediate whole-WP and detailed-core PNG, add `--pressure-map pressure_120h.png --map-lead 120` to the command (Matplotlib required). To render another saved lead without rerunning the model:
|
| 100 |
+
|
| 101 |
+
```bash
|
| 102 |
+
python models/trackformer_1_2_field/plot_pressure.py forecast.npz pressure_24h.png --lead 24 --interval 2
|
| 103 |
+
```
|
| 104 |
+
|
| 105 |
+
Blue denotes low pressure and red high pressure. The renderer uses the actual saved moving field, coordinates and masks; it never draws a replacement vortex around a scalar pressure or observed track. See the [pressure-output schema](https://huggingface.co/euler314/typhoon-predict/blob/main/models/trackformer_1_2_field/README.md#render-a-pressure-map-directly).
|
| 106 |
|
| 107 |
The inference weight SHA-256 is `db49f36e85a3766defc4c172746897a1f783705d1ce8e6f9dfb8e87ae1d902cb`.
|
| 108 |
|