iconspy
ICON Sections in PYthon
iconspy is a python package for constructing sections on the ICON model’s native grid.
It offers the ability to create sections that approximate great circles, follow lines of constant latitude or longitude,
and follow contours of an arbitrary field.
The functionality builds upon that provided by the pyicon package;
however, iconspy offers some extra functionality —
in particular the ability to join together multiple sections and construct sections which follow contours.
Citation
If you use this software in your work, please consider citing it with either an in-text citation (preferred) or in the acknowledgements.
For the text I recommend something along the lines of
Sections were constructed on the native ICON grid using
iconspy(Goldsworth, 2026).
Followed by a bibliography entry of the form
Goldsworth, F. W. (2026). eerie-project/iconspy: vX (Version X) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.21904575
If you use LaTeX you may want to use the bibtex entry:
@software{goldsworth2026iconspy,
author = {Goldsworth, Fraser William},
title = {{eerie-project/iconspy: vX}},
year = {2026},
publisher = {Zenodo},
version = {X},
doi = {10.5281/zenodo.21904575},
}
Issues and feature requests
If you encounter any problems with the code please raise an issue on github. If you have feature requests feel free to reach out there also.
Acknowledgements
This software was developed as part of the EERIE project (grant agreement no 101081383) funded by the European Union.
This software contains modified code from the pyicon package, namely:
function iconspy.core.Section._get_pyic_orientation_along_path
function iconspy.utils._pyicon_convert_tgrid_data
An MIT license applies to these parts of the code (see also the LICENSE file).
I am grateful to Nils Brüggemann for his ongoing development and maintenance of the pyicon package.