NetFabric/NetFabric.Numerics / .agents/skills/helmert-datum-transformation
helmert-datum-transformation
VerifiedAbstract math for the 7-parameter (Helmert) similarity transformation used to convert coordinates between geodetic datums. USE FOR: implementing datum-to-datum 3D coordinate transformations; understanding the 7 Helmert parameters (3 translations, 3 rotations, 1 scale); applying the linearized vs. full rotation matrix form; composing transformations; transforming to/from WGS84. DO NOT USE FOR: geodetic coordinate validation (use geodetic-coordinate-bounds); reference ellipsoid parameters (use reference-ellipsoids); map projections.
Helmert Datum Transformation
Definition
The 7-parameter Helmert transformation converts geocentric Cartesian coordinates (X, Y, Z) from one datum to another. Also called similarity transformation or Bursa-Wolf model.
Parameters:
| Symbol | Name | Unit |
|---|---|---|
| ΔX, ΔY, ΔZ | Translation (origin shift) | metres |
| Rₓ, Rᵧ, R_z | Rotation (small angles) | arcseconds (or radians) |
| ΔS | Scale factor change | ppm (parts per million) |
Linearized Formula (Small Rotations)
When Rₓ, Rᵧ, R_z << 1 radian (typically < 10 arcsec for datum shifts):
⎡X'⎤ ⎡ΔX⎤ ⎡ 1 R_z −Rᵧ⎤ ⎡X⎤
⎢Y'⎥ = ⎢ΔY⎥ + (1+ΔS) ⎢−R_z 1 Rₓ ⎥ ⎢Y⎥
⎣Z'⎦ ⎣ΔZ⎦ ⎣ Rᵧ −Rₓ 1 ⎦ ⎣Z⎦
ΔS is the fractional scale: ΔS = 0 means no scale change. Applied as (1 + ΔS × 10⁻⁶) when given in ppm.
Inverse Transformation
To reverse the transformation (source ← target), negate all 7 parameters:
(−ΔX, −ΔY, −ΔZ, −Rₓ, −Rᵧ, −R_z, −ΔS)
This is exact for the linearized form. For the full rotation matrix form, invert the rotation matrix.
WGS84 as Reference
WGS84 geocentric coordinates are the common hub. Typical workflow:
Source datum → WGS84 → Target datum
WGS84 ↔ WGS72 parameters are defined in the WGS84 standard. For national grids, parameters are published by the national geodetic authority (e.g., EPSG registry).
Sign Convention
Two conventions exist — confirm which is in use:
- Coordinate Frame (used by EPSG): rotations rotate the coordinate frame
- Position Vector (Bursa-Wolf): rotations rotate the position vector
The rotation matrix entries swap sign between conventions. The parameters are numerically identical but with opposite rotation signs.
Reference Files
| File | Load When |
|---|---|
| references/formulas.md | Full rotation matrix form, ppm conversion, composition, inverse |
| references/numerical-stability.md | Angle unit conversion, scale near 1, ppm precision |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |