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

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

msimberg

  • Revive components — keywords: components, model-state, protocol, interface, design
  • 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