koreacoord 0.1.0__tar.gz

koreacoord-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.venv/
+dist/
+build/
+.env

koreacoord-0.1.0/LICENSE

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

koreacoord-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.5
+Name: koreacoord
+Version: 0.1.0
+Summary: Convert between Korean coordinate systems: TM, KTM, UTM 52N, Congnamul, WGS84, Bessel
+Project-URL: Homepage, https://github.com/AngLaboratory/koreacoord
+Project-URL: Source, https://github.com/AngLaboratory/koreacoord
+Project-URL: Issues, https://github.com/AngLaboratory/koreacoord/issues
+Author-email: AngLaboratory <anglaboratory@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bessel,congnamul,coordinate,coordinate-system,geodesy,gis,korea,ktm,tm,utm,wgs84,좌표계,좌표변환
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Korean
+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 :: GIS
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# koreacoord
+
+[![CI](https://github.com/AngLaboratory/koreacoord/actions/workflows/ci.yml/badge.svg)](https://github.com/AngLaboratory/koreacoord/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/koreacoord)](https://pypi.org/project/koreacoord/)
+[![Python](https://img.shields.io/pypi/pyversions/koreacoord)](https://pypi.org/project/koreacoord/)
+
+Convert between the coordinate systems used on Korean maps — TM, KTM, UTM 52N,
+Kakao's Congnamul grid, WGS84 and Bessel/Tokyo — with no dependencies.
+
+한국 지도에서 쓰이는 좌표계(TM, KTM, UTM 52N, 카카오 콩나물 좌표, WGS84, 베셀)를
+서로 변환합니다. 외부 의존성이 없습니다.
+
+## Install
+
+```bash
+pip install koreacoord
+```
+
+## Quick start
+
+```python
+from koreacoord import transform
+
+# Seoul City Hall, WGS84 -> Kakao's Congnamul grid
+x, y = transform(126.9876757, 37.5611523, "WGS84", "WCONGNAMUL")
+
+# Enum members work too, and are what your IDE will autocomplete
+from koreacoord import CoordSystem as CS
+
+x, y = transform(126.9876757, 37.5611523, CS.WGS84, CS.UTM)
+```
+
+The axis order is always **x then y** — longitude before latitude for geographic
+systems, easting before northing for projected ones.
+
+## Supported systems
+
+| Name | Description | Datum |
+| --- | --- | --- |
+| `WGS84` | Geographic longitude/latitude | WGS84 |
+| `BESSEL` | Geographic longitude/latitude | Bessel 1841 (Tokyo) |
+| `TM` | Transverse Mercator, central belt origin | Bessel 1841 |
+| `WTM` | Transverse Mercator, central belt origin | WGS84 |
+| `KTM` | Transverse Mercator, 128°E origin | Bessel 1841 |
+| `WKTM` | Transverse Mercator, 128°E origin | WGS84 |
+| `UTM` | UTM **zone 52N only** | WGS84 |
+| `CONGNAMUL` | Kakao(Daum) map grid | Bessel 1841 |
+| `WCONGNAMUL` | Kakao(Daum) map grid | WGS84 |
+
+```python
+from koreacoord import supported_systems
+
+supported_systems()
+# ['TM', 'WTM', 'CONGNAMUL', 'WCONGNAMUL', 'KTM', 'WKTM', 'UTM', 'WGS84', 'BESSEL']
+```
+
+## Scope
+
+**This library is for Korea.** Every projection origin and datum parameter is
+fixed to Korean values:
+
+- `UTM` is hard-wired to **zone 52N** (central meridian 129°E). Coordinates from
+  another zone will be silently wrong.
+- `BESSEL` uses the Tokyo-datum shift published for the Korean peninsula, so it
+  is not a general Bessel 1841 conversion.
+- `CONGNAMUL` relocates several island regions (Jeju, Ulleung, Dokdo) the way
+  Kakao's maps draw them. `WCONGNAMUL` does not — it only applies the 2.5×
+  scale, matching the reference implementation.
+
+Congnamul results are returned as integers; every other system returns floats.
+
+## API
+
+```python
+transform(x, y, from_system, to_system) -> tuple[float, float]
+supported_systems() -> list[str]
+```
+
+`transform` raises `ValueError` for an unknown system name and `TypeError` if
+the coordinates are not numbers.
+
+The original keyword-only form is kept as an alias:
+
+```python
+from koreacoord import get_trans_coord
+
+x, y = get_trans_coord(x=126.9876757, y=37.5611523,
+                       input="WGS84", output="WCONGNAMUL")
+```
+
+## Accuracy
+
+Measured by the test suite, across seven points from Mokpo to Dokdo:
+
+| | Agreement |
+| --- | --- |
+| TM projection vs. [pyproj](https://pyproj4.github.io/pyproj/) | within 0.04 mm |
+| Round trip within one datum | within 0.03 mm |
+| Round trip across datums | a few mm |
+| Congnamul grid | ±0.2 m (the grid is integer) |
+
+These are numbers about *self-consistency*, not about surveying truth. The
+datum shift is a 7-parameter Molodensky-Badekas approximation, so against
+official Korean survey data the realistic expectation is **metre-level**
+agreement, not centimetres.
+
+---
+
+# 한국어
+
+## 설치
+
+```bash
+pip install koreacoord
+```
+
+## 사용법
+
+```python
+from koreacoord import transform
+
+# 서울시청, WGS84 -> 카카오 콩나물 좌표
+x, y = transform(126.9876757, 37.5611523, "WGS84", "WCONGNAMUL")
+
+# 문자열 대신 열거형을 써도 됩니다 (IDE 자동완성이 됩니다)
+from koreacoord import CoordSystem as CS
+
+x, y = transform(126.9876757, 37.5611523, CS.WGS84, CS.UTM)
+```
+
+축 순서는 항상 **x 먼저, y 나중**입니다. 경위도계는 경도→위도, 평면좌표계는
+동거(easting)→북거(northing) 순서입니다.
+
+## 지원 좌표계
+
+| 이름 | 설명 | 측지계 |
+| --- | --- | --- |
+| `WGS84` | 경위도 | WGS84 |
+| `BESSEL` | 경위도 | 베셀 1841 (도쿄측지계) |
+| `TM` | 중부원점 TM | 베셀 1841 |
+| `WTM` | 중부원점 TM | WGS84 |
+| `KTM` | 경도 128° 원점 TM | 베셀 1841 |
+| `WKTM` | 경도 128° 원점 TM | WGS84 |
+| `UTM` | UTM **52N 존 전용** | WGS84 |
+| `CONGNAMUL` | 카카오(다음) 지도 좌표 | 베셀 1841 |
+| `WCONGNAMUL` | 카카오(다음) 지도 좌표 | WGS84 |
+
+## 사용 범위
+
+**이 라이브러리는 한국 전용입니다.** 투영 원점과 측지계 파라미터가 전부 한국
+값으로 고정되어 있습니다.
+
+- `UTM`은 **52N 존(중앙자오선 129°E)** 으로 고정입니다. 다른 존의 좌표를 넣으면
+  오류 없이 틀린 값이 나옵니다.
+- `BESSEL`은 한반도용 도쿄측지계 변환값을 쓰므로 일반적인 베셀 1841 변환이
+  아닙니다.
+- `CONGNAMUL`은 카카오 지도가 제주·울릉·독도를 옮겨 그리는 보정을 반영합니다.
+  `WCONGNAMUL`은 이 보정 없이 2.5배 배율만 적용합니다 (원 구현과 동일).
+
+콩나물 좌표는 정수로, 나머지는 실수로 반환됩니다.
+
+## 정확도
+
+목포부터 독도까지 7개 지점으로 측정한 값입니다.
+
+| | 일치 수준 |
+| --- | --- |
+| TM 투영 vs [pyproj](https://pyproj4.github.io/pyproj/) | 0.04mm 이내 |
+| 같은 측지계 내 왕복 변환 | 0.03mm 이내 |
+| 측지계를 넘는 왕복 변환 | 수 mm |
+| 콩나물 좌표 | ±0.2m (격자가 정수) |
+
+이건 **자체 정합성** 수치이지 측량 성과와의 일치도가 아닙니다. 측지계 변환이
+7-파라미터 Molodensky-Badekas 근사라서, 국토지리정보원 성과와 비교하면
+센티미터가 아니라 **미터 단위**로 맞는다고 보는 게 현실적입니다.
+
+## 라이선스
+
+MIT

koreacoord-0.1.0/README.md

@@ -0,0 +1,179 @@
+# koreacoord
+
+[![CI](https://github.com/AngLaboratory/koreacoord/actions/workflows/ci.yml/badge.svg)](https://github.com/AngLaboratory/koreacoord/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/koreacoord)](https://pypi.org/project/koreacoord/)
+[![Python](https://img.shields.io/pypi/pyversions/koreacoord)](https://pypi.org/project/koreacoord/)
+
+Convert between the coordinate systems used on Korean maps — TM, KTM, UTM 52N,
+Kakao's Congnamul grid, WGS84 and Bessel/Tokyo — with no dependencies.
+
+한국 지도에서 쓰이는 좌표계(TM, KTM, UTM 52N, 카카오 콩나물 좌표, WGS84, 베셀)를
+서로 변환합니다. 외부 의존성이 없습니다.
+
+## Install
+
+```bash
+pip install koreacoord
+```
+
+## Quick start
+
+```python
+from koreacoord import transform
+
+# Seoul City Hall, WGS84 -> Kakao's Congnamul grid
+x, y = transform(126.9876757, 37.5611523, "WGS84", "WCONGNAMUL")
+
+# Enum members work too, and are what your IDE will autocomplete
+from koreacoord import CoordSystem as CS
+
+x, y = transform(126.9876757, 37.5611523, CS.WGS84, CS.UTM)
+```
+
+The axis order is always **x then y** — longitude before latitude for geographic
+systems, easting before northing for projected ones.
+
+## Supported systems
+
+| Name | Description | Datum |
+| --- | --- | --- |
+| `WGS84` | Geographic longitude/latitude | WGS84 |
+| `BESSEL` | Geographic longitude/latitude | Bessel 1841 (Tokyo) |
+| `TM` | Transverse Mercator, central belt origin | Bessel 1841 |
+| `WTM` | Transverse Mercator, central belt origin | WGS84 |
+| `KTM` | Transverse Mercator, 128°E origin | Bessel 1841 |
+| `WKTM` | Transverse Mercator, 128°E origin | WGS84 |
+| `UTM` | UTM **zone 52N only** | WGS84 |
+| `CONGNAMUL` | Kakao(Daum) map grid | Bessel 1841 |
+| `WCONGNAMUL` | Kakao(Daum) map grid | WGS84 |
+
+```python
+from koreacoord import supported_systems
+
+supported_systems()
+# ['TM', 'WTM', 'CONGNAMUL', 'WCONGNAMUL', 'KTM', 'WKTM', 'UTM', 'WGS84', 'BESSEL']
+```
+
+## Scope
+
+**This library is for Korea.** Every projection origin and datum parameter is
+fixed to Korean values:
+
+- `UTM` is hard-wired to **zone 52N** (central meridian 129°E). Coordinates from
+  another zone will be silently wrong.
+- `BESSEL` uses the Tokyo-datum shift published for the Korean peninsula, so it
+  is not a general Bessel 1841 conversion.
+- `CONGNAMUL` relocates several island regions (Jeju, Ulleung, Dokdo) the way
+  Kakao's maps draw them. `WCONGNAMUL` does not — it only applies the 2.5×
+  scale, matching the reference implementation.
+
+Congnamul results are returned as integers; every other system returns floats.
+
+## API
+
+```python
+transform(x, y, from_system, to_system) -> tuple[float, float]
+supported_systems() -> list[str]
+```
+
+`transform` raises `ValueError` for an unknown system name and `TypeError` if
+the coordinates are not numbers.
+
+The original keyword-only form is kept as an alias:
+
+```python
+from koreacoord import get_trans_coord
+
+x, y = get_trans_coord(x=126.9876757, y=37.5611523,
+                       input="WGS84", output="WCONGNAMUL")
+```
+
+## Accuracy
+
+Measured by the test suite, across seven points from Mokpo to Dokdo:
+
+| | Agreement |
+| --- | --- |
+| TM projection vs. [pyproj](https://pyproj4.github.io/pyproj/) | within 0.04 mm |
+| Round trip within one datum | within 0.03 mm |
+| Round trip across datums | a few mm |
+| Congnamul grid | ±0.2 m (the grid is integer) |
+
+These are numbers about *self-consistency*, not about surveying truth. The
+datum shift is a 7-parameter Molodensky-Badekas approximation, so against
+official Korean survey data the realistic expectation is **metre-level**
+agreement, not centimetres.
+
+---
+
+# 한국어
+
+## 설치
+
+```bash
+pip install koreacoord
+```
+
+## 사용법
+
+```python
+from koreacoord import transform
+
+# 서울시청, WGS84 -> 카카오 콩나물 좌표
+x, y = transform(126.9876757, 37.5611523, "WGS84", "WCONGNAMUL")
+
+# 문자열 대신 열거형을 써도 됩니다 (IDE 자동완성이 됩니다)
+from koreacoord import CoordSystem as CS
+
+x, y = transform(126.9876757, 37.5611523, CS.WGS84, CS.UTM)
+```
+
+축 순서는 항상 **x 먼저, y 나중**입니다. 경위도계는 경도→위도, 평면좌표계는
+동거(easting)→북거(northing) 순서입니다.
+
+## 지원 좌표계
+
+| 이름 | 설명 | 측지계 |
+| --- | --- | --- |
+| `WGS84` | 경위도 | WGS84 |
+| `BESSEL` | 경위도 | 베셀 1841 (도쿄측지계) |
+| `TM` | 중부원점 TM | 베셀 1841 |
+| `WTM` | 중부원점 TM | WGS84 |
+| `KTM` | 경도 128° 원점 TM | 베셀 1841 |
+| `WKTM` | 경도 128° 원점 TM | WGS84 |
+| `UTM` | UTM **52N 존 전용** | WGS84 |
+| `CONGNAMUL` | 카카오(다음) 지도 좌표 | 베셀 1841 |
+| `WCONGNAMUL` | 카카오(다음) 지도 좌표 | WGS84 |
+
+## 사용 범위
+
+**이 라이브러리는 한국 전용입니다.** 투영 원점과 측지계 파라미터가 전부 한국
+값으로 고정되어 있습니다.
+
+- `UTM`은 **52N 존(중앙자오선 129°E)** 으로 고정입니다. 다른 존의 좌표를 넣으면
+  오류 없이 틀린 값이 나옵니다.
+- `BESSEL`은 한반도용 도쿄측지계 변환값을 쓰므로 일반적인 베셀 1841 변환이
+  아닙니다.
+- `CONGNAMUL`은 카카오 지도가 제주·울릉·독도를 옮겨 그리는 보정을 반영합니다.
+  `WCONGNAMUL`은 이 보정 없이 2.5배 배율만 적용합니다 (원 구현과 동일).
+
+콩나물 좌표는 정수로, 나머지는 실수로 반환됩니다.
+
+## 정확도
+
+목포부터 독도까지 7개 지점으로 측정한 값입니다.
+
+| | 일치 수준 |
+| --- | --- |
+| TM 투영 vs [pyproj](https://pyproj4.github.io/pyproj/) | 0.04mm 이내 |
+| 같은 측지계 내 왕복 변환 | 0.03mm 이내 |
+| 측지계를 넘는 왕복 변환 | 수 mm |
+| 콩나물 좌표 | ±0.2m (격자가 정수) |
+
+이건 **자체 정합성** 수치이지 측량 성과와의 일치도가 아닙니다. 측지계 변환이
+7-파라미터 Molodensky-Badekas 근사라서, 국토지리정보원 성과와 비교하면
+센티미터가 아니라 **미터 단위**로 맞는다고 보는 게 현실적입니다.
+
+## 라이선스
+
+MIT

koreacoord-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "koreacoord"
+version = "0.1.0"
+description = "Convert between Korean coordinate systems: TM, KTM, UTM 52N, Congnamul, WGS84, Bessel"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "AngLaboratory", email = "anglaboratory@gmail.com" }]
+keywords = [
+    "coordinate",
+    "coordinate-system",
+    "korea",
+    "gis",
+    "geodesy",
+    "tm",
+    "ktm",
+    "utm",
+    "congnamul",
+    "wgs84",
+    "bessel",
+    "좌표계",
+    "좌표변환",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Typing :: Typed",
+    "Natural Language :: Korean",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/AngLaboratory/koreacoord"
+Source = "https://github.com/AngLaboratory/koreacoord"
+Issues = "https://github.com/AngLaboratory/koreacoord/issues"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pyproj>=3.6",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/koreacoord"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/", "tests/", "README.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

koreacoord-0.1.0/src/koreacoord/__init__.py

@@ -0,0 +1,26 @@
+"""Convert between Korean coordinate systems. / 한국 좌표계 간 변환.
+
+>>> from koreacoord import transform
+>>> transform(126.9876757, 37.5611523, "WGS84", "WCONGNAMUL")
+"""
+
+from __future__ import annotations
+
+from ._params import BESSEL_1841, WGS84_ELLIPSOID, Ellipsoid, TMParams
+from .core import get_trans_coord, map_type, supported_systems, transform
+from .systems import CoordSystem
+
+__version__ = "0.1.0"
+
+__all__ = [
+    "CoordSystem",
+    "transform",
+    "supported_systems",
+    "get_trans_coord",
+    "map_type",
+    "Ellipsoid",
+    "TMParams",
+    "BESSEL_1841",
+    "WGS84_ELLIPSOID",
+    "__version__",
+]

koreacoord-0.1.0/src/koreacoord/_congnamul.py

@@ -0,0 +1,78 @@
+"""Congnamul grid used by Kakao(Daum) maps. / 카카오(다음) 지도의 콩나물 좌표."""
+
+from __future__ import annotations
+
+import math
+from typing import Tuple
+
+SCALE = 2.5
+
+# 지도상 별도 위치로 옮겨 그리는 도서 지역(제주·울릉·독도 등)의 TM 영역과 보정량.
+# (x, y, width, height), 단위 m
+_ISLAND_RECTS = (
+    (112500.0, -50000.0, 33500.0, 53000.0),
+    (146000.0, -50000.0, 54000.0, 58600.0),
+    (130000.0, 44000.0, 15000.0, 14000.0),
+    (532500.0, 437500.0, 25000.0, 25000.0),
+    (625000.0, 412500.0, 25000.0, 25000.0),
+    (-12500.0, 462500.0, 17500.0, 50000.0),
+)
+
+_SHIFT_TO_GRID = (
+    (0.0, 50000.0),
+    (0.0, 50000.0),
+    (0.0, 10000.0),
+    (-70378.0, -136.0),
+    (-144738.0, -2161.0),
+    (23510.0, -111.0),
+)
+
+_SHIFT_TO_TM = tuple((-dx, -dy) for dx, dy in _SHIFT_TO_GRID)
+
+# 되돌릴 때는 이미 옮겨진 좌표가 들어오므로, 사각형도 같이 옮겨 놓고 판정한다.
+_ISLAND_RECTS_MOVED = tuple(
+    (rx + dx, ry + dy, rw, rh)
+    for (rx, ry, rw, rh), (dx, dy) in zip(_ISLAND_RECTS, _SHIFT_TO_GRID)
+)
+
+
+def _round_half_up(value: float) -> int:
+    return math.floor(value + 0.5)
+
+
+def _island_offset(
+    x: float,
+    y: float,
+    rects: Tuple[Tuple[float, float, float, float], ...],
+    shifts: Tuple[Tuple[float, float], ...],
+) -> Tuple[float, float]:
+    for (rx, ry, rw, rh), shift in zip(rects, shifts):
+        if rx <= x <= rx + rw and ry <= y <= ry + rh:
+            return shift
+    return 0.0, 0.0
+
+
+def tm_to_grid(easting: float, northing: float) -> Tuple[int, int]:
+    """Scale TM meters onto the grid. / TM 평면좌표에 배율만 적용."""
+    return _round_half_up(easting * SCALE), _round_half_up(northing * SCALE)
+
+
+def grid_to_tm(x: float, y: float) -> Tuple[float, float]:
+    """Scale the grid back to TM meters. / 콩나물 좌표를 TM 평면좌표 배율로 되돌림."""
+    return x / SCALE, y / SCALE
+
+
+def tm_to_grid_shifted(easting: float, northing: float) -> Tuple[int, int]:
+    """As :func:`tm_to_grid`, moving island regions. / 도서 지역 보정을 포함."""
+    dx, dy = _island_offset(easting, northing, _ISLAND_RECTS, _SHIFT_TO_GRID)
+    return (
+        _round_half_up((easting + dx) * SCALE),
+        _round_half_up((northing + dy) * SCALE),
+    )
+
+
+def grid_to_tm_shifted(x: float, y: float) -> Tuple[float, float]:
+    """As :func:`grid_to_tm`, undoing the island move. / 도서 지역 보정을 되돌림."""
+    easting, northing = grid_to_tm(x, y)
+    dx, dy = _island_offset(easting, northing, _ISLAND_RECTS_MOVED, _SHIFT_TO_TM)
+    return easting + dx, northing + dy

koreacoord-0.1.0/src/koreacoord/_datum.py

@@ -0,0 +1,95 @@
+"""Datum shift between Bessel 1841 (Tokyo) and WGS84. / 베셀(도쿄측지계)↔WGS84 측지계 변환."""
+
+from __future__ import annotations
+
+import math
+from typing import Tuple
+
+from ._params import (
+    DEG,
+    MOLODENSKY_DS,
+    MOLODENSKY_DX,
+    MOLODENSKY_DY,
+    MOLODENSKY_DZ,
+    MOLODENSKY_KAPPA,
+    MOLODENSKY_OMEGA,
+    MOLODENSKY_PHI,
+    BESSEL_1841,
+    Ellipsoid,
+    WGS84_ELLIPSOID,
+)
+
+_CARTESIAN_ITERATIONS = 31
+_CARTESIAN_TOLERANCE = 1.0e-18
+
+
+def geodetic_to_cartesian(lon: float, lat: float, ell: Ellipsoid) -> Tuple[float, float, float]:
+    """Geographic to geocentric cartesian at zero height. / 경위도를 지심 직교좌표로 (높이 0)."""
+    lat_r = lat * DEG
+    lon_r = lon * DEG
+    nu = ell.a / math.sqrt(1 - ell.e2 * math.sin(lat_r) ** 2)
+    return (
+        nu * math.cos(lat_r) * math.cos(lon_r),
+        nu * math.cos(lat_r) * math.sin(lon_r),
+        nu * (ell.b**2 / ell.a**2) * math.sin(lat_r),
+    )
+
+
+def cartesian_to_geodetic(x: float, y: float, z: float, ell: Ellipsoid) -> Tuple[float, float]:
+    """Geocentric cartesian to geographic. / 지심 직교좌표를 경위도로.
+
+    Latitude is solved iteratively. / 위도는 반복 계산으로 수렴시킵니다.
+    """
+    lon = math.degrees(math.atan2(y, x))
+    if lon < 0:
+        lon += 360.0
+
+    p = math.hypot(x, y)
+    one_minus_e2 = ell.b**2 / ell.a**2
+
+    nu = ell.a
+    height = 0.0
+    lat_r = 0.0
+    previous = 0.0
+    for _ in range(_CARTESIAN_ITERATIONS):
+        lat_r = math.atan(z / math.sqrt((one_minus_e2 * nu + height) ** 2 - z**2))
+        if abs(lat_r - previous) < _CARTESIAN_TOLERANCE:
+            break
+        nu = ell.a / math.sqrt(1 - ell.e2 * math.sin(lat_r) ** 2)
+        height = p / math.cos(lat_r) - nu
+        previous = lat_r
+
+    return lon, lat_r / DEG
+
+
+def _wgs84_frame_to_bessel(x: float, y: float, z: float) -> Tuple[float, float, float]:
+    scale = 1 + MOLODENSKY_DS
+    return (
+        x + scale * (MOLODENSKY_KAPPA * y - MOLODENSKY_PHI * z) + MOLODENSKY_DX,
+        y + scale * (-MOLODENSKY_KAPPA * x + MOLODENSKY_OMEGA * z) + MOLODENSKY_DY,
+        z + scale * (MOLODENSKY_PHI * x - MOLODENSKY_OMEGA * y) + MOLODENSKY_DZ,
+    )
+
+
+def _bessel_frame_to_wgs84(x: float, y: float, z: float) -> Tuple[float, float, float]:
+    scale = 1 + MOLODENSKY_DS
+    sx = (x - MOLODENSKY_DX) * scale
+    sy = (y - MOLODENSKY_DY) * scale
+    sz = (z - MOLODENSKY_DZ) * scale
+    return (
+        (sx - MOLODENSKY_KAPPA * sy + MOLODENSKY_PHI * sz) / scale,
+        (MOLODENSKY_KAPPA * sx + sy - MOLODENSKY_OMEGA * sz) / scale,
+        (-MOLODENSKY_PHI * sx + MOLODENSKY_OMEGA * sy + sz) / scale,
+    )
+
+
+def bessel_to_wgs84(lon: float, lat: float) -> Tuple[float, float]:
+    """Bessel/Tokyo geographic to WGS84 geographic. / 베셀 경위도를 WGS84 경위도로."""
+    x, y, z = geodetic_to_cartesian(lon, lat, BESSEL_1841)
+    return cartesian_to_geodetic(*_bessel_frame_to_wgs84(x, y, z), WGS84_ELLIPSOID)
+
+
+def wgs84_to_bessel(lon: float, lat: float) -> Tuple[float, float]:
+    """WGS84 geographic to Bessel/Tokyo geographic. / WGS84 경위도를 베셀 경위도로."""
+    x, y, z = geodetic_to_cartesian(lon, lat, WGS84_ELLIPSOID)
+    return cartesian_to_geodetic(*_wgs84_frame_to_bessel(x, y, z), BESSEL_1841)