euler314 commited on
Commit
204fbc1
·
verified ·
1 Parent(s): 4ebcd24

Introduce Trackformer 1.2 with a focused showcase and verified daily metrics

Browse files
Files changed (1) hide show
  1. README.md +12 -4
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
- ![Trackformer 1.1 versus 1.2: pressure intensity, track position and track direction on matched daily forecasts](https://huggingface.co/euler314/typhoon-predict/resolve/e0d6ce5d5de3e9ace333961745facd141341128a/evaluation/released_daily/model_1_2_benchmark.png)
48
 
49
  | Development metric · lower is better | 1.1 | 1.2 · mean of 50 | Shared coverage |
50
  | --- | ---: | ---: | --- |
@@ -64,7 +64,7 @@ The cohort contains 40 recent storms and 230 storms from 1980–1999. It lies ou
64
 
65
  ## How Trackformer 1.2 works
66
 
67
- ![Trackformer 1.2: causal weather history, coupled basin and moving core, pressure-based readout and autoregressive rollout](https://huggingface.co/euler314/typhoon-predict/resolve/e0d6ce5d5de3e9ace333961745facd141341128a/docs/trackformer_1_2_architecture.svg)
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,7 +86,7 @@ The cohort contains 40 recent storms and 230 storms from 1980–1999. It lies ou
86
 
87
  ## Get started
88
 
89
- [Download the release package](https://github.com/yu314-coder/typhoon-predict/releases/download/trackformer-1.2/trackformer_1_2_field_20260929.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 package is a frozen release snapshot; the repository and model card carry the current documentation.
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,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/regional MSLP in physical hPa through +120 h. Use recorded geographic coordinates and coverage when drawing a regional field.
 
 
 
 
 
 
 
 
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
+ ![Trackformer 1.1 versus 1.2: pressure intensity, track position and track direction on matched daily forecasts](https://huggingface.co/euler314/typhoon-predict/resolve/4ebcd24d5fdc2ea9dd696e213ed8652774b78df2/evaluation/released_daily/model_1_2_benchmark.png)
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
+ ![Trackformer 1.2: causal weather history, coupled basin and moving core, pressure-based readout and autoregressive rollout](https://huggingface.co/euler314/typhoon-predict/resolve/4ebcd24d5fdc2ea9dd696e213ed8652774b78df2/docs/trackformer_1_2_architecture.svg)
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