transformez 0.2.1__tar.gz → 0.2.2__tar.gz

transformez-0.2.2/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-02-10
+### Added
+
+### Changed
+- Now uses raserio
+- Renamed project to `transformez`.
+- Refactored and decoupled from old cudem.vdatums

transformez-0.2.2/CITATION.cff

@@ -0,0 +1,19 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+authors:
+  - family-names: Love
+    given-names: Matthew
+  - family-names: Amante
+    given-names: Christopher
+  - family-names: MacFerrin
+    given-names: Michael
+  - family-names: Lim
+    given-names: Elliot
+  - family-names: Fisher
+    given-names: Matt
+  
+website: https://ciresdem.github.io/transformez/
+title: "Transformez"
+version: 0.1.0
+date-released: 2026-02-10
+url: "https://github.com/ciresdem/transformez"

{transformez-0.2.1/src/transformez.egg-info → transformez-0.2.2}/PKG-INFO

@@ -1,8 +1,11 @@
 Metadata-Version: 2.4
 Name: transformez
-Version: 0.2.1
+Version: 0.2.2
 Summary: A standalone utility for vertical elevation datum transformations.
-Author: Matthew Love
+Project-URL: Homepage, https://github.com/continuous-dems/transformez
+Project-URL: Issues, https://github.com/continuous-dems/transformez/issues
+Author-email: Matthew Love <matthew.love@colorado.edu>, Christopher Amante <christopher.amante@colorado.edu>, Elliot Lim <elliot.lim@colorado.edu>, Michael MacFerrin <michael.macferrin@colorado.edu>
+Maintainer-email: Matthew Love <matthew.love@colorado.edu>
 License: MIT License
         
         Copyright (c) 2010-2026 Regents of the University of Colorado
@@ -24,21 +27,19 @@ License: MIT License
         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
-Project-URL: Homepage, https://github.com/ciresdem/transformez
-Project-URL: Issues, https://github.com/ciresdem/transformez/issues
+License-File: AUTHORS.md
+License-File: LICENSE
 Keywords: Geospatial
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
 Classifier: Topic :: Scientific/Engineering :: GIS
-Description-Content-Type: text/markdown
-License-File: LICENSE
-License-File: AUTHORS.md
+Requires-Python: >=3.8
+Requires-Dist: fetchez>0.3.3
 Requires-Dist: numpy<2.0.0
 Requires-Dist: pyproj
 Requires-Dist: rasterio
-Requires-Dist: fetchez>0.3.3
-Dynamic: license-file
+Requires-Dist: scipy
+Description-Content-Type: text/markdown
 
 # 🌍 Transformez ↕
 
@@ -124,4 +125,4 @@ shift, unc = vt._vertical_transform(vt.epsg_in, vt.epsg_out)
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](https://github.com/ciresdem/transformez/blob/main/LICENSE) file for details.
-Copyright (c) 2010-2026 Regents of the University of Colorado
+Copyright (c) 2010-2026 Regents of the University of Colorado

transformez-0.2.2/pyproject.toml

@@ -0,0 +1,75 @@
+[build-system]
+requires = ["hatchling>=1.5.0", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = 'transformez'
+description = 'A standalone utility for vertical elevation datum transformations.'
+readme = "README.md"
+requires-python = ">=3.8"
+license = { file = "LICENSE" }
+dynamic = ["version"]
+authors = [
+    {name = "Matthew Love", email = "matthew.love@colorado.edu"},
+    {name = "Christopher Amante", email = "christopher.amante@colorado.edu"},
+    {name = "Elliot Lim", email = "elliot.lim@colorado.edu"},
+    {name = "Michael MacFerrin", email = "michael.macferrin@colorado.edu"},
+]
+maintainers = [
+    {name = "Matthew Love", email = "matthew.love@colorado.edu"},
+]
+classifiers = [
+    'Programming Language :: Python :: 3',
+    'Operating System :: OS Independent',
+    'Topic :: Scientific/Engineering :: GIS',
+]
+dependencies = [
+    'numpy<2.0.0',
+    'pyproj',
+    'rasterio',
+    'fetchez>0.3.3',
+    'scipy',
+]
+
+keywords = ["Geospatial"]
+
+[dependency-groups]
+test = [
+    "pytest",
+    "pytest-cov",
+]
+
+[project.entry-points."fetchez.plugins"]
+transformez = "transformez"
+
+[project.scripts]
+transformez = 'transformez.cli:transformez_cli'
+
+[project.urls]
+Homepage = "https://github.com/continuous-dems/transformez"
+Issues = "https://github.com/continuous-dems/transformez/issues"
+
+# --- Build configuration ---
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.version]
+path = "src/transformez/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/transformez"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "src/transformez",
+  "tests",
+  "CHANGELOG.md",
+  "CITATION.cff",
+  "CONTRIBUTING.md",
+  "AUTHORS.md",
+]
+exclude = [
+  ".github",
+]
+

{transformez-0.2.1 → transformez-0.2.2}/src/transformez/__init__.py

@@ -9,10 +9,26 @@ transformez
 :license: MIT, see LICENSE for more details.
 """
 
-__version__ = "0.2.1"
 __author__ = "Matthew Love"
 __credits__ = "CIRES"
 
+try:
+    from transformez._version import __version__
+except ImportError:
+    # Fallback when using the package from source without installing
+    # in editable mode with pip (nobody should do this):
+    # <https://pip.pypa.io/en/stable/topics/local-project-installs/#editable-installs>
+    import warnings
+
+    warnings.warn(
+        "Importing 'transformez' outside a proper installation."
+        " It's highly recommended to install the package from a stable release or"
+        " in editable mode.",
+        stacklevel=2,
+    )
+    __version__ = "dev"
+
+
 import os
 import glob
 # from .hooks import TransformezHook

transformez-0.2.2/src/transformez/_version.py

@@ -0,0 +1,4 @@
+# This file is auto-generated by Hatchling. As such, do not:
+#   - modify
+#   - track in version control e.g. be sure to add to .gitignore
+__version__ = VERSION = '0.2.2'

{transformez-0.2.1 → transformez-0.2.2}/src/transformez/cli.py

@@ -73,7 +73,7 @@ def list_supported_datums():
 
 def transformez_cli():
     parser = argparse.ArgumentParser(
-        description="Global Vertical Datum Transformer",
+        description=f"{utils.CYAN}%(prog)s{utils.RESET} ({__version__}) :: Global Vertical Datum Transformer",
         epilog="Examples:\n"
                "  transformez -R -166/-164/63/64 -I mllw -O 4979\n"
                "  transformez input_dem.tif -I mllw -O 5703:geoid=g2012b",
@@ -100,6 +100,9 @@ def transformez_cli():
     grp_sys.add_argument('--list-datums', action='store_true', help='List supported datums.')
     grp_sys.add_argument('--cache-dir', help='Override cache directory.')
     grp_sys.add_argument('--verbose', action='store_true', help='Enable debug logging.')
+    grp_sys.add_argument(
+        "-v", "--version", action="version", version=f"%(prog)s {__version__}"
+    )
 
     args = parser.parse_args()
 

transformez-0.2.2/tests/test_cli.py

@@ -0,0 +1,36 @@
+import subprocess
+import sys
+
+# CMD will run Transformez
+CMD = [sys.executable, "-m", "transformez.cli"]
+
+
+def run_transformez(args):
+    """Run transformez and return result."""
+
+    return subprocess.run(CMD + args, capture_output=True, text=True)
+
+
+def test_help():
+    """Does the help menu work?"""
+
+    result = run_transformez(["--help"])
+    assert result.returncode == 0
+
+
+def test_version():
+    """Does version print?"""
+
+    result = run_transformez(["--version"])
+    assert result.returncode == 0
+
+
+def test_list_modules():
+    """Can we list datums without crashing?"""
+
+    result = run_transformez(["--list-datums"])
+    assert result.returncode == 0
+    assert "lat" in result.stdout
+    assert "mllw" in result.stdout
+    assert "NAVD88" in result.stdout
+    assert "g2018" in result.stdout

transformez-0.2.1/PKG-INFO

@@ -1,127 +0,0 @@
-Metadata-Version: 2.4
-Name: transformez
-Version: 0.2.1
-Summary: A standalone utility for vertical elevation datum transformations.
-Author: Matthew Love
-License: MIT License
-        
-        Copyright (c) 2010-2026 Regents of the University of Colorado
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-        SOFTWARE.
-Project-URL: Homepage, https://github.com/ciresdem/transformez
-Project-URL: Issues, https://github.com/ciresdem/transformez/issues
-Keywords: Geospatial
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Scientific/Engineering :: GIS
-Description-Content-Type: text/markdown
-License-File: LICENSE
-License-File: AUTHORS.md
-Requires-Dist: numpy<2.0.0
-Requires-Dist: pyproj
-Requires-Dist: rasterio
-Requires-Dist: fetchez>0.3.3
-Dynamic: license-file
-
-# 🌍 Transformez ↕
-
-**Global vertical datum transformations, simplified.**
-
-*Transformez Les Données*
-
-> 🚀 **v0.2.0:** Now supporting global tidal transformations via FES2014 & SEANOE.
-
-**Transformez** is a standalone Python engine for converting geospatial data between vertical datums (e.g., `MLLW` ↔ `NAVD88` ↔ `Ellipsoid`).
-
----
-
-## Installation
-
-```bash
-pip install transformez
-```
-
-*Requires [htdp](https://geodesy.noaa.gov/TOOLS/Htdp/Htdp.shtml) to be in your system PATH for frame transformations.*
-
-## Usage
-
-**Generate a vertical shift grid for anywhere on Earth.**
-
-```bash
-# Transform MLLW to WGS84 Ellipsoid in Norton Sound, AK
-# (Where NOAA has no coverage!)
-transformez -R -166/-164/63/64 -E 3s \
-    --input-datum mllw \
-    --output-datum 4979 \
-    --output shift_ak.tif
-```
-
-**Transform a raster directly.** Transformez reads the bounds/resolution from the file.
-
-```bash
-transformez --dem input_bathymetry.tif \
-    --input-datum "mllw" \
-    --output-datum "5703:geoid=geoid12b" \
-    --output output_navd88.tif
-```
-
-**Integrate directly into your download pipeline.**
-
-```bash
-# Download GEBCO and shift EGM96 to WGS84 on the fly
-fetchez gebco ... --hook transformez:datum_in=5773,datum_out=4979
-```
-
-## Python API
-
-```python
-from transformez.transform import VerticalTransform
-from fetchez.spatial import Region
-
-# Define a region in India (Bay of Bengal)
-region = Region(80, 85, 10, 15)
-
-# Initialize Transformer
-# Requesting "MLLW" in India triggers the Global Fallback automatically
-vt = VerticalTransform(
-    region=region,
-    nx=1000, ny=1000,
-    epsg_in="mllw",       # Will resolve to FES2014 LAT
-    epsg_out="epsg:4979"  # WGS84 Ellipsoid
-)
-
-# Generate Shift
-shift, unc = vt._vertical_transform(vt.epsg_in, vt.epsg_out)
-```
-
-## Supported Datums
-
-* **Tidal**: mllw, mhhw, msl, lat
-
-* **Ellipsoidal**: 4979 (WGS84), 6319 (NAD83 2011)
-
-* **Orthometric**: 5703 (NAVD88), egm2008, egm96
-
-* **Geoids**: g2018, g2012b, geoid09, xgeoid20b
-
-## License
-
-This project is licensed under the MIT License - see the [LICENSE](https://github.com/ciresdem/transformez/blob/main/LICENSE) file for details.
-Copyright (c) 2010-2026 Regents of the University of Colorado

transformez-0.2.1/pyproject.toml

@@ -1,41 +0,0 @@
-[build-system]
-requires = ['setuptools>=61.0']
-build-backend = 'setuptools.build_meta'
-
-[project]
-name = 'transformez'
-version = '0.2.1'
-description = 'A standalone utility for vertical elevation datum transformations.'
-readme = "README.md"
-authors = [{ name = 'Matthew Love' }]
-license = { file = 'LICENSE' }
-classifiers = [
-    'Programming Language :: Python :: 3',
-    'License :: OSI Approved :: MIT License',
-    'Operating System :: OS Independent',
-    'Topic :: Scientific/Engineering :: GIS',
-]
-dependencies = [
-    'numpy<2.0.0',
-    'pyproj',
-    'rasterio',
-    'fetchez>0.3.3',
-]
-
-keywords = ["Geospatial"]
-
-[project.entry-points."fetchez.plugins"]
-transformez = "transformez"
-
-[project.scripts]
-transformez = 'transformez.cli:transformez_cli'
-
-[project.urls]
-Homepage = "https://github.com/ciresdem/transformez"
-Issues = "https://github.com/ciresdem/transformez/issues"
-
-[tool.setuptools.packages.find]
-where = ["src"]  # Look for packages inside the 'src' folder
-include = ["transformez*"]  # Include the package named 'transformez'
-exclude = ["tests*", "docs*", "scripts*", "examples*"]
-namespaces = false

transformez-0.2.1/setup.cfg

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

transformez-0.2.1/setup.py

@@ -1,2 +0,0 @@
-from setuptools import setup
-setup()

transformez-0.2.1/src/transformez.egg-info/SOURCES.txt

@@ -1,23 +0,0 @@
-AUTHORS.md
-LICENSE
-README.md
-pyproject.toml
-setup.py
-src/transformez/__init__.py
-src/transformez/cli.py
-src/transformez/definitions.py
-src/transformez/grid_engine.py
-src/transformez/hooks.py
-src/transformez/htdp.py
-src/transformez/modules.py
-src/transformez/spatial.py
-src/transformez/srs.py
-src/transformez/transform.py
-src/transformez/utils.py
-src/transformez/vdatum.py
-src/transformez.egg-info/PKG-INFO
-src/transformez.egg-info/SOURCES.txt
-src/transformez.egg-info/dependency_links.txt
-src/transformez.egg-info/entry_points.txt
-src/transformez.egg-info/requires.txt
-src/transformez.egg-info/top_level.txt

transformez-0.2.1/src/transformez.egg-info/dependency_links.txt

@@ -1 +0,0 @@
-

transformez-0.2.1/src/transformez.egg-info/entry_points.txt

@@ -1,5 +0,0 @@
-[console_scripts]
-transformez = transformez.cli:transformez_cli
-
-[fetchez.plugins]
-transformez = transformez

transformez-0.2.1/src/transformez.egg-info/requires.txt

@@ -1,4 +0,0 @@
-numpy<2.0.0
-pyproj
-rasterio
-fetchez>0.3.3

transformez-0.2.1/src/transformez.egg-info/top_level.txt

@@ -1 +0,0 @@
-transformez