earth2studio-create-prognostic
Create Earth2Studio prognostic (time-stepping forecast) model wrappers. Do NOT use for diagnostic models, data sources, or installation.
- License 许可
- Apache-2.0
- 最近更新
- 2026-10-08
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- earth2studio-create-prognostic
- license
- Apache-2.0
- version
- 0.16.0
- metadata
- { "tags": [ "earth2studio", "prognostic-model", "python" ], "author": "NVIDIA Earth-2 Team <agent-skills@nvidia.com>" }
- description
- Create Earth2Studio prognostic (time-stepping forecast) model wrappers. Do NOT use for diagnostic models, data sources, or installation.
- argument-hint
- URL or local path to reference inference script (optional)
02 资源文件 10
- 参考文档BENCHMARK.md4.3 KB
- 参考文档metadata.json376 B
- 脚本references/method-templates.py12.6 KB
- 参考文档references/pr-body-template.md2.4 KB
- 参考文档references/pr-comment-template.md2.2 KB
- 脚本references/skeleton-template.py15.2 KB
- 脚本references/testing-guide.py13.7 KB
- 参考文档references/validation-guide.md4.8 KB
- 参考文档skill-card.md2.4 KB
- 参考文档verification.json2.4 KB
03 SKILL.md 正文
Quick Start Checklist
Do these steps IN ORDER. Do not skip any step.
- [ ] Read this SKILL.md completely first
- [ ] Get reference script (Step 0)
- [ ] Create
earth2studio/models/px/<name>.pywith triple inheritance - [ ] Create
test/models/px/test_<name>.pywith mock tests - [ ] Run:
uv run pytest test/models/px/test_<name>.py -v - [ ] Add/update model extra, install docs, API docs, and changelog (Steps 1-2, 9)
- [ ] Run:
make format && make lint
⚠️ CRITICAL: Always use
uv runfor Python commands:
- ✅
uv run pytest .../uv run python ...- ❌
pytest .../python ...(missing dependencies)Stuck or wrong output: Do not keep retrying the same fix. Follow Self-Improvement to patch this skill before continuing.
Purpose
Implement a prognostic model wrapper connecting third-party ML weather models to Earth2Studio. Prognostic models time-integrate forward—given initial state, they predict future states by stepping through time (e.g., 6-hour increments).
Workspace
| Context | Location |
|---|---|
| Harbor eval | Write to /workspace/output/earth2studio/models/px/... |
Harbor + --copy-repo |
Full checkout at /workspace/repo |
| Local clone | Directory with pyproject.toml |
Never read evals/targets/ — grader references only.
Reference Files
Load on demand during the matching step:
| File | Content | Load at |
|---|---|---|
references/skeleton-template.py |
Full model skeleton with FILL comments | Steps 3–6 |
references/method-templates.py |
Canonical method implementations | Steps 4–6 |
references/testing-guide.py |
Test skeleton and mock patterns | Step 7 |
references/validation-guide.md |
Comparison scripts, PR, code review | Steps 10–11 |
Workflow Steps
Step 0 — Get Reference Script
If $ARGUMENTS provided, use it. Otherwise ask:
Please provide a reference inference script URL/path.
Step 1 — Analyze & Propose Dependencies
Analyze: packages, architecture, I/O shapes, time step, resolution, checkpoint.
Propose pyproject.toml group (alphabetical, add to all). Every
prognostic model must have an optional dependency extra, even when no packages
are required:
model-name = ["package1>=version", "package2"]
# or, when no additional packages are required:
model-name = []
[CONFIRM] Present dependencies and ask user to approve.
Step 2 — Add Dependencies
Edit pyproject.toml: add the model extra alphabetically, even if it is
empty, and update the all aggregate.
Step 3 — Create Model File
File: earth2studio/models/px/<lowercase>.py
Required inheritance (all three):
class ModelName(torch.nn.Module, AutoModelMixin, PrognosticMixin):
Required imports:
import numpy as np
import torch
from earth2studio.models.auto import AutoModelMixin, Package
from earth2studio.models.batch import batch_coords, batch_func
from earth2studio.models.px.base import PrognosticMixin
from earth2studio.models.utils import create_coords_from_lat_lon, handshake_dim
from earth2studio.lexicon import E2STUDIO_VOCAB
from earth2studio.utils import check_optional_dependencies
from loguru import logger
SPDX header (required at top of every .py file):
# SPDX-FileCopyrightText: Copyright (c) 2024-2025 NVIDIA CORPORATION & AFFILIATES.
# SPDX-License-Identifier: Apache-2.0
Canonical method order:
__init__2.input_coords3.output_coords(@batch_coords)load_default_package5.load_model6.to(optional)- Private methods 8.
__call__(@batch_func) 9._default_generator create_iterator
Step 4 — Implement Coordinates
input_coords rules:
batch:np.empty(0)time:np.empty(0)(dynamic)lead_time: starts atnp.timedelta64(0, "h")lat: 90 to -90 (north to south); this is the public Earth2Studio convention even if the source model uses the opposite orderlon: 0 to 360- If a checkpoint/model core expects south-to-north latitude, flip tensors internally before/after the core model; do not expose flipped latitude in
input_coordsoroutput_coords - Map variables to
E2STUDIO_VOCAB(282 entries inearth2studio/lexicon/base.py)
output_coords: Use handshake_dim/handshake_coords for input validation, then increment lead_time. Prefer a shared coordinate-check helper and call it from output_coords, __call__, and iterator setup before model execution.
Step 5 — Implement Forward Pass
__call__: @batch_func decorated, shape (batch, time, lead_time, var, lat, lon).
Reshape to model format → call model → reshape back.
create_iterator: MUST yield initial condition first (step 0).
Use front_hook/rear_hook for perturbation injection.
Step 6 — Implement Model Loading
load_default_package: Lock HuggingFace URLs: hf://org/repo@commit
load_model: Use package.resolve(), map_location="cpu", eval() mode,
decorate with @check_optional_dependencies().
Step 7 — Write Tests
File: test/models/px/test_<name>.py
Required tests:
| Function | Purpose |
|---|---|
test_<model>_call |
Single forward pass (parametrize device/time) |
test_<model>_iter |
Iterator produces sequence |
test_<model>_exceptions |
Invalid coords raise errors |
test_<model>_package |
Real weights (@pytest.mark.package) |
Create PhooModelName dummy matching interface for mock tests.
Run tests:
uv run pytest test/models/px/test_<name>.py -m "not package" -v
uv run pytest test/models/px/test_<name>.py::test_<model>_package --package -v
Do not omit the package test. If arbitrary random inputs are not physically valid for the real checkpoint, use a stable model-appropriate synthetic input while still loading real weights and running a forward pass.
Step 8 — Register Model (if requested)
- Add to
earth2studio/models/px/__init__.py(alphabetical) - Verify deps in pyproject.toml
Step 9 — Documentation
- Add to
docs/modules/models_px.rst(alphabetical). This is required for every new prognostic model so the API docs include the generated page. - Add to
docs/userguide/about/install.md(alphabetical tab) for the model extra, even when the extra is empty. Include model-specific notes plus bothpip install earth2studio[model-name]anduv add earth2studio --extra model-nameinstructions. - Update
CHANGELOG.mdunder### Added. This is required for every new prognostic model.
Format and lint:
make format && make lint && make license
Step 10 - Validation (if requested)
Follow references/validation-guide.md. Create uncommitted vanilla, E2S,
comparison, and sanity-check scripts; do not commit generated outputs or images.
Use PR-safe placeholders for plots so the user can upload images manually.
[CONFIRM] User must visually inspect plots before proceeding.
Step 11 - PR (if requested)
Follow references/validation-guide.md and use:
references/pr-body-template.mdreferences/pr-comment-template.md
Before creating the PR, verify pyproject.toml has the model extra, the
all extra includes it, install docs include both pip and uv commands, and
docs/modules/models_px.rst plus CHANGELOG.md are updated.
Do not include machine names, absolute paths, device inventory, or uploaded image links in PR text. Use plot placeholders instead.
Examples
Simple Identity Model
User: Create IdentityModel - returns input unchanged, 6h step, 181x360, vars: t2m, u10m, v10m, msl
Agent: [reads SKILL.md, creates identity.py with triple inheritance,
creates test_identity.py, runs pytest, runs make format && lint]
External Model (Pangu)
User: Add Pangu-Weather wrapper
GitHub: https://github.com/198808xc/Pangu-Weather
Agent: [reads SKILL.md, fetches inference.py, creates pangu.py,
creates test_pangu.py, runs pytest]
Key Patterns
Coordinate Template
@property
def input_coords(self) -> CoordSystem:
return CoordSystem({
"batch": np.empty(0),
"time": np.empty(0),
"lead_time": np.array([np.timedelta64(0, "h")]),
"variable": np.array(["t2m", "u10m", ...]),
# Public Earth2Studio convention is north-to-south latitude.
"lat": np.linspace(90, -90, 181),
"lon": np.linspace(0, 359, 360),
})
@batch_coords()
def output_coords(self, input_coords: CoordSystem) -> CoordSystem:
output = input_coords.copy()
output["lead_time"] = input_coords["lead_time"] + np.timedelta64(6, "h")
return output
Iterator Template
def create_iterator(self, x, coords):
yield x, coords # Initial condition (step 0)
while True:
x, coords = self.front_hook(x, coords)
x, coords = self(x, coords)
x, coords = self.rear_hook(x, coords)
yield x, coords
Troubleshooting
| Error | Solution |
|---|---|
OptionalDependencyFailure |
uv add --optional <group> <pkg> |
| Coordinate handshake fails | Check handshake_dim indices match dim position |
| Iterator wrong shapes | Debug reshape logic with random input |
ModuleNotFoundError: pytest |
Use uv run pytest not pytest |
Reminders
DO:
- Use
uv run pythonfor ALL Python commands - Use
loguru.logger, neverprint() - Inherit
torch.nn.Module + AutoModelMixin + PrognosticMixin - Yield initial condition first in
create_iterator - Use
front_hook()/rear_hook()in_default_generator - Include SPDX header in every .py file
DON'T:
- Create general base classes for reuse
- Commit API keys or comparison scripts
- Read from
evals/targets/
04 同仓库更多 Skills
testing
For testing with Light Protocol programs and clients on localnet, devnet, and mainnet validation.
qedgen
Formally verify programs by writing Lean 4 proofs. Trigger this skill whenever the user wants to formally verify code, generate Lean 4 proofs, prove properties about algorithms or smart contracts, verify invariants, convert program logic into formal specifications, or anything involving Lean 4 and formal verification. Also trigger when the user mentions "qedgen", "lean proof", "formal proof", "verify my code", "prove correctness", "formal verification", or wants mathematical guarantees about their implementation.
solana-dev
Use when user asks to "build a Solana dapp", "write an Anchor program", "create a token", "debug Solana errors", "set up wallet connection", "test my Solana program", "deploy to devnet", or "explain Solana concepts" (rent, accounts, PDAs, CPIs, etc.). Also use for quick on-chain lookups via public RPC + curl — "what's the balance of <wallet>", "look up transaction <sig>", "token balance for <account>", "check this address on mainnet/devnet". End-to-end Solana development playbook covering wallet connection, Anchor/Pinocchio programs, Codama client generation, LiteSVM/Mollusk/Surfpool testing, security checklists, and JSON-RPC curl lookups against public clusters. Integrates with the Solana MCP server for live documentation search. Prefers framework-kit (@solana/client + @solana/react-hooks) for UI, wallet-standard-first connection (incl. ConnectorKit), @solana/kit for client/RPC code, and @solana/web3-compat for legacy boundaries.
solana-common-errors
Diagnose and fix common Solana development errors — GLIBC mismatches, Anchor version conflicts, cargo build-sbf / platform-tools failures, LiteSVM issues, edition2024 crate pins, RPC airdrops, and Anchor 0.29→0.32 migrations. Use when builds fail, Anchor CLI won't install, or CI breaks on Debian/Ubuntu.
skill-creator
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
phantom-wallet-mcp
Execute wallet operations through the Phantom MCP server. Use when the user wants to interact with their Phantom wallet directly — get addresses, transfer SOL or SPL tokens, buy/swap tokens, sign transactions, and sign messages across Solana, Ethereum, Bitcoin, and Sui. Requires the @phantom/mcp-server to be configured as an MCP server.