3D conformal (Helmert) fit from common points
The seven Helmert parameters (three translations, three rotations, and a scale) that carry one set of 3D coordinates onto another with the least squared misfit, with standard errors and per-point residuals.
Experimental: not yet fully verified. How results are checked
The fit's residuals are 0.04 mm RMS, with a scale change of 0.8329 ppm.
| Point | Residual in X, Y, Z | Residual X | Residual Y | Residual Z |
|---|---|---|---|---|
| P1 | 0, 0, 0 mm | 0.02 mm | 0.03 mm | -0.02 mm |
| P2 | -0.1, 0, 0.1 mm | -0.07 mm | -0.05 mm | 0.06 mm |
| P3 | 0, 0, 0 mm | 0.04 mm | -0.03 mm | -0.03 mm |
| P4 | 0, 0, 0 mm | -0.04 mm | 0.03 mm | -0.00 mm |
| P5 | 0.1, 0, 0 mm | 0.05 mm | 0.03 mm | -0.01 mm |
- Translation Y
- Translation Z
- Rotation X
- Rotation Y
- Rotation Z
- Scale change
Provenance
- Computed by
- survey.cogo.helmert-3d-fit 1.0.0, core 0.1.0
- Model
- Least squares on V_T = T + (1 + dS) · (I + Ω) · V_S (IOGP GN 7-2 §4.2.3), Ω the small-angle rotation matrix (signs reversed for the coordinate-frame convention); Gauss-Newton on centroid-reduced coordinates from zero, to 1e-15; σ0² = vᵀv / (3n − 7); standard errors from σ0² N⁻¹
- Accuracy
- Exact least squares for the linearized rotation model the Helmert tool uses; valid for the small rotations of datum transformations (well under a degree)
- Notes
- 1 shown with the answer
- Cites
- International Association of Oil & Gas Producers (IOGP), Coordinate Conversions and Transformations including Formulas, IOGP Publication 373-7-2
Something look off?
How we got thisFormula, worked example, sources, and proof
Model: Least squares on V_T = T + (1 + dS) · (I + Ω) · V_S (IOGP GN 7-2 §4.2.3), Ω the small-angle rotation matrix (signs reversed for the coordinate-frame convention); Gauss-Newton on centroid-reduced coordinates from zero, to 1e-15; σ0² = vᵀv / (3n − 7); standard errors from σ0² N⁻¹
Accuracy: Exact least squares for the linearized rotation model the Helmert tool uses; valid for the small rotations of datum transformations (well under a degree)
When to use this: Use this to find the seven-parameter transformation between two 3D coordinate systems from points known in both, such as control coordinates in an old and a new datum, or a scan or local survey registered to ECEF. It reports the parameters with standard errors and every point's residual, so a bad common point shows itself. Send the parameters to the Helmert tool to transform other points.
Limitations: It uses the small-angle rotation model of geodetic datum transformations, so it is for rotations of seconds to minutes of arc, not for registering systems turned by degrees. All points weigh equally. With 3 points there are only 2 degrees of freedom, too few to judge the fit; use more points spread over the area. Source and target must be the same kind of coordinates (both ECEF, or both one local 3D system) and in the same unit.
Worked example: Five common points 2 km apart, a sub-meter shift. Source: Synthetic points from known parameters (tools/vectors/gen_helmert_fit.py), rounded to 0.1 mm.
You enter
- Common points
- P1, 4027189.3311 m, 305648.9967 m, 4920078.6379 m, 4027190.3555 m, 305651.3552 m, 4920084.8697 m P2, 4026183.7451 m, 307189.1280 m, 4918937.6557 m, 4026184.7673 m, 307191.4873 m, 4918943.8870 m P3, 4026125.9957 m, 307075.3429 m, 4917624.8826 m, 4026127.0184 m, 307077.7028 m, 4917631.1128 m P4, 4027628.5827 m, 305325.0217 m, 4917837.7521 m, 4027629.6088 m, 305327.3818 m, 4917843.9820 m P5, 4027592.0768 m, 308353.0085 m, 4917970.1078 m, 4027593.0990 m, 308355.3710 m, 4917976.3396 m
You get
- Translation X
- -0.0343 m
- Translation Y
- 0.0737 m
- Translation Z
- 0.3814 m
- Rotation X
- 0.12241″
- Rotation Y
- -0.08048″
- Rotation Z
- 0.25354″
- Scale change
- 0.8329 ppm
- Rotation convention
- position-vector
- Standard errors
- tx ±0.1197 m, ty ±0.1067 m, tz ±0.1109 m; rx ±0.0033", ry ±0.00432", rz ±0.00377"; scale ±0.0145 ppm
- RMS residual
- 0.04 mm
- Reference variance
- 0.00000000261
- Degrees of freedom
- 8
Review: Not yet independently reviewed by a licensed surveyor.
Last verified: 2026-09-19, when a maintainer last confirmed this tool's sources at the issuer. See the sources ledger.
Status: version 1.0.0, core 0.1.0. See this tool in the verification report.
Changes
- 2026-11-06, fixed: The three-dimensional Helmert fit now refuses systems that are turned too far for it, instead of answering anyway. It fits the small-rotation model geodetic datum transformations use, which is good to about a degree; past that the approximation is worth more than 150 parts per million. Fed a published example whose two systems differ by rotations of 130, 86, and 190 degrees, it used to settle on rotations of tens of degrees, a negative scale, and residuals of metres, with only the scale warning to hint that anything was wrong. It now says plainly that the fit wants a rotation past the one degree the model holds to, and suggests bringing the axes together first. Nothing changes for the small rotations the tool is for: no published vector moved. Changelog
- 2026-10-28, changed: The three-dimensional Helmert fit now draws its residuals and reports them as numbers. Residuals in three dimensions have no one plane to live in, so the points are drawn in plan with each horizontal residual as an arrow and each vertical residual as a bar beside it, both at an exaggeration the caption states, because the residuals are millimetres against hundreds of metres. What it is for is telling scatter, which is noise, from a pattern, which means something the seven parameters do not model. Each residual row also carries its X, Y, and Z components as numbers now, beside the printed line, so a machine reader does not have to parse that line. The partition, Helmert-fit, and levelling-network tools also gained an independent check: the same mathematics solved again in numpy, which agrees to double precision on the levelling network, to a nanometre on the fit's translations, and to two parts per billion of the parcel on the partition. Changelog
Checked against: 26 golden test vectors (download the test vectors, each with its source and tolerance). See how results are checked and every source.
Sources
- Coordinate Conversions and Transformations including Formulas, IOGP Publication 373-7-2, International Association of Oil & Gas Producers (IOGP), Revised September 2019. §4.2.3 Helmert 7-parameter transformations (EPSG methods 1032 and 1033).
Terms
- EPSG: EPSG Geodetic Parameter Dataset
- The IOGP registry of coordinate reference systems and transformations, each with a code such as EPSG:4326. Source: EPSG Geodetic Parameter Dataset
- RMS: root mean square
- The square root of the average of the squared values. For residuals it is one number for how far, typically, the fitted points sit from the measured ones. Source: IOGP Guidance Note 7-2: Coordinate Conversions and Transformations
Experimental means this tool has not yet met the stable bar: at least 20 golden vectors, differential tests, and an independent worked example.