pyepwmorph 2.2.0__tar.gz → 3.1.0__tar.gz

pyepwmorph-3.1.0/PKG-INFO

@@ -0,0 +1,260 @@
+Metadata-Version: 2.4
+Name: pyepwmorph
+Version: 3.1.0
+Summary: A python package to enable simple and easy gathering of climate model data and morphing of EPW files
+Project-URL: Homepage, https://github.com/justinfmccarty/pyepwmorph
+Project-URL: Issues, https://github.com/justinfmccarty/pyepwmorph/issues
+Project-URL: Changelog, https://github.com/justinfmccarty/pyepwmorph/blob/main/CHANGELOG.md
+Author-email: Justin McCarty <mccarty.justin.f@gmail.com>
+License: MIT
+License-File: LICENSE
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Requires-Python: >=3.9
+Requires-Dist: dask>=2023.5.0
+Requires-Dist: gcsfs>=2023.5.0
+Requires-Dist: intake-esm>=2023.6.0
+Requires-Dist: intake>=0.6.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.2
+Requires-Dist: pvlib<1.0.0,>=0.13.0
+Requires-Dist: pyarrow>=13.0.0
+Requires-Dist: xarray>=2022.3.0
+Provides-Extra: dev
+Requires-Dist: build>=0.10; extra == 'dev'
+Requires-Dist: ipykernel>=6.20.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Requires-Dist: twine>=4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pyepwmorph
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/pyepwmorph.svg)](https://pypi.org/project/pyepwmorph/)
+
+A Python package for morphing EnergyPlus Weather (EPW) files with climate model data. Supports CMIP6 projections from Google Cloud and custom CSV-based model data for both future and historical scenarios.
+
+## Overview
+
+`pyepwmorph` enables building performance analysts and researchers to create morphed weather files by applying scientifically validated procedures (Belcher et al. 2005, Jentsch et al. 2013) to existing EPW files. The package can morph EPWs using:
+
+- **CMIP6 data** fetched automatically from Google Cloud (Pangeo)
+- **Custom CSV data** from any climate model, including historical reconstructions
+- **CH2025 station scenarios** for Switzerland, shipped with the package and indexed by global warming level
+
+## Installation
+
+### With uv (recommended)
+
+```bash
+uv add pyepwmorph
+```
+
+### Development setup
+
+```bash
+git clone https://github.com/justinfmccarty/pyepwmorph.git
+cd pyepwmorph
+uv sync --extra dev
+```
+
+### With pip
+
+```bash
+pip install pyepwmorph
+```
+
+## Quick start
+
+### CMIP6 workflow (future projections)
+
+```python
+import pyepwmorph.tools.workflow as workflow
+
+results = workflow.morphing_workflow(
+    project_name="MyBuilding_Future",
+    epw_file="weather.epw",
+    user_variables=["Temperature", "Humidity", "Clouds and Radiation"],
+    user_pathways=["Middle of the Road"],   # ssp245
+    percentiles=[50],
+    target_years=[2050],
+    output_directory="output/",
+)
+```
+
+### Custom CSV workflow (historical or any model)
+
+```python
+import pyepwmorph.tools.workflow as workflow
+
+custom_data = {
+    "reference": {
+        "tas": "data/reference_tas.csv",
+        "tasmax": "data/reference_tasmax.csv",
+        "tasmin": "data/reference_tasmin.csv",
+    },
+    "target_1990s": {
+        "tas": "data/target_tas.csv",
+        "tasmax": "data/target_tasmax.csv",
+        "tasmin": "data/target_tasmin.csv",
+    },
+}
+
+results = workflow.morphing_workflow(
+    project_name="Historical_Morph",
+    epw_file="weather.epw",
+    user_variables=["Temperature"],
+    user_pathways=["target_1990s"],
+    percentiles=[50],
+    target_years=[1990],
+    output_directory="output/",
+    data_source="custom",
+    custom_data=custom_data,
+    reference_scenario="reference",
+)
+```
+
+Custom CSVs should have a `date` column (parseable by pandas) and a column named after the CMIP6 variable (e.g. `tas`, `tasmax`). Rows should be monthly.
+
+The reference and target scenarios must cover **different years**, the same way the CMIP6 `historical` and `sspXXX` experiments do. The two series are concatenated before the baseline and target periods are sliced out, so overlapping years get averaged together and weaken the climate signal. Keep `baseline_range` inside the years the reference scenario covers.
+
+### Switzerland (CH2025 warming levels)
+
+For an EPW inside Switzerland, `data_source="ch2025"` morphs from MeteoSwiss CH2025 station scenarios. There is no target year: each pathway is a global warming level relative to 1991-2020, and the run is offline.
+
+```python
+results = workflow.morphing_workflow(
+    project_name="Zurich_GWL2",
+    epw_file="zurich.epw",
+    user_variables=["Temperature", "Humidity", "Wind", "Radiation", "Dew Point"],
+    user_pathways=["GWL 2.0"],
+    percentiles=[50],
+    output_directory="output/",
+    data_source="ch2025",
+)
+morphed = results["gwl2.0"]["50"]
+```
+
+The site is matched to the nearest station that has the requested variables (or, with `ch2025_full_coverage=True`, the nearest station that has every CH2025 variable), with an elevation penalty so a much higher station is not chosen just because it is close on the map. Supported variables are temperature, humidity, dew point, wind, and radiation (global, diffuse, and direct). Pressure and cloud cover are not in CH2025; requesting them raises an error. Sky cover is left at the EPW's baseline values when radiation is morphed, so longwave sky temperature in EnergyPlus does not follow the shortwave change.
+
+The signal is the change from the 1991-2020 reference climate to the chosen warming level. Each model chain's change is computed first, over the chains that reach that warming level, and the percentiles are taken of those changes. If the EPW's years fall outside 1991-2020, a `UserWarning` recommends a TMY built from 1991-2020 data and the signal is still applied to the file as it stands. The same caveats are listed in `MorphConfig.ch2025_notes` and the matched station in `MorphConfig.ch2025_station`.
+
+CH2025 data: MeteoSwiss & ETH Zurich (2025), Climate CH2025 - Daily Datasets, CC-BY 4.0, https://doi.org/10.18751/climate/scenarios/ch2025/data/1.0/
+
+## Climate scenarios
+
+| Scenario              | SSP    | Description                             | Expected warming |
+| --------------------- | ------ | --------------------------------------- | ---------------- |
+| Best Case Scenario    | ssp126 | Strong mitigation, renewable transition | ~1.8 C by 2100   |
+| Middle of the Road    | ssp245 | Moderate mitigation efforts             | ~2.7 C by 2100   |
+| Upper Middle Scenario | ssp370 | Regional rivalry, slow convergence      | ~3.6 C by 2100   |
+| Worst Case Scenario   | ssp585 | Fossil-fueled development               | ~4.4 C by 2100   |
+
+## Morphing variables
+
+- **Temperature** -- dry bulb temperature (shift + stretch)
+- **Humidity** -- relative humidity, stretched in specific humidity space
+- **Pressure** -- atmospheric pressure (shift)
+- **Wind** -- wind speed (stretch)
+- **Radiation** -- global/diffuse/direct radiation, without changing sky cover (all sources; the only radiation option for CH2025)
+- **Clouds and Radiation** -- global/diffuse/direct radiation and sky cover (CMIP6 and custom data)
+- **Dew Point** -- recalculated from morphed temperature and humidity
+
+### Variable dependencies
+
+Some variables cannot be morphed on their own:
+
+- **Humidity** requires Temperature and Pressure, except with CH2025, where relative humidity is stretched directly
+- **Dew Point** requires Temperature, Humidity, and Pressure (Temperature and Humidity only with CH2025)
+
+Dependencies are added automatically and are **written to the output file**. Asking for `Dew Point` alone therefore returns an EPW with morphed pressure, temperature, relative humidity, and dew point, which keeps the file internally consistent. `MorphConfig.resolved_variables` shows exactly what will be written, in the order it is computed.
+
+## Caching
+
+Climate model data is cached locally after the first download, and the cache is consulted before the remote catalogue is opened so a hit costs no network traffic.
+
+```python
+import pyepwmorph.models.access as access
+
+stats = access.get_cmip6_cache_stats()
+access.clear_cmip6_cache()
+```
+
+Cache entries live in the per-user cache directory (`~/Library/Caches/pyepwmorph` on macOS, `~/.cache/pyepwmorph` on Linux, `%LOCALAPPDATA%\pyepwmorph` on Windows) and are keyed by location, pathway, variable, model sources, and time slices. Two environment variables override the defaults:
+
+| Variable                  | Purpose                        | Default |
+| ------------------------- | ------------------------------ | ------- |
+| `PYEPWMORPH_CACHE_DIR`    | Where cache files are written  | per-user cache directory |
+| `PYEPWMORPH_CACHE_MAX_MB` | Size cap before old files go   | 500 |
+
+## Available climate models
+
+```python
+from pyepwmorph.tools.utilities import available_models
+
+models = available_models()
+```
+
+## Development
+
+```bash
+git clone https://github.com/justinfmccarty/pyepwmorph.git
+cd pyepwmorph
+uv sync --extra dev
+
+# Run tests (fully offline)
+uv run pytest
+
+# Run with coverage
+uv run pytest --cov=pyepwmorph
+
+# Lint
+uv run ruff check pyepwmorph tests gui
+```
+
+### Releases
+
+```bash
+./release.sh [patch|minor|major]
+```
+
+The script refuses to run on a dirty tree, off `main`, with failing lint or tests, or without a matching `CHANGELOG.md` section. It bumps the version, tags, and pushes; creating the GitHub Release then triggers the PyPI publish workflow.
+
+```bash
+gh release create v3.0.0 \
+  --title "v3.0.0" \
+  --notes "See CHANGELOG.md."
+```
+
+## Changes
+
+See [CHANGELOG.md](CHANGELOG.md) for the full history. The most recent release corrects several morphing calculations, so morphed humidity, dew point, wind speed, cloud cover, and direct/diffuse radiation all differ from files produced by earlier versions.
+
+## Requirements
+
+- Python >= 3.9
+- pandas >= 2.2
+- Internet connection (for CMIP6 data download; the custom CSV and CH2025 workflows run offline)
+
+## License
+
+MIT License. See [LICENSE](LICENSE).
+
+## Citation
+
+```text
+McCarty, J. (2026). pyepwmorph: A Python package for climate-informed
+EPW file morphing. Version 3.0.0.
+https://github.com/justinfmccarty/pyepwmorph
+```

pyepwmorph-3.1.0/README.md

@@ -0,0 +1,221 @@
+# pyepwmorph
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9%2B-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/pyepwmorph.svg)](https://pypi.org/project/pyepwmorph/)
+
+A Python package for morphing EnergyPlus Weather (EPW) files with climate model data. Supports CMIP6 projections from Google Cloud and custom CSV-based model data for both future and historical scenarios.
+
+## Overview
+
+`pyepwmorph` enables building performance analysts and researchers to create morphed weather files by applying scientifically validated procedures (Belcher et al. 2005, Jentsch et al. 2013) to existing EPW files. The package can morph EPWs using:
+
+- **CMIP6 data** fetched automatically from Google Cloud (Pangeo)
+- **Custom CSV data** from any climate model, including historical reconstructions
+- **CH2025 station scenarios** for Switzerland, shipped with the package and indexed by global warming level
+
+## Installation
+
+### With uv (recommended)
+
+```bash
+uv add pyepwmorph
+```
+
+### Development setup
+
+```bash
+git clone https://github.com/justinfmccarty/pyepwmorph.git
+cd pyepwmorph
+uv sync --extra dev
+```
+
+### With pip
+
+```bash
+pip install pyepwmorph
+```
+
+## Quick start
+
+### CMIP6 workflow (future projections)
+
+```python
+import pyepwmorph.tools.workflow as workflow
+
+results = workflow.morphing_workflow(
+    project_name="MyBuilding_Future",
+    epw_file="weather.epw",
+    user_variables=["Temperature", "Humidity", "Clouds and Radiation"],
+    user_pathways=["Middle of the Road"],   # ssp245
+    percentiles=[50],
+    target_years=[2050],
+    output_directory="output/",
+)
+```
+
+### Custom CSV workflow (historical or any model)
+
+```python
+import pyepwmorph.tools.workflow as workflow
+
+custom_data = {
+    "reference": {
+        "tas": "data/reference_tas.csv",
+        "tasmax": "data/reference_tasmax.csv",
+        "tasmin": "data/reference_tasmin.csv",
+    },
+    "target_1990s": {
+        "tas": "data/target_tas.csv",
+        "tasmax": "data/target_tasmax.csv",
+        "tasmin": "data/target_tasmin.csv",
+    },
+}
+
+results = workflow.morphing_workflow(
+    project_name="Historical_Morph",
+    epw_file="weather.epw",
+    user_variables=["Temperature"],
+    user_pathways=["target_1990s"],
+    percentiles=[50],
+    target_years=[1990],
+    output_directory="output/",
+    data_source="custom",
+    custom_data=custom_data,
+    reference_scenario="reference",
+)
+```
+
+Custom CSVs should have a `date` column (parseable by pandas) and a column named after the CMIP6 variable (e.g. `tas`, `tasmax`). Rows should be monthly.
+
+The reference and target scenarios must cover **different years**, the same way the CMIP6 `historical` and `sspXXX` experiments do. The two series are concatenated before the baseline and target periods are sliced out, so overlapping years get averaged together and weaken the climate signal. Keep `baseline_range` inside the years the reference scenario covers.
+
+### Switzerland (CH2025 warming levels)
+
+For an EPW inside Switzerland, `data_source="ch2025"` morphs from MeteoSwiss CH2025 station scenarios. There is no target year: each pathway is a global warming level relative to 1991-2020, and the run is offline.
+
+```python
+results = workflow.morphing_workflow(
+    project_name="Zurich_GWL2",
+    epw_file="zurich.epw",
+    user_variables=["Temperature", "Humidity", "Wind", "Radiation", "Dew Point"],
+    user_pathways=["GWL 2.0"],
+    percentiles=[50],
+    output_directory="output/",
+    data_source="ch2025",
+)
+morphed = results["gwl2.0"]["50"]
+```
+
+The site is matched to the nearest station that has the requested variables (or, with `ch2025_full_coverage=True`, the nearest station that has every CH2025 variable), with an elevation penalty so a much higher station is not chosen just because it is close on the map. Supported variables are temperature, humidity, dew point, wind, and radiation (global, diffuse, and direct). Pressure and cloud cover are not in CH2025; requesting them raises an error. Sky cover is left at the EPW's baseline values when radiation is morphed, so longwave sky temperature in EnergyPlus does not follow the shortwave change.
+
+The signal is the change from the 1991-2020 reference climate to the chosen warming level. Each model chain's change is computed first, over the chains that reach that warming level, and the percentiles are taken of those changes. If the EPW's years fall outside 1991-2020, a `UserWarning` recommends a TMY built from 1991-2020 data and the signal is still applied to the file as it stands. The same caveats are listed in `MorphConfig.ch2025_notes` and the matched station in `MorphConfig.ch2025_station`.
+
+CH2025 data: MeteoSwiss & ETH Zurich (2025), Climate CH2025 - Daily Datasets, CC-BY 4.0, https://doi.org/10.18751/climate/scenarios/ch2025/data/1.0/
+
+## Climate scenarios
+
+| Scenario              | SSP    | Description                             | Expected warming |
+| --------------------- | ------ | --------------------------------------- | ---------------- |
+| Best Case Scenario    | ssp126 | Strong mitigation, renewable transition | ~1.8 C by 2100   |
+| Middle of the Road    | ssp245 | Moderate mitigation efforts             | ~2.7 C by 2100   |
+| Upper Middle Scenario | ssp370 | Regional rivalry, slow convergence      | ~3.6 C by 2100   |
+| Worst Case Scenario   | ssp585 | Fossil-fueled development               | ~4.4 C by 2100   |
+
+## Morphing variables
+
+- **Temperature** -- dry bulb temperature (shift + stretch)
+- **Humidity** -- relative humidity, stretched in specific humidity space
+- **Pressure** -- atmospheric pressure (shift)
+- **Wind** -- wind speed (stretch)
+- **Radiation** -- global/diffuse/direct radiation, without changing sky cover (all sources; the only radiation option for CH2025)
+- **Clouds and Radiation** -- global/diffuse/direct radiation and sky cover (CMIP6 and custom data)
+- **Dew Point** -- recalculated from morphed temperature and humidity
+
+### Variable dependencies
+
+Some variables cannot be morphed on their own:
+
+- **Humidity** requires Temperature and Pressure, except with CH2025, where relative humidity is stretched directly
+- **Dew Point** requires Temperature, Humidity, and Pressure (Temperature and Humidity only with CH2025)
+
+Dependencies are added automatically and are **written to the output file**. Asking for `Dew Point` alone therefore returns an EPW with morphed pressure, temperature, relative humidity, and dew point, which keeps the file internally consistent. `MorphConfig.resolved_variables` shows exactly what will be written, in the order it is computed.
+
+## Caching
+
+Climate model data is cached locally after the first download, and the cache is consulted before the remote catalogue is opened so a hit costs no network traffic.
+
+```python
+import pyepwmorph.models.access as access
+
+stats = access.get_cmip6_cache_stats()
+access.clear_cmip6_cache()
+```
+
+Cache entries live in the per-user cache directory (`~/Library/Caches/pyepwmorph` on macOS, `~/.cache/pyepwmorph` on Linux, `%LOCALAPPDATA%\pyepwmorph` on Windows) and are keyed by location, pathway, variable, model sources, and time slices. Two environment variables override the defaults:
+
+| Variable                  | Purpose                        | Default |
+| ------------------------- | ------------------------------ | ------- |
+| `PYEPWMORPH_CACHE_DIR`    | Where cache files are written  | per-user cache directory |
+| `PYEPWMORPH_CACHE_MAX_MB` | Size cap before old files go   | 500 |
+
+## Available climate models
+
+```python
+from pyepwmorph.tools.utilities import available_models
+
+models = available_models()
+```
+
+## Development
+
+```bash
+git clone https://github.com/justinfmccarty/pyepwmorph.git
+cd pyepwmorph
+uv sync --extra dev
+
+# Run tests (fully offline)
+uv run pytest
+
+# Run with coverage
+uv run pytest --cov=pyepwmorph
+
+# Lint
+uv run ruff check pyepwmorph tests gui
+```
+
+### Releases
+
+```bash
+./release.sh [patch|minor|major]
+```
+
+The script refuses to run on a dirty tree, off `main`, with failing lint or tests, or without a matching `CHANGELOG.md` section. It bumps the version, tags, and pushes; creating the GitHub Release then triggers the PyPI publish workflow.
+
+```bash
+gh release create v3.0.0 \
+  --title "v3.0.0" \
+  --notes "See CHANGELOG.md."
+```
+
+## Changes
+
+See [CHANGELOG.md](CHANGELOG.md) for the full history. The most recent release corrects several morphing calculations, so morphed humidity, dew point, wind speed, cloud cover, and direct/diffuse radiation all differ from files produced by earlier versions.
+
+## Requirements
+
+- Python >= 3.9
+- pandas >= 2.2
+- Internet connection (for CMIP6 data download; the custom CSV and CH2025 workflows run offline)
+
+## License
+
+MIT License. See [LICENSE](LICENSE).
+
+## Citation
+
+```text
+McCarty, J. (2026). pyepwmorph: A Python package for climate-informed
+EPW file morphing. Version 3.0.0.
+https://github.com/justinfmccarty/pyepwmorph
+```

pyepwmorph-3.1.0/pyepwmorph/__init__.py

@@ -0,0 +1,8 @@
+"""pyepwmorph -- Climate model data gathering and EPW file morphing."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("pyepwmorph")
+except PackageNotFoundError:  # running from a source tree that was never installed
+    __version__ = "0.0.0+unknown"

pyepwmorph-3.1.0/pyepwmorph/data/__init__.py

@@ -0,0 +1 @@
+"""Shipped climate datasets."""

{pyepwmorph-2.2.0 → pyepwmorph-3.1.0}/pyepwmorph/models/access.py

@@ -1,16 +1,11 @@
-# coding=utf-8
 """
 various scripts for accessing different flavors of climate models
 """
 
-import warnings
-
 from pyepwmorph.tools import cache
 
-warnings.filterwarnings("ignore")
-
 __author__ = "Justin McCarty"
-__copyright__ = "Copyright 2023"
+__copyright__ = "Copyright 2023-2026"
 __credits__ = ["Justin McCarty"]
 __license__ = "MIT"
 
@@ -46,12 +41,12 @@ def access_cmip6_data(models, pathway, variable):
     import intake
 
     # NOTE: No caching at this level because the data contains lazy dask arrays
-    # that reference the full global grid. Caching happens in coordinate.py after
+    # that reference the full global grid. Caching happens in workflow.py once
     # the data has been spatially selected and computed for a specific location.
-    
+
     table_id = 'Amon'  # atmospheric variables (A) saved at monthly resolution (mon)
     member_id = 'r1i1p1f1'
-    
+
     # Fetch from Google Cloud
     gcsfs.GCSFileSystem(token='anon')
     # datastore_json = 'pangeo-cmip6.json'
@@ -64,7 +59,7 @@ def access_cmip6_data(models, pathway, variable):
 
     # convert data catalog into a dictionary of xarray datasets
     dataset_dict = model_search.to_dataset_dict(zarr_kwargs={'consolidated': True, 'decode_times': False})
-    
+
     return dataset_dict
 
 
@@ -84,19 +79,18 @@ def build_accessible_data_list():
     import gcsfs
     import intake
     gcsfs.GCSFileSystem(token='anon')
-    # datastore_json = 'pangeo-cmip6.json'
     esm_data = intake.open_esm_datastore("https://storage.googleapis.com/cmip6/pangeo-cmip6.json")
-    # return esm_data.df['source_id'].unique().tolist()
+    return sorted(esm_data.df['source_id'].unique().tolist())
 
 
 def clear_cmip6_cache():
     """
     Clear all cached CMIP6 data.
-    
+
     This clears location-specific cached data that has been processed and stored
-    for faster repeated access. This is useful for development or when you want 
+    for faster repeated access. This is useful for development or when you want
     to free up disk space.
-    
+
     Examples
     --------
     >>> clear_cmip6_cache()
@@ -107,11 +101,11 @@ def clear_cmip6_cache():
 def get_cmip6_cache_stats():
     """
     Get statistics about the CMIP6 data cache.
-    
+
     Returns information about cache size, number of files, and individual
     file details for development and monitoring purposes. The cache stores
     location-specific processed data.
-    
+
     Returns
     -------
     dict
@@ -122,10 +116,10 @@ def get_cmip6_cache_stats():
         - max_size_mb: Maximum allowed cache size
         - usage_percent: Percentage of max size used
         - files: List of individual file details
-    
+
     Examples
     --------
     >>> stats = get_cmip6_cache_stats()
     >>> print(f"Cache using {stats['total_size_mb']} MB ({stats['usage_percent']}%)")
     """
-    return cache.get_cache_stats()
+    return cache.get_cache_stats()

{pyepwmorph-2.2.0 → pyepwmorph-3.1.0}/pyepwmorph/models/assemble.py

@@ -1,17 +1,14 @@
-# coding=utf-8
 """
 This module creates ensembles from multiple model inputs downloaded for a single pathway and variable.
 This is what enables the slicing of the data from a percentile point of view.
 """
 import pandas as pd
 import xarray as xr
-from pyepwmorph.tools import utilities
-import warnings
 
-warnings.filterwarnings("ignore")
+from pyepwmorph.tools import utilities
 
 __author__ = "Justin McCarty"
-__copyright__ = "Copyright 2023"
+__copyright__ = "Copyright 2023-2026"
 __credits__ = ["Justin McCarty"]
 __license__ = "MIT"
 
@@ -111,4 +108,28 @@ def calc_model_climatologies(baseline_range, future_range, baseline_data, future
     future_means = utilities.monthly_means(future_data).rename(variable)
 
 
-    return baseline_means, future_means
+    return baseline_means, future_means
+
+
+def calc_gwl_climatologies(baseline_data, future_data, variable):
+    """Return CH2025 monthly climatologies unchanged.
+
+    A warming-level state is already a stationary 30-year sample, so there
+    is no year range to slice the way ``calc_model_climatologies`` does for
+    a transient CMIP6 run.
+
+    Parameters
+    ----------
+    baseline_data : pd.Series
+        Twelve monthly values for the reference state.
+    future_data : pd.Series
+        Twelve monthly values for the warming-level state.
+    variable : str
+        Name used to rename both series.
+
+    Returns
+    -------
+    tuple
+        ``(baseline_data, future_data)``, each renamed to *variable*.
+    """
+    return baseline_data.rename(variable), future_data.rename(variable)