Skip to main content

icon4py-common

Description

Utilities shared by several ICON4Py components.

Installation instructions

Check the README.md at the root of the model folder for installation instructions.

Contents

IO

module containing IO funcitonality for ICON4Py.

The IO module requires the installation of the io optional dependencies defined in pyproject.toml of the icon4py-common package and can be installed with the following command:

uv pip install .[io]

or even better by running:

uv sync --extra io  # or `uv sync --extra all` which includes everything

at the top-level folder of the repository, which installs all ICON4Py packages including the IO dependencies.

Distributed run

The package decomposition contains infrastructure for parallel implementation of icon4py/model. icon4py uses GHEX for halo exchanges. In order to run in parallel optional dependencies mpi4py and ghex need to be installed, which can be done through

uv sync --extra distributed  # or `uv sync --extra all` which includes everything

from the top-level folder of the repository.

Grid

Contains basic infrastructure regarding the (unstructured) grid used in icon4py. There are two implementations of the general grid a small simple grid with periodic boundaries in simple.py used for testing and the ICON grid icon.py both implement the same protocl. The ICON grid can be initialized from an ICON grid file via the grid_manager.py (THIS is still EXPERIMENTAL!!) or from serialized data. The grid_manager.py needs netcdf as an optional dependency, which can be installed with

uv sync --extra io  # or `uv sync --extra all` which includes everything

from the top-level folder of the repository.

interpolation

Contains interpolation stencils and port of interpolation fields in ICON.

math

math utilities.

states

contains type for the ICON prognostic state used by several packages.

test_utils

Utilities used in tests made available here for usage in other packages

Metadata

Release files for icon4py-common 0.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for icon4py-common 0.5.0
File Size Uploaded Provenance Actions
icon4py_common-0.5.0.tar.gz 228.1 kB With provenance Details for icon4py_common-0.5.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for icon4py-common 0.5.0
File Interpreter ABI Platform Actions
icon4py_common-0.5.0-py3-none-any.whl Python 3 none any Details for icon4py_common-0.5.0-py3-none-any.whl

Total release size: 539.0 kB

Release files / icon4py_common-0.5.0.tar.gz

Download URL icon4py_common-0.5.0.tar.gz
Size 228.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9df3f359e781c253766dd94dfa27556554c2f5dbcf45304edf27539901724588
BLAKE2b-256 checksum
How to use checksums
7a5bcf7bf8bd964f9af09cd3eeef943cf09e25acf45c540fec4ce21fac7a0ef2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Release files / icon4py_common-0.5.0-py3-none-any.whl

Download URL icon4py_common-0.5.0-py3-none-any.whl
Size 310.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
23461383bf8301dd996ab3b84da6a30a7ffc10803bed361bcdaa83bd12fffb2c
BLAKE2b-256 checksum
How to use checksums
64beb7115b8702181b02523c4ee3944873d043f6f2b3c377725040c66598aacc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

Security for icon4py-common 0.5.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for icon4py_common-0.5.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 2, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page