History¶
0.5.0 (2025-08-15)¶
Additions¶
Added
param_id
mappings for short wave radiation
Changes¶
eccodes version requirement is updated to
>=2.38,<2.40
Removed feature extraction request validation
Deprecations¶
To be removed in version 0.6
product
moduletasking
modulegrib_decoder.GribReader
class
0.5.0-rc1 (2025-07-17)¶
Additions¶
Added
StreamDataSource
Added in-memory cache to the
iconremap
function
Fixes¶
Allow empty requests on the
FileDataSource
Changes¶
Changed implementation to use earthkit-meteo
relhum
theta
thetav
wind speed
Numpy version requirement is updated to
>=1.26.4,<2.4.0
0.4.0 (2025-05-27)¶
Fixes¶
Fixed
ogd_api.get_asset_urls
pagination infinite loop.
0.4.0-rc1 (2025-05-19)¶
Additions¶
Added the
extrapolate_k2p
operator (experimental).Added a
clip_lateral_boundary_strip
operator.Added
load_boundary_idx_from_file
function to theicon_grid
module.Added a script to generate the logo in the readme.
ogd_api
:Added
lead_time
andref_time
as aliases tohorizon
andreference_datetime
parameters in theRequest
class.Added support for
reference_datetime
value"latest"
.Added support for multiple
horizon
/lead_time
values in theRequest
class.
Fixes¶
Doc: removed outdated content and fixed rendering issues
Breaking changes¶
ogd_api.get_asset_url
renamed toogd_api.get_asset_urls
and now returnslist[str]
.
0.3.0 (2025-04-11)¶
Additions¶
Updated eccodes to version 2.38.3 which includes a binary distribution in PyPI.
The python package is now pushed to PyPI.
ogd_api
:Added
get_collection_asset_url
function to fetch pre-signed URLs for static assets from a STAC collection.download_from_ogd
function performs checksum verification.
mars
:Added default number of levels for icon and kenda models.
Added support for bounding box feature extraction requests.
Fixes¶
regrid
:regrid
andiconremap
functions now correctly set the metadata section 3 for destinations grids in the CRS UTM 32N (Switzerland).
Breaking Changes¶
The
geo_coords_urls.yaml
file containing pre-signed URLs for coordinate files has been removed. Coordinate URLs are now resolved dynamically using the new get_collection_asset_url function.The URL domain in
ogd_api
has been changed from the integration to the production environment.The eccodes definitions are installed using the
eccodes-cosmo-resources-python
package from PyPI.
0.2.0 (2025-03-20)¶
Additions¶
cli
: Added subcommand for the regrid operatordata_source
Added
URLDataSource
,FDBDataSource
,FileDataSource
,PolytopeDataSource
as implementations ofDataSource
retrieve
accepts an argument of typemars.Request
grib_decoder
Added
save
functionload
supports the ICON native gridAdded
geo_coords
optional argument to theload
function
mars
: Addedfeature
attribute to themars.Request
classmch_model_data
: Addedarchive_to_fdb
functionogd_api
Added
get_from_ogd
functionAdded
ogd_api.Request
class
operators
regrid
: Addedicon2rotlatlon
,icon2geolatlon
andiconremap
functionsAdded
crop
module
Breaking Changes¶
The constants module is renamed to physical constants and the
pc_
prefix is dropped in favour of aliasing the module topc
at the call sitesThe grib definitions context is no longer derived from the request model attribute. In practice, all defined models required the cosmo definitions as IFS grib data does not define the model mars key. Setting
data_scope
config toifs
to disable the cosmo definitions context remains possible.data_source.DataSource
is now an abstract base classRenamed dimension
time
tolead_time
and changed its type fromint
tonumpy.timedelta64[ns]
Added dimension
ref_time
with typenumpy.datetime64[ns]
DataArray
objects representing a field no longer have themessage
attribute but now have ametadata
attribute that is an instance ofStandAloneGribMetadata
from earthkit-data.FDBDataSource
,mch_model_data.get_from_fdb
andmch_model_data.archive_to_fdb
require thefdb
extra dependencyPolytopeDataSource
andmch_mode_data.get_from_polytope
requires thepolytope
extra dependencyThe
operators.regrid
module now requires theregrid
extra dependencies
0.2.0-rc3 (2023-12-18)¶
Added vertical interpolation operator
interpolate_k2any
Testing data marker determines the test data that should be used
Removed the
system_definitions
module
0.2.0-rc2 (2023-12-11)¶
Added
product.run_products
functionUpdated field mappings
Data cache will inject the step and number in the request depending on the file pattern
mars.Request
now supports multiple params
0.2.0-rc1 (2023-12-01)¶
Added support for the FDB data source
Added support for running tests on balfrin (FDB only)
Added modules
config
: manage configurationdata_cache
: support fieldextra testing from FDBdata_source
: enable reading from files or from FDBmars
: mars request validationproduct
: product descriptiontasking
: dask delayed wrapper
Added operators
atmo
gis
lateral_operators
regrid
relhum
time_operators
wind
Changed: flexpart operator no longer uses cosmo naming conventions
Breaking: removed the
load_fields
method from the GribReader classBreaking: the
load
method of GribReader class now takes a mapping of labels to requests and returns a mapping of labels toxarray.DataArray
0.1.0 (2023-07-11)¶
Added operators
brn
curl
destagger
diff
flexpart (for IFS model output)
hzerocl
omega_slope
pot_vortic
rho
theta
thetav
time_rate
interpolate_k2p
interpolate_k2theta
minmax_k
integrate_k
Added ninjo_k2th product
Added GRIB data loader based on earthkit-data