Design ideas and proposals for icon4py. Drop an idea, cross-check it against what already exists, and surface conflicts early.
This index is the map of everything here. Each entry lists keywords for the
topics a document discusses — scan them to find overlapping or conflicting ideas.
See AGENTS.md in the repository root for how to add a proposal and keep this
index current. (Keep entries and their keywords in sync with each document’s tags.)
Shared
Proposals the group broadly agrees are implementation-ready.
None yet.
Personal
Work-in-progress proposals, organized by contributor.
egparedes
- Layered architecture: analysis and refactoring proposal — keywords: architecture, layers, tach, packaging, refactoring, components, protocol, model-state, tendencies, field-factory, registry, grid, domain, decomposition, testing, validation, serialbox, py2fgen, bindings, config, precision, io
havogt
- Declarative testing harness — keywords: testing, verification, serialbox, stencil-tests, datatests, pytest, tolerances, benchmarking
iomaganaris
- Optimize the startup of the standalone-driver — keywords: standalone-driver, driver, GPU, optimization
- Verify that the domains of all the GT4Py programs are as minimal as possible using an LLM - keywords: dycore, diffusion, tracer_advection, autoresearch
- Specialize GT4Py programs with runtime-varying domain bounds via the variants parameter - keywords: dycore, diffusion, tracer_advection, setup_program, gt4py, performance, specialization
- Use smoother random data in the StencilTests to lower the relative tolerance — keywords: testing, stencil-tests, random-data, numerical-precision, tolerances
jcanton
- Systematic stencil-domain over-computation audit — keywords: dycore, diffusion, tracer_advection, domains, halo-exchange, skip-values, overcomputation
- GT4Py — plan & scope — keywords: jsbach, icon-land, land-surface, gt4py, port, tmx, aes, validation, oracle, sse
- Model state — keywords: state, model-state, components, fields, registry, metadata, duplication, allocation, lazy-evaluation, labels, halo-exchange, restart, icon-sc, contracts, prior-art
- Model state — v2 distillation — keywords: state, model-state, components, fields, registry, metadata, duplication, allocation, labels, halo-exchange, restart, icon-sc, contracts, prior-art, constraints, goals
msimberg
- Revive components — keywords: components, model-state, protocol, interface, design, field-registry, states, inputs-outputs
- Components and model state — keywords: components, model-state, protocol, interface, design, wiring, metadata, fields, registry, conditional-allocation, restart, halo, derived-quantities, composition, icon-sc
- Cleanup the “decomposition” directory — keywords: decomposition, distributed-computation, mpi, halo-exchange, reductions, naming, refactoring
- restart — keywords: checkpoint, restart, io, state, serialization, netcdf, dycore, distributed
OngChia
- Physics driver and component design — keywords: components, physics-driver, protocol, design
- Scientific test cases for icon4py — keywords: testing, test-cases, scientific-validation, dycore, physics, benchmarking
Yilu
- Physics interface — current design (as built on physics_driver_tmx) — keywords: components, physics-driver, protocol, muphys, tmx, surface-fluxes, design, as-built
- Physics interface — discussion points — keywords: components, physics-driver, protocol, forcing-mode, coupling, metadata, io, design