pyepwmorph 3.3.0__tar.gz → 3.4.0__tar.gz

{pyepwmorph-3.3.0 → pyepwmorph-3.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyepwmorph
-Version: 3.3.0
+Version: 3.4.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
@@ -154,26 +154,12 @@ CH2025 data: MeteoSwiss & ETH Zurich (2025), Climate CH2025 - Daily Datasets, CC
 
 ### Measured data (actual meteorological year)
 
-Turn one real year of station measurements, hourly or 10-minute, into an EPW
-for calibration. The table needs fixed column names and hour-ending
-timestamps; `pyepwmorph.tools.amy.describe_columns()` lists them.
-
-```python
-from pyepwmorph.tools import amy, amy_meteoswiss
-
-table = amy_meteoswiss.read_meteoswiss_ogd("ogd-smn_sma_t_historical_2020-2029.csv")  # UTC, hour-ending
-location = amy_meteoswiss.meteoswiss_location("ogd-smn_meta_stations.csv", "SMA")
-report = amy.station_table_to_epw(
-    table, location, 2025, "zurich_fluntern_2025.epw",
-    source_name="MeteoSwiss Zurich-Fluntern", attribution=amy_meteoswiss.ATTRIBUTION,
-)
-print(report.to_text())
-```
-
-Other networks only need a table with the documented columns and
-`timestamp_label` / `table_utc_offset` set to match their clock. Direct and
-diffuse irradiance and sky cover are derived when the station does not measure
-them (the report and the EPW header say how).
+Moved to [weather-file-builder](https://github.com/justinfmccarty/weather_file_builder)
+(2.1 and later), together with ISO 15927-4 typical years from station data:
+`weather_file_builder.amy.station_table_to_epw` and
+`weather_file_builder.station_tmy.station_table_to_tmy_epw`.
+`pyepwmorph.tools.amy` still works in 3.4 but warns on import and will be
+removed in 4.0.
 
 ## Climate scenarios
 

{pyepwmorph-3.3.0 → pyepwmorph-3.4.0}/README.md

@@ -115,26 +115,12 @@ CH2025 data: MeteoSwiss & ETH Zurich (2025), Climate CH2025 - Daily Datasets, CC
 
 ### Measured data (actual meteorological year)
 
-Turn one real year of station measurements, hourly or 10-minute, into an EPW
-for calibration. The table needs fixed column names and hour-ending
-timestamps; `pyepwmorph.tools.amy.describe_columns()` lists them.
-
-```python
-from pyepwmorph.tools import amy, amy_meteoswiss
-
-table = amy_meteoswiss.read_meteoswiss_ogd("ogd-smn_sma_t_historical_2020-2029.csv")  # UTC, hour-ending
-location = amy_meteoswiss.meteoswiss_location("ogd-smn_meta_stations.csv", "SMA")
-report = amy.station_table_to_epw(
-    table, location, 2025, "zurich_fluntern_2025.epw",
-    source_name="MeteoSwiss Zurich-Fluntern", attribution=amy_meteoswiss.ATTRIBUTION,
-)
-print(report.to_text())
-```
-
-Other networks only need a table with the documented columns and
-`timestamp_label` / `table_utc_offset` set to match their clock. Direct and
-diffuse irradiance and sky cover are derived when the station does not measure
-them (the report and the EPW header say how).
+Moved to [weather-file-builder](https://github.com/justinfmccarty/weather_file_builder)
+(2.1 and later), together with ISO 15927-4 typical years from station data:
+`weather_file_builder.amy.station_table_to_epw` and
+`weather_file_builder.station_tmy.station_table_to_tmy_epw`.
+`pyepwmorph.tools.amy` still works in 3.4 but warns on import and will be
+removed in 4.0.
 
 ## Climate scenarios
 

{pyepwmorph-3.3.0 → pyepwmorph-3.4.0}/pyepwmorph/tools/amy.py

@@ -1,5 +1,9 @@
 """Build an EPW from measured weather station data (an actual meteorological year).
 
+.. deprecated:: 3.4.0
+   Moved to ``weather_file_builder.amy`` (weather-file-builder 2.1). This
+   copy is frozen and will be removed in pyepwmorph 4.0.
+
 A typical meteorological year stitches months from many years. An *actual*
 meteorological year (AMY) is one real calendar year of measurements, which is
 what building energy model calibration needs. This module turns a table of
@@ -72,6 +76,7 @@ Short gaps are interpolated and long gaps raise an error (see
 import datetime as _dt
 import logging
 import unicodedata
+import warnings as _warnings
 from dataclasses import dataclass, field
 from functools import lru_cache
 from importlib.resources import files
@@ -84,6 +89,14 @@ import pvlib
 from pyepwmorph.tools import psychrometrics
 from pyepwmorph.tools.io import EPW_COLUMN_NAMES
 
+_warnings.warn(
+    "pyepwmorph.tools.amy is deprecated and will be removed in pyepwmorph 4.0. "
+    "It has moved to weather-file-builder (pip install 'weather-file-builder>=2.1'): "
+    "use weather_file_builder.amy.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
 logger = logging.getLogger(__name__)
 
 #: Column contract. ``agg`` is how sub-hourly values become hourly values.

{pyepwmorph-3.3.0 → pyepwmorph-3.4.0}/pyepwmorph/tools/amy_meteoswiss.py

@@ -1,5 +1,8 @@
 """MeteoSwiss open data (ogd-smn) adapter for :mod:`pyepwmorph.tools.amy`.
 
+.. deprecated:: 3.4.0
+   Moved to ``weather_file_builder.amy_meteoswiss``. Removed in pyepwmorph 4.0.
+
 Reads the automatic station files that MeteoSwiss publishes at
 https://opendatadocs.meteoswiss.ch/ (10-minute ``..._t_...`` and hourly
 ``..._h_...`` CSVs, semicolon separated) and renames their parameter codes to
@@ -15,10 +18,19 @@ attribution wording).
 """
 
 import logging
+import warnings as _warnings
 from typing import Optional
 
 import pandas as pd
 
+_warnings.warn(
+    "pyepwmorph.tools.amy_meteoswiss is deprecated and will be removed in pyepwmorph 4.0. "
+    "It has moved to weather-file-builder (pip install 'weather-file-builder>=2.1'): "
+    "use weather_file_builder.amy_meteoswiss.",
+    DeprecationWarning,
+    stacklevel=2,
+)
+
 logger = logging.getLogger(__name__)
 
 #: Attribution line for the EPW header.

{pyepwmorph-3.3.0 → pyepwmorph-3.4.0}/pyproject.toml

@@ -17,7 +17,7 @@ core-metadata-version = "2.4"
 
 [project]
 name = "pyepwmorph"
-version = "3.3.0"
+version = "3.4.0"
 authors = [
   { name="Justin McCarty", email="mccarty.justin.f@gmail.com" },
 ]