coordshift 0.1.0__tar.gz

coordshift-0.1.0/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+This project follows [Semantic Versioning](https://semver.org/).
+
+---
+
+## [Unreleased]
+
+---
+
+## [0.1.0] - 2026-03-28
+
+Initial alpha release.
+
+> **Alpha software.** Always verify converted coordinates against a trusted independent source.
+> The authors provide no warranty and accept no liability for errors in conversion results.
+
+### Added
+
+**Python library**
+
+- `coordshift.core.convert()` — reads a CSV, reprojects coordinate columns, and returns a pandas DataFrame. Supports in-place replacement or new columns via `suffix`.
+- `coordshift.core.transform_points()` — low-level list-to-list coordinate transform using `pyproj.Transformer` with `always_xy=True`.
+- `coordshift.crs.resolve_crs()` — resolves EPSG codes, PROJ strings, and friendly preset names to a canonical CRS string.
+- `coordshift.crs.search_crs()` — searches the preset catalog by keyword.
+- `coordshift.crs.CRSError` — custom exception for unresolvable CRS inputs.
+- `coordshift.io.read_csv()` / `write_csv()` — thin wrappers around pandas CSV I/O.
+- `coordshift.io.detect_columns()` — auto-detects X/Y columns from common name patterns (lon, lat, easting, northing, x, y, etc.).
+- `coordshift.presets.PRESETS` — built-in catalog of friendly name → EPSG mappings: WGS84, NAD83, Indiana East/West, Iowa North, Arizona East/Central/West, UTM zones 15–17N, Web Mercator.
+
+**CLI** (`coordshift` entry point)
+
+- `coordshift convert` — convert a CSV file from one CRS to another.
+- `coordshift search` — search presets by keyword.
+- `coordshift list-crs` — list all built-in presets.
+- UTF-8 console output on Windows.
+- Progress indication for large files (>10k rows).
+
+**Browser app**
+
+- `coordshift.html` — standalone single-file browser-based converter.
+  - CSV upload with automatic column detection.
+  - CRS search across a full NAD83(2011) State Plane, UTM, and geographic catalog.
+  - In-browser reprojection via proj4js (no server required, works offline).
+  - Leaflet map preview of converted points.
+  - CSV download.
+
+**Developer tooling**
+
+- `scripts/gen_nad83_2011_spcs_js.py` — fetches and formats the NAD83(2011) SPCS catalog as JSON.
+- `scripts/merge_spcs_into_index.py` — embeds the generated JSON catalog into `coordshift.html`.
+
+### Design notes
+
+- Original X/Y columns are always preserved in output. Converted values are written to new columns placed immediately after the originals (e.g. `lon` → `lon_converted`, `lat` → `lat_converted`).
+- `--suffix` / `suffix=` controls the appended column name suffix; default is `_converted`.
+- Same behaviour applies in `coordshift.html`: converted columns appear right after the originals in the downloaded CSV.

coordshift-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nick Fulton
+
+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.

coordshift-0.1.0/MANIFEST.in

@@ -0,0 +1,14 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+recursive-include docs *.md
+recursive-include tests *.py *.csv
+prune venv
+prune dist
+prune .git
+prune scripts
+prune coordshift.egg-info
+global-exclude *.pyc
+global-exclude __pycache__
+global-exclude .DS_Store
+global-exclude *.egg-info

coordshift-0.1.0/PKG-INFO

@@ -0,0 +1,242 @@
+Metadata-Version: 2.4
+Name: coordshift
+Version: 0.1.0
+Summary: Universal coordinate system conversion for CSV and tabular data
+Author: Nick Fulton
+License-Expression: MIT
+Keywords: gis,coordinates,crs,projection,epsg,pyproj,survey,gnss
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyproj>=3.5
+Requires-Dist: pandas>=2.0
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: twine>=4.0; extra == "dev"
+Dynamic: license-file
+
+# coordshift
+
+> **⚠ Alpha software — use with caution**
+>
+> coordshift is in early development (pre-v1.0). APIs and output formats may change without notice.
+> **Always verify converted coordinates against a trusted independent source before using them in any survey, legal, safety-critical, or production workflow.**
+> The authors provide no warranty and accept no liability for errors in coordinate conversion results. Use at your own risk.
+
+Universal coordinate system conversion for CSV and tabular data — built for GIS analysts, surveyors, and drone mapping workflows.
+
+## What it does
+
+`coordshift` reprojects coordinate columns in CSV files from one CRS to another, using any system supported by PROJ. It ships as both a command-line tool and a Python library, plus a standalone browser-based converter (`coordshift.html`) that works entirely offline.
+
+**CLI**
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --x lon --y lat
+```
+
+**Python**
+
+```python
+from coordshift import convert
+
+df = convert("input.csv", from_crs="EPSG:4326", to_crs="EPSG:2965", x="lon", y="lat")
+```
+
+**Browser**
+
+Open `coordshift.html` in any modern browser — no install required.
+
+## Why this exists
+
+Tools like cs2cs, ogr2ogr, and raw pyproj are powerful but assume you already speak PROJ. `coordshift` targets practitioners who need fast, repeatable conversions without wrestling with syntax.
+
+## What's included
+
+- Convert any EPSG/PROJ CRS to any other
+- Auto-detect common column names (lat, lon, x, y, easting, northing, etc.)
+- Source and target CRS via EPSG code, PROJ string, or friendly preset name
+- Preserve all columns in output — original X/Y columns are always kept
+- Converted coordinates written to new columns placed immediately after the originals
+- Customisable output column suffix (default `_converted`, e.g. `lon_converted`, `lat_converted`)
+- CLI for one-off conversions
+- Python API for scripting and pipelines
+- Browser-based converter (`coordshift.html`) with map preview — works offline
+
+## Planned
+
+- Vertical coordinate support (ellipsoidal ↔ orthometric, GEOID)
+- Batch conversion across multiple files
+- Output to GeoJSON or Shapefile
+
+## Installation
+
+Install from source until the first PyPI release:
+
+```bash
+git clone https://github.com/FultonGeo/coordshift.git
+cd coordshift
+pip install -e .
+```
+
+Or, once published:
+
+```bash
+pip install coordshift
+```
+
+## Usage
+
+### CLI
+
+Basic conversion (original `lon`/`lat` columns are preserved; converted values go into `lon_converted`/`lat_converted` placed right after them):
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --x lon --y lat
+```
+
+With output path:
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --x lon --y lat --out output.csv
+```
+
+Custom column name suffix (produces `lon_proj`, `lat_proj` instead of the default `lon_converted`, `lat_converted`):
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --suffix _proj
+```
+
+PROJ strings (use a single line on Windows, or wrap as your shell allows):
+
+```bash
+coordshift convert input.csv \
+  --from "+proj=longlat +datum=WGS84" \
+  --to "+proj=tmerc +lat_0=37.5 +lon_0=-85.66666667 +k=0.999966667 +x_0=100000 +y_0=250000 +ellps=GRS80" \
+  --x longitude --y latitude
+```
+
+List presets and search CRS:
+
+```bash
+coordshift list-crs
+coordshift search "indiana east"
+```
+
+### Python API
+
+```python
+from coordshift import convert, search_crs
+
+df = convert(
+    "field_points.csv",
+    from_crs="EPSG:4326",
+    to_crs="EPSG:2965",
+    x="lon",
+    y="lat",
+)
+# df now has lon, lon_converted, lat, lat_converted (plus any other original columns)
+df.to_csv("field_points_converted.csv", index=False)
+
+results = search_crs("indiana east")
+```
+
+See [docs/examples.md](docs/examples.md) for more detailed examples.
+
+### Browser app
+
+Open `coordshift.html` in any modern browser (Chrome, Firefox, Edge, Safari). No server or internet connection required after the page loads. Features include:
+
+- Upload a CSV and pick coordinate columns
+- Search and select source/target CRS from a built-in catalog of State Plane zones, UTM, and common geographic systems
+- Preview converted points on an interactive map
+- Download the converted CSV
+
+## Project structure
+
+```text
+coordshift/
+├── coordshift/         # Python package
+│   ├── __init__.py    # Public API
+│   ├── core.py        # Conversion (pyproj)
+│   ├── cli.py         # CLI (Click)
+│   ├── io.py          # CSV I/O, column detection
+│   ├── crs.py         # CRS resolution
+│   └── presets.py     # Friendly name → EPSG
+├── tests/
+│   ├── test_core.py
+│   ├── test_cli.py
+│   ├── test_io.py
+│   └── fixtures/
+├── docs/
+│   └── examples.md
+├── scripts/           # Developer tooling (regenerate HTML catalog)
+├── coordshift.html    # Standalone browser-based converter
+├── pyproject.toml
+├── README.md
+└── LICENSE
+```
+
+## Development setup
+
+```bash
+git clone https://github.com/FultonGeo/coordshift.git
+cd coordshift
+python -m venv venv
+```
+
+Activate the virtual environment:
+
+- **Windows (PowerShell):** `.\venv\Scripts\Activate.ps1`
+- **macOS / Linux:** `source venv/bin/activate`
+
+Then:
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+Run the linter:
+
+```bash
+ruff check coordshift/
+```
+
+## Dependencies
+
+- [pyproj](https://pyproj4.github.io/pyproj/) — PROJ bindings
+- [pandas](https://pandas.pydata.org/) — tabular data
+- [click](https://click.palletsprojects.com/) — CLI
+
+## Contributing
+
+Contributions welcome. Open an issue before large changes so direction stays aligned.
+
+1. Fork the repo
+2. Create a branch: `git checkout -b feature/my-feature`
+3. Commit and push
+4. Open a pull request
+
+## Disclaimer
+
+coordshift is alpha software provided **as-is**, without warranty of any kind, express or implied. Coordinate conversion results depend on the accuracy of the underlying PROJ library, the correctness of the CRS definitions used, and the quality of the input data. Always double-check converted coordinates against an authoritative source before using them in any survey, engineering, legal, or safety-critical context. The authors and contributors are not responsible for errors, losses, or damages arising from the use of this software.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Author
+
+Nick Fulton — geospatial work, FAA Part 107, drone and survey experience.
+
+Repository: [FultonGeo/coordshift](https://github.com/FultonGeo/coordshift).

coordshift-0.1.0/README.md

@@ -0,0 +1,216 @@
+# coordshift
+
+> **⚠ Alpha software — use with caution**
+>
+> coordshift is in early development (pre-v1.0). APIs and output formats may change without notice.
+> **Always verify converted coordinates against a trusted independent source before using them in any survey, legal, safety-critical, or production workflow.**
+> The authors provide no warranty and accept no liability for errors in coordinate conversion results. Use at your own risk.
+
+Universal coordinate system conversion for CSV and tabular data — built for GIS analysts, surveyors, and drone mapping workflows.
+
+## What it does
+
+`coordshift` reprojects coordinate columns in CSV files from one CRS to another, using any system supported by PROJ. It ships as both a command-line tool and a Python library, plus a standalone browser-based converter (`coordshift.html`) that works entirely offline.
+
+**CLI**
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --x lon --y lat
+```
+
+**Python**
+
+```python
+from coordshift import convert
+
+df = convert("input.csv", from_crs="EPSG:4326", to_crs="EPSG:2965", x="lon", y="lat")
+```
+
+**Browser**
+
+Open `coordshift.html` in any modern browser — no install required.
+
+## Why this exists
+
+Tools like cs2cs, ogr2ogr, and raw pyproj are powerful but assume you already speak PROJ. `coordshift` targets practitioners who need fast, repeatable conversions without wrestling with syntax.
+
+## What's included
+
+- Convert any EPSG/PROJ CRS to any other
+- Auto-detect common column names (lat, lon, x, y, easting, northing, etc.)
+- Source and target CRS via EPSG code, PROJ string, or friendly preset name
+- Preserve all columns in output — original X/Y columns are always kept
+- Converted coordinates written to new columns placed immediately after the originals
+- Customisable output column suffix (default `_converted`, e.g. `lon_converted`, `lat_converted`)
+- CLI for one-off conversions
+- Python API for scripting and pipelines
+- Browser-based converter (`coordshift.html`) with map preview — works offline
+
+## Planned
+
+- Vertical coordinate support (ellipsoidal ↔ orthometric, GEOID)
+- Batch conversion across multiple files
+- Output to GeoJSON or Shapefile
+
+## Installation
+
+Install from source until the first PyPI release:
+
+```bash
+git clone https://github.com/FultonGeo/coordshift.git
+cd coordshift
+pip install -e .
+```
+
+Or, once published:
+
+```bash
+pip install coordshift
+```
+
+## Usage
+
+### CLI
+
+Basic conversion (original `lon`/`lat` columns are preserved; converted values go into `lon_converted`/`lat_converted` placed right after them):
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --x lon --y lat
+```
+
+With output path:
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --x lon --y lat --out output.csv
+```
+
+Custom column name suffix (produces `lon_proj`, `lat_proj` instead of the default `lon_converted`, `lat_converted`):
+
+```bash
+coordshift convert input.csv --from EPSG:4326 --to EPSG:2965 --suffix _proj
+```
+
+PROJ strings (use a single line on Windows, or wrap as your shell allows):
+
+```bash
+coordshift convert input.csv \
+  --from "+proj=longlat +datum=WGS84" \
+  --to "+proj=tmerc +lat_0=37.5 +lon_0=-85.66666667 +k=0.999966667 +x_0=100000 +y_0=250000 +ellps=GRS80" \
+  --x longitude --y latitude
+```
+
+List presets and search CRS:
+
+```bash
+coordshift list-crs
+coordshift search "indiana east"
+```
+
+### Python API
+
+```python
+from coordshift import convert, search_crs
+
+df = convert(
+    "field_points.csv",
+    from_crs="EPSG:4326",
+    to_crs="EPSG:2965",
+    x="lon",
+    y="lat",
+)
+# df now has lon, lon_converted, lat, lat_converted (plus any other original columns)
+df.to_csv("field_points_converted.csv", index=False)
+
+results = search_crs("indiana east")
+```
+
+See [docs/examples.md](docs/examples.md) for more detailed examples.
+
+### Browser app
+
+Open `coordshift.html` in any modern browser (Chrome, Firefox, Edge, Safari). No server or internet connection required after the page loads. Features include:
+
+- Upload a CSV and pick coordinate columns
+- Search and select source/target CRS from a built-in catalog of State Plane zones, UTM, and common geographic systems
+- Preview converted points on an interactive map
+- Download the converted CSV
+
+## Project structure
+
+```text
+coordshift/
+├── coordshift/         # Python package
+│   ├── __init__.py    # Public API
+│   ├── core.py        # Conversion (pyproj)
+│   ├── cli.py         # CLI (Click)
+│   ├── io.py          # CSV I/O, column detection
+│   ├── crs.py         # CRS resolution
+│   └── presets.py     # Friendly name → EPSG
+├── tests/
+│   ├── test_core.py
+│   ├── test_cli.py
+│   ├── test_io.py
+│   └── fixtures/
+├── docs/
+│   └── examples.md
+├── scripts/           # Developer tooling (regenerate HTML catalog)
+├── coordshift.html    # Standalone browser-based converter
+├── pyproject.toml
+├── README.md
+└── LICENSE
+```
+
+## Development setup
+
+```bash
+git clone https://github.com/FultonGeo/coordshift.git
+cd coordshift
+python -m venv venv
+```
+
+Activate the virtual environment:
+
+- **Windows (PowerShell):** `.\venv\Scripts\Activate.ps1`
+- **macOS / Linux:** `source venv/bin/activate`
+
+Then:
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+Run the linter:
+
+```bash
+ruff check coordshift/
+```
+
+## Dependencies
+
+- [pyproj](https://pyproj4.github.io/pyproj/) — PROJ bindings
+- [pandas](https://pandas.pydata.org/) — tabular data
+- [click](https://click.palletsprojects.com/) — CLI
+
+## Contributing
+
+Contributions welcome. Open an issue before large changes so direction stays aligned.
+
+1. Fork the repo
+2. Create a branch: `git checkout -b feature/my-feature`
+3. Commit and push
+4. Open a pull request
+
+## Disclaimer
+
+coordshift is alpha software provided **as-is**, without warranty of any kind, express or implied. Coordinate conversion results depend on the accuracy of the underlying PROJ library, the correctness of the CRS definitions used, and the quality of the input data. Always double-check converted coordinates against an authoritative source before using them in any survey, engineering, legal, or safety-critical context. The authors and contributors are not responsible for errors, losses, or damages arising from the use of this software.
+
+## License
+
+MIT. See [LICENSE](LICENSE).
+
+## Author
+
+Nick Fulton — geospatial work, FAA Part 107, drone and survey experience.
+
+Repository: [FultonGeo/coordshift](https://github.com/FultonGeo/coordshift).

coordshift-0.1.0/coordshift/__init__.py

@@ -0,0 +1,13 @@
+"""
+coordshift — Universal coordinate system conversion for CSV and tabular data.
+
+Basic usage:
+    from coordshift import convert
+    df = convert("input.csv", from_crs="EPSG:4326", to_crs="EPSG:2965", x="lon", y="lat")
+"""
+
+from coordshift.core import convert
+from coordshift.crs import resolve_crs, search_crs
+
+__version__ = "0.1.0"
+__all__ = ["convert", "resolve_crs", "search_crs"]