geoprimsField-grade geospatial math

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

-0.0343m

The fit's residuals are 0.04 mm RMS, with a scale change of 0.8329 ppm.

Residuals
PointResidual in X, Y, ZResidual XResidual YResidual Z
P10, 0, 0 mm0.02 mm0.03 mm-0.02 mm
P2-0.1, 0, 0.1 mm-0.07 mm-0.05 mm0.06 mm
P30, 0, 0 mm0.04 mm-0.03 mm-0.03 mm
P40, 0, 0 mm-0.04 mm0.03 mm-0.00 mm
P50.1, 0, 0 mm0.05 mm0.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?

Your values

Showing an example. Change anything.
Run many at once from a CSV

Loading…

Arrow horizontal, bar vertical200× · RMS 0.04 mm · 5 pts · 8 dof
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

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

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.