meteoraster 2.5__tar.gz

meteoraster-2.5/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

meteoraster-2.5/MANIFEST.in

@@ -0,0 +1,3 @@
+# The sdist picks up tests/test_*.py through a distutils default, but not
+# conftest.py, which holds the fixtures - without it the shipped suite cannot run.
+recursive-include tests *.py

meteoraster-2.5/NOTICE

@@ -0,0 +1,18 @@
+meteoraster
+Copyright 2025-2026 Jose Pedro Matos and contributors
+
+This product includes software developed at FORESIGHT,
+Instituto Superior Tecnico, Universidade de Lisboa
+(https://foresight.tecnico.ulisboa.pt/).
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

meteoraster-2.5/PKG-INFO

@@ -0,0 +1,419 @@
+Metadata-Version: 2.4
+Name: meteoraster
+Version: 2.5
+Summary: Module for handling distributed ensemble and probabilistic forecast data (5-D meteorological rasters)
+Author-email: Jose Pedro Matos <jose.matos@tecnico.ulisboa.pt>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/FORESIGHT-ULisboa/Tethys-meteoraster
+Project-URL: Repository, https://github.com/FORESIGHT-ULisboa/Tethys-meteoraster
+Project-URL: Issues, https://github.com/FORESIGHT-ULisboa/Tethys-meteoraster/issues
+Project-URL: Changelog, https://github.com/FORESIGHT-ULisboa/Tethys-meteoraster/releases
+Project-URL: FORESIGHT, https://foresight.tecnico.ulisboa.pt/
+Keywords: meteorology,forecast,ensemble,raster,netcdf,ERA5,GFS,C3S,CORDEX
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: numpy<2
+Requires-Dist: scipy
+Requires-Dist: pandas
+Requires-Dist: xarray
+Requires-Dist: netcdf4
+Requires-Dist: h5netcdf
+Requires-Dist: cfgrib
+Requires-Dist: cdsapi
+Requires-Dist: scikit-learn
+Requires-Dist: matplotlib
+Requires-Dist: seaborn
+Requires-Dist: statsmodels
+Requires-Dist: cartopy
+Requires-Dist: beautifulsoup4
+Requires-Dist: openpyxl
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Provides-Extra: build
+Requires-Dist: build; extra == "build"
+Requires-Dist: twine; extra == "build"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: jupyterlab; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="images/foresight.png" alt="FORESIGHT" width="320">
+</p>
+
+# Tethys meteoraster
+
+<p align="center">
+  <a href="https://pypi.org/project/meteoraster/"><img src="https://img.shields.io/pypi/v/meteoraster.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/meteoraster/"><img src="https://img.shields.io/pypi/pyversions/meteoraster.svg" alt="Supported Python versions"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="License: Apache-2.0"></a>
+</p>
+
+**`meteoraster`** is a Python library, developed by [FORESIGHT — Forecasting and
+Optimization for Resilient Environmental Systems through Investigation with
+Groundbreaking Hydrological Tools](https://foresight.tecnico.ulisboa.pt/), for
+**handling distributed ensemble and probabilistic meteorological forecasts**.
+
+Its core data structure, `MeteoRaster`, holds a single **5-D** array indexed by
+`[production_datetime, ensemble_member, leadtime, latitude, longitude]`, and
+wraps it with everything you need to turn raw reanalysis/forecast files into
+report-ready time series, maps and aggregated statistics:
+
+- read ERA5, ERA5-Land, GFS, C3S (seasonal) and CORDEX files into a common model,
+- crop, join, trim, resample and check the completeness of the data,
+- extract point time series or **catchment/zone aggregates from KML polygons**
+  (area-weighted, missing-data aware),
+- persist to compressed NetCDF (`h5netcdf`) and reload losslessly,
+- and plot means, seasonal cycles, coordinates and availability with `cartopy`.
+
+---
+
+## Features
+
+| Category | What you get |
+|---|---|
+| **Data model** | `MeteoRaster` — 5-D `[production_datetime, ensemble_member, leadtime, lat, lon]`; 2-D lat/lon grids; automatic Greenwich (0–360 → −180–180) fix and latitude flip |
+<!-- | **Format readers** | `readERA5_monthly`, `readERA5Land_monthly`, `read_ERA5Land_hourly`, `read_GFS`, `read_C3S`, `readCORDEX_monthly` | -->
+| **Subsetting / merging** | `get_cropped`, `join`, `trim`, `adjust_leadtimes` |
+| **Resampling** | `resample_timestep` (pandas rules) and the standalone `Resample` class |
+| **Extraction** | `get_values_from_latlon`, `get_values_from_KML`, `get_quantiles_from_KML`*, `get_values_from_latlon_by_event` |
+| **Spatial aggregation** | area-weighted coverage matrices from KML polygons, missing-data aware |
+| **Quality / diagnostics** | `is_complete`, `get_complete_index`, `get_missing`, `get_completeness` |
+| **I/O** | `save` / `load` (compressed NetCDF via `h5netcdf`), `to_xarray` |
+| **Visualisation** | `plot_mean`, `plot_mean_projected`, `plot_seasonal`, `plot_coordinates`, `plot_availability`, `add_shapefile`, `add_shape` |
+
+\* `get_quantiles_from_KML` is currently under review and not functional — see
+[AGENTS.md](AGENTS.md).
+
+---
+
+## Installation
+
+`meteoraster` relies on a geospatial stack (**GDAL/`osgeo`**, `cartopy`, `cfgrib`)
+that is most reliably installed with **conda**. Two paths follow: install the
+**released package from PyPI** on top of a conda environment (use the package), or
+install **from source** (develop / run the tests).
+
+### A · Install from PyPI
+
+Create a conda environment that provides the geospatial libraries, then install
+[`meteoraster`](https://pypi.org/project/meteoraster/) into it:
+
+```bat
+conda env create -f environment.yml
+conda activate tethys_rasters
+pip install meteoraster
+```
+
+Upgrading later needs no URL — `pip install --upgrade meteoraster` always picks up
+the newest release.
+
+> The package declares its pure-Python dependencies, but **GDAL is intentionally
+> not** a pip dependency (it is a system/conda package). The conda environment
+> above provides it. If you only need the point/plotting features and already
+> have GDAL, you can `pip install meteoraster` into any environment.
+
+Every release is also attached to the
+[GitHub releases page](https://github.com/FORESIGHT-ULisboa/Tethys-meteoraster/releases),
+which is useful to pin an exact build without going through PyPI:
+
+```bat
+pip install https://github.com/FORESIGHT-ULisboa/Tethys-meteoraster/releases/download/v2.5/meteoraster-2.5-py3-none-any.whl
+```
+
+### B · Install from source (development)
+
+#### 1 · Create the conda environment
+
+```bat
+conda env create -f environment.yml
+conda activate tethys_rasters
+```
+
+#### 2 · Install the package (editable) with the dev extras
+
+From the repository root:
+
+```bat
+pip install -e ".[dev]"
+```
+
+That adds `pytest`, `pytest-cov`, `build`, `twine` and `jupyterlab` on top of the
+runtime dependencies.
+
+---
+
+## Quick start
+
+```python
+import numpy as np
+import pandas as pd
+from meteoraster import MeteoRaster
+
+# data axes: [production_datetime, ensemble_member, leadtime, lat, lon]
+data = np.random.rand(2, 3, 2, 4, 5)
+
+mr = MeteoRaster(
+    data=data,
+    latitudes=np.linspace(40, 30, 4),       # 1-D is auto-meshed to 2-D
+    longitudes=np.linspace(-10, 10, 5),
+    production_datetime=pd.to_datetime(["2023-01-01", "2023-01-02"]).values,
+    leadtimes=np.array([pd.Timedelta(days=1), pd.Timedelta(days=2)]),
+    units="mm",
+    variable="precip",
+)
+```
+
+### Read a real dataset
+
+The readers live in `meteoraster.utils` and return a ready-to-use `MeteoRaster`:
+
+```python
+from meteoraster.utils import readERA5Land_monthly, read_C3S
+
+era5 = readERA5Land_monthly("era5land_tp.grib", "tp")   # total precipitation
+c3s  = read_C3S("seasonal_t2m.grib", "t2m")             # seasonal 2 m temperature
+```
+
+### Extract a point time series
+
+```python
+# DataFrame: index = production_datetime, columns = MultiIndex(leadtime, ensemble_member)
+ts = mr.get_values_from_latlon(lat=35.0, lon=0.0)
+```
+
+### Aggregate over KML zones (e.g. catchments)
+
+```python
+# agg: DataFrame indexed by production date, columns MultiIndex(zone, leadtime, ensemble_member)
+# centroids: DataFrame of zone centroids (x, y)
+agg, centroids = mr.get_values_from_KML("zones.kml", nameField="zone_id")
+```
+
+### Crop, save and reload
+
+```python
+sub = mr.get_cropped(from_lat=32, to_lat=38, from_lon=-2, to_lon=7,
+                     from_prod_date=pd.Timestamp("2023-01-02"))
+
+sub.save("forecast.nc")                 # compressed NetCDF (h5netcdf)
+reloaded = MeteoRaster.load("forecast.nc")
+```
+
+### Resample in time
+
+```python
+import numpy as np
+
+mr.resample_timestep("MS", fun=np.nanmean)   # to month start, ensemble-wise
+
+# Or resample a production×leadtime DataFrame with the standalone helper:
+from meteoraster import Resample
+resampled = Resample.resample(df, timestep_frequency="1D", resamplingType="sum")
+```
+
+### Plot
+
+```python
+ax, cbar = mr.plot_mean(central_longitude=0, coastline=True, borders=True,
+                        colorbar=True, cmap="viridis")
+mr.add_shapefile(ax, "basin.shp")
+mr.plot_seasonal(lat=35.0, lon=0.0)
+mr.plot_availability()
+```
+
+---
+
+## Project structure
+
+```
+Tethys-meteoraster/
+├── meteoraster/
+│   ├── __init__.py            # exports MeteoRaster, Resample
+│   ├── meteoraster.py         # MeteoRaster core class
+│   ├── resample.py            # Resample (time-step resampling of DataFrames)
+│   └── utils.py               # ERA5 / ERA5-Land / GFS / C3S / CORDEX readers
+├── tests/                     # pytest suite + fixtures (conftest.py)
+├── images/foresight.png       # README header
+├── environment.yml            # conda environment (tethys_rasters)
+├── pyproject.toml             # packaging + pytest configuration
+├── AGENTS.md                  # canonical guidance for humans & AI agents
+├── CLAUDE.md                  # → points to AGENTS.md
+├── .github/copilot-instructions.md  # → points to AGENTS.md
+├── .github/workflows/release.yml    # build + publish to PyPI on tag push
+├── .github/scripts/check_version.py # release guard: version declared consistently
+├── LICENSE                    # Apache 2.0
+├── NOTICE                     # attribution required by Apache 2.0
+└── README.md
+```
+
+---
+
+## Running the tests
+
+```bat
+conda activate tethys_rasters
+pip install -e ".[dev]"
+pytest -ra
+```
+
+The suite covers construction, cropping, point/KML extraction, NetCDF
+round-trips, completeness checks, resampling and the deprecated-alias warnings.
+Tests that need real GRIB/NetCDF inputs (the format readers) are out of scope and
+not included.
+
+---
+
+## Building a distribution (wheel + sdist)
+
+The package builds with the standard [PEP 517](https://peps.python.org/pep-0517/)
+toolchain:
+
+```bat
+conda activate tethys_rasters
+pip install -e ".[build]"
+python -m build
+```
+
+This produces both artifacts in `dist/`:
+
+```
+dist/
+├── meteoraster-2.5-py3-none-any.whl
+└── meteoraster-2.5.tar.gz
+```
+
+Install the wheel anywhere (provided GDAL is available):
+
+```bat
+pip install dist/meteoraster-2.5-py3-none-any.whl
+```
+
+Notes:
+- The version lives in [pyproject.toml](pyproject.toml) (`project.version`) and is
+  mirrored in `MeteoRaster.VERSION` — bump both together.
+  [.github/scripts/check_version.py](.github/scripts/check_version.py) enforces
+  that at release time.
+- Building by hand is only needed to inspect an artifact locally. Actual releases
+  are produced by CI — see [Releasing](#releasing) below.
+
+---
+
+## Releasing
+
+Releases are automated by
+[.github/workflows/release.yml](.github/workflows/release.yml). To cut version
+`X.Y`:
+
+1. Bump the version in **both** [pyproject.toml](pyproject.toml) and
+   `MeteoRaster.VERSION`, then commit.
+2. Tag and push:
+
+   ```bat
+   git tag vX.Y
+   git push origin vX.Y
+   ```
+
+The workflow then verifies the two version declarations agree with the tag, builds
+the wheel and sdist, runs `twine check --strict`, publishes to
+[PyPI](https://pypi.org/project/meteoraster/), and attaches both artifacts to the
+GitHub release.
+
+To rehearse without touching PyPI, run the workflow manually from the **Actions**
+tab and leave the target as `testpypi`; it builds and uploads to
+[TestPyPI](https://test.pypi.org/project/meteoraster/) with no tag required.
+
+> **PyPI uploads are immutable** — a version number can never be reused, even
+> after deletion. Get the version right before pushing the tag.
+
+Authentication uses [PyPI Trusted Publishing](https://docs.pypi.org/trusted-publishers/)
+(OIDC), so no API tokens are stored in the repository. The one-time setup is
+described in [AGENTS.md](AGENTS.md).
+
+---
+
+## API reference
+
+### `MeteoRaster`
+
+**Construction & conversion**
+
+| Member | Description |
+|---|---|
+| `MeteoRaster(data, latitudes, longitudes, production_datetime, leadtimes, units='unknown', variable='unknown', …)` | Build from a 5-D array (or a dict with the same keys). 1-D lat/lon are auto-meshed to 2-D; longitudes are wrapped to [−180, 180] and latitudes flipped if needed. |
+| `copy()` | Deep copy. |
+| `to_xarray()` | Convert to a labelled `xarray.DataArray`. |
+
+**Subsetting, merging & resampling**
+
+| Member | Description |
+|---|---|
+| `get_cropped(from_prod_date, to_prod_date, from_lat, to_lat, from_lon, to_lon, from_leadtime, to_leadtime)` | Crop in time and space; returns a new `MeteoRaster`. |
+| `join(meteoRaster, strickt=False, trim=False)` | Concatenate another raster along production dates (aligns ensembles/leadtimes). |
+| `trim()` | Drop leading/trailing all-NaN production dates. |
+| `adjust_leadtimes(period='months')` | Align leadtimes to relative periods (experimental). |
+| `resample_timestep(rule, fun=np.mean)` | Resample production dates with pandas rules (experimental). |
+
+**Extraction & aggregation**
+
+| Member | Description |
+|---|---|
+| `get_values_from_latlon(lat, lon)` | Time series from the nearest pixel as a `DataFrame`. |
+| `get_values_from_KML(kml, nameField=None, …)` | Area-weighted aggregate over KML polygons → `(agg, centroids)`. |
+| `get_quantiles_from_KML(...)` | Spatial quantiles over KML zones — **under review, not functional**. |
+| `get_values_from_latlon_by_event(production_date_dataframe)` | *(static)* Reindex a production-date frame by event date. |
+
+**Quality & diagnostics**
+
+| Member | Description |
+|---|---|
+| `is_complete(full_ensemble=True, space_completeness=False)` | Whether every production×leadtime slice has finite data. |
+| `get_complete_index(full_ensemble=True, space_completeness=False)` | Boolean `DataFrame` (production × leadtime) of completeness. |
+| `get_missing()` | Fraction of missing pixels per leadtime/ensemble member. |
+| `get_completeness(file)` | *(classmethod)* Read the `complete` flag from a saved file. |
+
+**I/O**
+
+| Member | Description |
+|---|---|
+| `save(file, complevel=1, complete=None)` | Write compressed NetCDF via `h5netcdf`. |
+| `load(file, verbose=None)` | *(classmethod)* Reload a NetCDF written by `save`. |
+
+**Visualisation**
+
+| Member | Description |
+|---|---|
+| `create_plot(central_longitude, …)` | Create a `cartopy` axes. |
+| `plot_mean(ax=None, coastline=False, borders=False, colorbar=True, cmap='viridis', …)` | Map of the ensemble/temporal mean → `(ax, cbar)`. |
+| `plot_mean_projected`, `plot_coordinates`, `plot_seasonal`, `plot_availability` | Projected mean, grid coordinates, seasonal cycle, data availability. |
+| `add_shapefile(ax, shapefile_path, …)` / `add_shape(ax, path, …)` | Overlay shapefile geometries/boundaries. |
+
+> Deprecated camelCase aliases (`getCropped`, `getValuesFromKML`,
+> `getDataFromLatLon`, `getQuantilesFromKML`, `resampleTimeStep`) still work but
+> emit a `DeprecationWarning`; use the snake_case names above.
+
+### `Resample`
+
+| Member | Description |
+|---|---|
+| `Resample.resample(data, timestep_frequency, resamplingType, date_from=None, date_to=None, print_func=None)` | *(classmethod)* Resample a production×leadtime `DataFrame`. `resamplingType` ∈ {`'sum'`, `'mean'`, `'linear'`, `'max'`}. |
+
+---
+
+## License
+
+Licensed under the **Apache License, Version 2.0** — see [LICENSE](LICENSE) and
+[NOTICE](NOTICE).