lcd-v2-data 1.1.13__tar.gz

lcd_v2_data-1.1.13/LICENSE

@@ -0,0 +1,13 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Jan Kazil
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

lcd_v2_data-1.1.13/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include src/lcd_data/data *

lcd_v2_data-1.1.13/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: lcd-v2-data
+Version: 1.1.13
+Summary: Python toolkit for downloading and processing Local Climatological Data version 2 (LCDv2) data.
+Author: Jan Kazil
+License-Expression: BSD-3-Clause
+Requires-Python: <=3.12.9,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: geopandas
+Requires-Dist: matplotlib
+Requires-Dist: numpy
+Requires-Dist: netcdf4
+Requires-Dist: pandas
+Requires-Dist: requests
+Requires-Dist: shapely
+Requires-Dist: timezonefinder
+Requires-Dist: xarray
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: pytest-cov>=5; extra == "dev"
+Requires-Dist: mypy>=1.11; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: pre-commit>=3.7; extra == "dev"
+Dynamic: license-file
+
+# lcd-v2-data
+
+**lcd-v2-data** is a Python toolkit for downloading and processing [Local Climatological Data version 2 (LCDv2) ](https://www.ncei.noaa.gov/products/land-based-station/local-climatological-data) data.
+
+It provides:
+
+- A top-level command-line tool that
+  
+  - automates the download of LCD v2 station observations for
+    - individual stations
+    - U.S. states and territories
+    - Regional Transmission Organization (RTO) / Independent System Operator (ISO) regions
+    
+  - constructs full-hourly UTC time series of
+    - temperature at 2 m
+    - dew point temperature at 2 m
+    - relative humidity at 2 m
+    - wind speed at 10 m
+  
+    from the irregularly spaced, local time LCD v2 station observation time series, for a selected station or for stations in the selected U.S. state/territory or RTO/ISO region, and a user-specified time range. The time series are saved in a netCDF file.  
+    
+- Modules for downloading and processing LCD v2 station observations.
+
+LCD v2 is provided by the [National Centers for Environmental Information (NCEI)](https://www.ncei.noaa.gov/).
+
+## Installation
+
+```bash
+mamba install -c jan.kazil -c conda-forge lcd-v2-data
+```
+
+## Overview
+
+The package provides a command-line tool that selects stations by geography (a single station by GHCNh identifier, a U.S. state or territory, RTO/ISO regions, and the special region CONUS representing the contiguous U.S.), checks data availability, downloads LCD v2 observation files for a given year range, constructs full-hourly UTC time series for the observables, and saves them in a NetCDF file. It optionally generates plots showing the original and the interpolated time series.
+
+Geospatial region selection is based on U.S. Energy Information Administration definitions of RTO/ISO footprints, and U.S. Census Bureau state/territory boundaries, included with the package.
+
+The list of GHCNh station identifiers is available [here](https://www.ncei.noaa.gov/oa/global-historical-climatology-network/hourly/doc/ghcnh-station-list.txt). LCD v2 contains only U.S. stations.
+
+## Workflow
+
+The following describes the internal workflow performed by the command-line tool:
+
+1. Load the region geometry (RTO/ISO polygons or U.S. state/territory boundaries) if a region is specified; skip this step if a station ID is provided.
+2. Retrieve the station list from NCEI and either filter it spatially by region or select the specified station.
+3. Filter the stations by data availability for the requested year range, either online by probing NCEI or offline by checking local files.
+4. Save the filtered station list for reference.
+5. Download LCD v2 observation files from NCEI for the selected stations and years, skipping files already present that match by ETag.
+6. Create full-hourly UTC time series for temperature (T), dew point temperature (Td), relative humidity (RH), and wind speed by converting local observation time to UTC and interpolating the data to full hours. Remove temperatures above 60 °C. Perform interpolation only across gaps of up to 2 hours. Derive RH from T and Td.
+7. Optionally create comparison plots for the original and interpolated series.
+8. Save the full-hourly UTC time series in a NetCDF file, for the given station or the stations in the state/region.
+
+**Notes:** Interpolation of station observation time series across many years and/or many stations can be slow due to inherent limitations of Python. Creating plots is very slow and recommended only for individual stations (as opposed to regions).
+
+## Command-line interface (CLI)
+
+The CLI is exposed as `"build-lcd-dataset"` when installed.
+
+**Usage:**
+
+```bash
+build-lcd-dataset START_YEAR END_YEAR REGION DATA_DIR [-n N_JOBS] [-o] [-p PLOT_DIR] [-r] [-v]
+```
+
+**Positional arguments**  
+
+- `START_YEAR` and `END_YEAR`: Inclusive range of years  
+- `REGION`: Region or station selector. Use a two-letter U.S. state or territory code, `'CONUS'`, one of the RTO/ISO codes, or a GHCNh station identifier  
+- `DATA_DIR`: Directory into which data will be downloaded  
+
+**Options**  
+
+- `-n, --n N_JOBS`: Number of parallel download processes. Values greater than 1 accelerate downloads but may increase the risk of network errors.  
+- `-o, --offline`: Work offline. All required files must have been downloaded to `DATA_DIR` in a previous call without this flag.  
+- `-p, --plotdir PLOT_DIR`: Directory where plots of the original and interpolated full-hourly time series will be created. Very slow. If omitted, no plots are generated.  
+- `-r, --refresh`: Download and process files even if they already exist in `DATA_DIR`.  
+- `-v, --verbose`: Print progress information.  
+
+**Examples:**
+
+```bash
+# Show usage information, valid region codes, and RTO/ISO region names:
+build-lcd-dataset --help
+
+# Download LCDv2 data and build a dataset as a NetCDF file for station USW00003017 for the years 2020–2025, 
+# in the directory /path/to/data, and create plots in /path/to/plots:
+build-lcd-dataset -v 2020 2025 USW00003017 /path/to/data -p /path/to/plots
+
+# Download LCDv2 data and build a dataset as a NetCDF file for the RTO region ERCOT for the year 2022 
+# in the directory /path/to/data, using 32 parallel download processes:
+build-lcd-dataset -v 2022 2022 ERCOT /path/to/data -n 32
+
+# Build a dataset as a NetCDF file for the state of Colorado for the year 2021, offline from data 
+# previously downloaded to /path/to/data:
+build-lcd-dataset -v 2021 2021 CO /path/to/data --offline
+```
+
+## Sample results
+
+Original and interpolated full-hourly UTC time series in November 2024, Twentynine Palms, CA:
+
+![LCD station USL000ANVC1 time series, December 2024](plots/USW00093121.Nov-2024.png)  
+
+## Public API
+
+### Modules
+
+#### `lcd_data.build_lcd_dataset`
+
+Provides a programmatic API equivalent to the command-line interface for building LCD datasets from NOAA NCEI observations.
+
+- `run_build(start_year, end_year, region_name, data_dir, plot_dir=None, n_jobs=1, offline=False, refresh=False, verbose=False)`:  
+  
+  Downloads, processes, and assembles NOAA NCEI Local Climatological Data (LCD) into a NetCDF file containing full-hourly UTC time series for a specified geographic region or individual station over an inclusive range of years.  
+  Operates both online (with automatic downloads) and offline (using pre-downloaded files).  
+  If `plot_dir` is provided, diagnostic plots of original and interpolated time series are generated.  
+  Returns the `Path` to the generated NetCDF file.
+
+#### `lcd_data.ncei`
+Utilities for station metadata and LCD v2 downloads.
+
+- `download_stations_meta_files(local_dir)`: Download GHCNh and LCD v2 station meta documents.
+- `lcd_data_file_name(year, station_id)`: Construct LCD v2 observation file name.
+- `lcd_data_file_paths(start_year, end_year, station_ids, local_dir)`: Build local paths for all expected files.
+- `lcd_data_url(year, station_id)`: Build the absolute URL to an LCD v2 observation file.
+- `lcd_data_urls(station_ids, start_year, end_year, n_jobs)`: Probe NCEI server to list existing files.
+- `download_many(...)` and `download_threaded(...)`: Concurrent file downloads with optional refresh behavior.
+- `download_file(url, local_dir, refresh=False, verbose=False)`: Robust download with ETag checking and retries.
+
+#### `lcd_data.rto_iso`
+Helpers to work with RTO/ISO region polygons.
+
+- `REGION_NAMES`: `['CAISO', 'ERCOT', 'ISONE', 'NYISO', 'MISO', 'PJM', 'SPP']`.
+- `regions(rto_iso_geojson)`: Read GeoJSON and return a GeoDataFrame with merged geometries for each region.
+- `region(rto_iso_geojson, region_name)`: Return a GeoDataFrame for the requested region.
+
+#### `lcd_data.saturation`
+Saturation vapor pressure and relative humidity utilities.
+
+- `esatw(T)`: Saturation vapor pressure over liquid water (hPa) using an 8th‑order polynomial fit.
+- `rh(T, Td)`: Relative humidity (%) computed from temperature and dew point.
+
+#### `lcd_data.region_codes`
+Provides
+
+  - `lcd_data.region_codes.countries`: Three-letter ISO 3166-1 alpha-3 country codes
+  - `lcd_data.region_codes.us_states_territories`: Two-letter U.S. state or territory codes
+  - `lcd_data.region_codes.conus`: The special `CONUS` region code
+  - `lcd_data.region_codes.rto_iso_regions`: RTO/ISO region codes
+
+#### `lcd_data.stations`
+Station catalog handling, filtering, reading, interpolation, and writing.
+
+- `Stations.from_url()` / `Stations.from_file(path)`: Build the station catalog from GHCNh-format metadata.
+- Spatial selection by region geometry with `filter_by_region(region_gdf)` and by bounding box with `filter_by_coordinates(...)`.
+- Availability filters: `filter_by_data_availability_online(start_time, end_time, n_jobs, verbose)` and `filter_by_data_availability_offline(data_dir, start_time, end_time, verbose)`.
+- Station utilities: `filter_by_id(station_id)`, `ids()`, `save_station_list(path)`.
+- `read_station_observations(...)`: Read and clean per‑station LCD v2 observation files; convert times to UTC, coerce numeric columns, correct Celsius-with-18.3° base fields, drop non-observational report types, limit unrealistic temperatures, and compute hourly RH.
+- `construct_hourly(...)`: Build full-hourly UTC series for `T`, `Td`, `RH`, and `windspeed`, with optional plotting and gap-limited interpolation.
+- `write_utc_hourly_netcdf(path)`: Save the hourly dataset to NetCDF with safe encodings.
+
+## Development
+
+### Code Quality and Testing Commands
+
+- `make fmt` - Runs ruff format, which automatically reformats Python files according to the style rules in `pyproject.toml`
+- `make lint` - Runs ruff check - -fix, which lints the code (checks for style errors, bugs, outdated patterns, etc.) and auto-fixes what it can.
+- `make check` - Runs fmt and lint.
+- `make type` - Currently disabled. Runs mypy, the static type checker, using the strictness settings from `pyproject.toml`. Mypy is a static type checker for Python, a dynamically typed language. Because static analysis cannot account for all dynamic runtime behaviors, mypy may report false positives which do not reflect actual runtime issues.
+- `make test` - Runs pytest with reporting (configured in `pyproject.toml`).
+
+## Disclaimers
+
+The LCD v2 data accessed by this software are publicly available from NOAA's National Centers for Environmental Information (NCEI) and are subject to their terms of use. This project is not affiliated with or endorsed by NOAA.
+
+This software uses U.S. Census Bureau and U.S. Energy Information Administration data, but is neither endorsed nor certified by the U.S. Census Bureau or the U.S. Energy Information Administration.
+
+## Author
+
+Jan Kazil - jan.kazil.dev@gmail.com - [jankazil.com](https://jankazil.com)
+
+## License
+
+BSD-3-Clause

lcd_v2_data-1.1.13/README.md

@@ -0,0 +1,184 @@
+# lcd-v2-data
+
+**lcd-v2-data** is a Python toolkit for downloading and processing [Local Climatological Data version 2 (LCDv2) ](https://www.ncei.noaa.gov/products/land-based-station/local-climatological-data) data.
+
+It provides:
+
+- A top-level command-line tool that
+  
+  - automates the download of LCD v2 station observations for
+    - individual stations
+    - U.S. states and territories
+    - Regional Transmission Organization (RTO) / Independent System Operator (ISO) regions
+    
+  - constructs full-hourly UTC time series of
+    - temperature at 2 m
+    - dew point temperature at 2 m
+    - relative humidity at 2 m
+    - wind speed at 10 m
+  
+    from the irregularly spaced, local time LCD v2 station observation time series, for a selected station or for stations in the selected U.S. state/territory or RTO/ISO region, and a user-specified time range. The time series are saved in a netCDF file.  
+    
+- Modules for downloading and processing LCD v2 station observations.
+
+LCD v2 is provided by the [National Centers for Environmental Information (NCEI)](https://www.ncei.noaa.gov/).
+
+## Installation
+
+```bash
+mamba install -c jan.kazil -c conda-forge lcd-v2-data
+```
+
+## Overview
+
+The package provides a command-line tool that selects stations by geography (a single station by GHCNh identifier, a U.S. state or territory, RTO/ISO regions, and the special region CONUS representing the contiguous U.S.), checks data availability, downloads LCD v2 observation files for a given year range, constructs full-hourly UTC time series for the observables, and saves them in a NetCDF file. It optionally generates plots showing the original and the interpolated time series.
+
+Geospatial region selection is based on U.S. Energy Information Administration definitions of RTO/ISO footprints, and U.S. Census Bureau state/territory boundaries, included with the package.
+
+The list of GHCNh station identifiers is available [here](https://www.ncei.noaa.gov/oa/global-historical-climatology-network/hourly/doc/ghcnh-station-list.txt). LCD v2 contains only U.S. stations.
+
+## Workflow
+
+The following describes the internal workflow performed by the command-line tool:
+
+1. Load the region geometry (RTO/ISO polygons or U.S. state/territory boundaries) if a region is specified; skip this step if a station ID is provided.
+2. Retrieve the station list from NCEI and either filter it spatially by region or select the specified station.
+3. Filter the stations by data availability for the requested year range, either online by probing NCEI or offline by checking local files.
+4. Save the filtered station list for reference.
+5. Download LCD v2 observation files from NCEI for the selected stations and years, skipping files already present that match by ETag.
+6. Create full-hourly UTC time series for temperature (T), dew point temperature (Td), relative humidity (RH), and wind speed by converting local observation time to UTC and interpolating the data to full hours. Remove temperatures above 60 °C. Perform interpolation only across gaps of up to 2 hours. Derive RH from T and Td.
+7. Optionally create comparison plots for the original and interpolated series.
+8. Save the full-hourly UTC time series in a NetCDF file, for the given station or the stations in the state/region.
+
+**Notes:** Interpolation of station observation time series across many years and/or many stations can be slow due to inherent limitations of Python. Creating plots is very slow and recommended only for individual stations (as opposed to regions).
+
+## Command-line interface (CLI)
+
+The CLI is exposed as `"build-lcd-dataset"` when installed.
+
+**Usage:**
+
+```bash
+build-lcd-dataset START_YEAR END_YEAR REGION DATA_DIR [-n N_JOBS] [-o] [-p PLOT_DIR] [-r] [-v]
+```
+
+**Positional arguments**  
+
+- `START_YEAR` and `END_YEAR`: Inclusive range of years  
+- `REGION`: Region or station selector. Use a two-letter U.S. state or territory code, `'CONUS'`, one of the RTO/ISO codes, or a GHCNh station identifier  
+- `DATA_DIR`: Directory into which data will be downloaded  
+
+**Options**  
+
+- `-n, --n N_JOBS`: Number of parallel download processes. Values greater than 1 accelerate downloads but may increase the risk of network errors.  
+- `-o, --offline`: Work offline. All required files must have been downloaded to `DATA_DIR` in a previous call without this flag.  
+- `-p, --plotdir PLOT_DIR`: Directory where plots of the original and interpolated full-hourly time series will be created. Very slow. If omitted, no plots are generated.  
+- `-r, --refresh`: Download and process files even if they already exist in `DATA_DIR`.  
+- `-v, --verbose`: Print progress information.  
+
+**Examples:**
+
+```bash
+# Show usage information, valid region codes, and RTO/ISO region names:
+build-lcd-dataset --help
+
+# Download LCDv2 data and build a dataset as a NetCDF file for station USW00003017 for the years 2020–2025, 
+# in the directory /path/to/data, and create plots in /path/to/plots:
+build-lcd-dataset -v 2020 2025 USW00003017 /path/to/data -p /path/to/plots
+
+# Download LCDv2 data and build a dataset as a NetCDF file for the RTO region ERCOT for the year 2022 
+# in the directory /path/to/data, using 32 parallel download processes:
+build-lcd-dataset -v 2022 2022 ERCOT /path/to/data -n 32
+
+# Build a dataset as a NetCDF file for the state of Colorado for the year 2021, offline from data 
+# previously downloaded to /path/to/data:
+build-lcd-dataset -v 2021 2021 CO /path/to/data --offline
+```
+
+## Sample results
+
+Original and interpolated full-hourly UTC time series in November 2024, Twentynine Palms, CA:
+
+![LCD station USL000ANVC1 time series, December 2024](plots/USW00093121.Nov-2024.png)  
+
+## Public API
+
+### Modules
+
+#### `lcd_data.build_lcd_dataset`
+
+Provides a programmatic API equivalent to the command-line interface for building LCD datasets from NOAA NCEI observations.
+
+- `run_build(start_year, end_year, region_name, data_dir, plot_dir=None, n_jobs=1, offline=False, refresh=False, verbose=False)`:  
+  
+  Downloads, processes, and assembles NOAA NCEI Local Climatological Data (LCD) into a NetCDF file containing full-hourly UTC time series for a specified geographic region or individual station over an inclusive range of years.  
+  Operates both online (with automatic downloads) and offline (using pre-downloaded files).  
+  If `plot_dir` is provided, diagnostic plots of original and interpolated time series are generated.  
+  Returns the `Path` to the generated NetCDF file.
+
+#### `lcd_data.ncei`
+Utilities for station metadata and LCD v2 downloads.
+
+- `download_stations_meta_files(local_dir)`: Download GHCNh and LCD v2 station meta documents.
+- `lcd_data_file_name(year, station_id)`: Construct LCD v2 observation file name.
+- `lcd_data_file_paths(start_year, end_year, station_ids, local_dir)`: Build local paths for all expected files.
+- `lcd_data_url(year, station_id)`: Build the absolute URL to an LCD v2 observation file.
+- `lcd_data_urls(station_ids, start_year, end_year, n_jobs)`: Probe NCEI server to list existing files.
+- `download_many(...)` and `download_threaded(...)`: Concurrent file downloads with optional refresh behavior.
+- `download_file(url, local_dir, refresh=False, verbose=False)`: Robust download with ETag checking and retries.
+
+#### `lcd_data.rto_iso`
+Helpers to work with RTO/ISO region polygons.
+
+- `REGION_NAMES`: `['CAISO', 'ERCOT', 'ISONE', 'NYISO', 'MISO', 'PJM', 'SPP']`.
+- `regions(rto_iso_geojson)`: Read GeoJSON and return a GeoDataFrame with merged geometries for each region.
+- `region(rto_iso_geojson, region_name)`: Return a GeoDataFrame for the requested region.
+
+#### `lcd_data.saturation`
+Saturation vapor pressure and relative humidity utilities.
+
+- `esatw(T)`: Saturation vapor pressure over liquid water (hPa) using an 8th‑order polynomial fit.
+- `rh(T, Td)`: Relative humidity (%) computed from temperature and dew point.
+
+#### `lcd_data.region_codes`
+Provides
+
+  - `lcd_data.region_codes.countries`: Three-letter ISO 3166-1 alpha-3 country codes
+  - `lcd_data.region_codes.us_states_territories`: Two-letter U.S. state or territory codes
+  - `lcd_data.region_codes.conus`: The special `CONUS` region code
+  - `lcd_data.region_codes.rto_iso_regions`: RTO/ISO region codes
+
+#### `lcd_data.stations`
+Station catalog handling, filtering, reading, interpolation, and writing.
+
+- `Stations.from_url()` / `Stations.from_file(path)`: Build the station catalog from GHCNh-format metadata.
+- Spatial selection by region geometry with `filter_by_region(region_gdf)` and by bounding box with `filter_by_coordinates(...)`.
+- Availability filters: `filter_by_data_availability_online(start_time, end_time, n_jobs, verbose)` and `filter_by_data_availability_offline(data_dir, start_time, end_time, verbose)`.
+- Station utilities: `filter_by_id(station_id)`, `ids()`, `save_station_list(path)`.
+- `read_station_observations(...)`: Read and clean per‑station LCD v2 observation files; convert times to UTC, coerce numeric columns, correct Celsius-with-18.3° base fields, drop non-observational report types, limit unrealistic temperatures, and compute hourly RH.
+- `construct_hourly(...)`: Build full-hourly UTC series for `T`, `Td`, `RH`, and `windspeed`, with optional plotting and gap-limited interpolation.
+- `write_utc_hourly_netcdf(path)`: Save the hourly dataset to NetCDF with safe encodings.
+
+## Development
+
+### Code Quality and Testing Commands
+
+- `make fmt` - Runs ruff format, which automatically reformats Python files according to the style rules in `pyproject.toml`
+- `make lint` - Runs ruff check - -fix, which lints the code (checks for style errors, bugs, outdated patterns, etc.) and auto-fixes what it can.
+- `make check` - Runs fmt and lint.
+- `make type` - Currently disabled. Runs mypy, the static type checker, using the strictness settings from `pyproject.toml`. Mypy is a static type checker for Python, a dynamically typed language. Because static analysis cannot account for all dynamic runtime behaviors, mypy may report false positives which do not reflect actual runtime issues.
+- `make test` - Runs pytest with reporting (configured in `pyproject.toml`).
+
+## Disclaimers
+
+The LCD v2 data accessed by this software are publicly available from NOAA's National Centers for Environmental Information (NCEI) and are subject to their terms of use. This project is not affiliated with or endorsed by NOAA.
+
+This software uses U.S. Census Bureau and U.S. Energy Information Administration data, but is neither endorsed nor certified by the U.S. Census Bureau or the U.S. Energy Information Administration.
+
+## Author
+
+Jan Kazil - jan.kazil.dev@gmail.com - [jankazil.com](https://jankazil.com)
+
+## License
+
+BSD-3-Clause

lcd_v2_data-1.1.13/pyproject.toml

@@ -0,0 +1,94 @@
+[build-system]
+requires = ["setuptools>=77", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lcd-v2-data"
+version = "1.1.13"
+description = "Python toolkit for downloading and processing Local Climatological Data version 2 (LCDv2) data."
+readme = "README.md"
+requires-python = ">=3.11,<=3.12.9"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+authors = [{ name = "Jan Kazil" }]
+dependencies = [
+  "geopandas",
+  "matplotlib",
+  "numpy",
+  "netcdf4",
+  "pandas",
+  "requests",
+  "shapely",
+  "timezonefinder",
+  "xarray",
+]
+
+[project.scripts]
+build-lcd-dataset = "lcd_data.build_lcd_dataset:main" # Connects name of executable in $PATH to the python module containing main()
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8",
+  "pytest-cov>=5",
+  "mypy>=1.11",
+  "ruff>=0.5",
+  "pre-commit>=3.7",
+]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+# Ensure non-Python assets ship inside the wheel/sdist
+[tool.setuptools.package-data]
+lcd_data = [
+    "data/EIA/*.geojson",
+    "data/CensusBureau/US_states/*",
+]
+
+[tool.ruff]
+line-length = 128
+target-version = "py313"
+extend-exclude = [
+    "dist",
+    "build",
+    "data",
+    "demos",
+    "docs",
+    "experiments",
+    "notebooks",
+    "plots",
+    "results",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+ignore = ["E501", "F841", "SIM108"]
+
+[tool.ruff.format]
+quote-style = "preserve"
+
+#
+# MyPy is disabled because static analysis cannot account for all
+# dynamic runtime behaviors, mypy may report false positives which
+# do no reflect actual runtime issues.
+#
+#[tool.mypy]
+#python_version = "3.11"
+#warn_unused_configs = true
+#disallow_untyped_defs = true
+#disallow_incomplete_defs = true
+#no_implicit_optional = true
+#check_untyped_defs = true
+#strict_optional = true
+#pretty = true
+#namespace_packages = true
+#mypy_path = "src"
+#files = ["src/lcd_data", "scripts"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]

lcd_v2_data-1.1.13/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lcd_v2_data-1.1.13/src/lcd_data/__init__.py

@@ -0,0 +1,16 @@
+from importlib.metadata import PackageNotFoundError, version
+
+# Distribution name as published (matches [project].name in pyproject.toml)
+_DIST_NAME = "lcd-data"
+
+try:
+    __version__ = version(_DIST_NAME)
+except PackageNotFoundError:
+    # Fallback to import package name; if still not installed, use local tag
+    pkg = __package__ or __name__.split(".", 1)[0]
+    try:
+        __version__ = version(pkg)
+    except PackageNotFoundError:
+        __version__ = "0.0.0+local"
+
+__all__ = ["__version__"]