geoprimsField-grade geospatial math

Line of sight over a ground profile

Whether an observer can see a target over the ground between them, with the Earth's curve and refraction: the point that blocks the view, the height that would clear it, and the Fresnel zone clearance of a radio link.

yes

The target is in sight, with at least 0.23 m to spare at 60 m.

Along the path
DistanceSight lineClearance
10 m99.86 m1.15 m
20 m98.34 m0.79 m
30 m96.82 m0.51 m
40 m95.30 m0.36 m
50 m93.78 m0.25 m
60 m92.26 m0.23 m
70 m90.74 m0.33 m
Least clearance
Least clearance at
Observer height to see the target
Points in the way
Provenance
Computed by
raster.terrain.line-of-sight 1.1.0, core 0.1.0
Model
Spherical Earth, R = 6371000 m, refraction k = 0 (effective radius 6371000 m); sight line from 1.72 m above the first point to 0 m above the last
Accuracy
Exact for the model at the points given; the ground between points is not checked, and real refraction varies with the weather
Notes
None
Cites
International Telecommunication Union, ITU-R P.530: Propagation data and prediction methods for terrestrial line-of-sight systems; Esri, Geodesic Viewshed (Spatial Analyst); Open Source Geospatial Foundation, r.viewshed reference fixture

Something look off?

Your values

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

Loading…

Closest: 0.23 m clearObserverTargetDistance → · heights ×3In sight
How we got thisFormula, worked example, sources, and proof

Model: Spherical Earth of effective radius R/(1 − k), the sight line as the straight chord between the antennas, clearance along the local vertical, and the first Fresnel radius √(λ d1 d2 / d)

Show your work

  1. Effective Earth radius

    Re = R / (1 − k), with k the refraction coefficient

    6,371 km / (1 − 0) = 6,371 km

  2. Earth bulge where the ground comes closest

    about d1 × d2 / (2 Re)

    0.06 km × 0.02 km / (2 × 6,371 km) = 0 m

  3. Least clearance

    sight line − ground, along the vertical

    92.26 m − 92.03 m = 0.23 m

  4. Is the target in sight?

    yes when the least clearance is above zero

    0.23 m = yes

The same steps an agent gets from the MCP server with explain: true.

Accuracy: Exact for the model at the points given; the ground between points is not checked, and real refraction varies with the weather

When to use this: Use this when there is ground between two points and the question is whether it gets in the way: a ridge between a pilot and a drone, a hill between a tower and a receiver, or the path of a radio link across a valley. Enter the ground profile from the observer to the target with both heights above the ground. It says whether the target is in sight, where the ground comes closest to the sight line, how high the observer would have to be to see over it, and, with a frequency, whether the path meets ITU-R P.530's 60% free-space clearance screen and where it does not.

Limitations: Only the points you give are checked, and the ground between them is not, so a narrow peak missed by the profile can still block the view; sample at least every break in the ground. Buildings, trees, and towers are not part of the ground unless you add their heights to it. Refraction enters only through k, and real air varies: plan a radio link against a lower k as well. The 60% figure is a screen, not a universal antenna-height criterion; ITU-R P.530's detailed procedure varies clearance with frequency, climate, path length, obstruction type, and diversity. The Fresnel check is not a diffraction-loss calculation, so it does not say how much signal an obstruction costs.

Worked example: The visible target in the GRASS GIS fixture. Source: GRASS GIS 8.5.0 r.viewshed reference fixture: the target 80 m east is visible at 81.352478 degrees. It is golden test vector v024, and every build checks the tool still gives its answer within its tolerance.

You enter

Refraction coefficient k
0
Observer height above ground
1.72 m
Ground profile
0 m, 99.661240 m 10 m, 98.713676 m 20 m, 97.548599 m 30 m, 96.310646 m 40 m, 94.935608 m 50 m, 93.522522 m 60 m, 92.027649 m 70 m, 90.406349 m 80 m, 89.214500 m
Target height above ground
0 m

You get

Target in sight
yes
Least clearance
0.23 m
Least clearance at
60 m
Observer height to see the target
1.04 m
Points in the way
0

Review: Not yet independently reviewed by a GIS professional.

Last verified: 2026-09-19, when a maintainer last confirmed this tool's sources at the issuer. See the sources ledger.

Status: version 1.1.0, core 0.1.0. See this tool in the verification report.

Changes

Checked against: 24 golden test vectors (download the test vectors, each with its source and tolerance). See how results are checked and every source.

Constants this tool assumes

Values you do not enter, and where each comes from.

Earth radius, GRS 80's mean radius R1 (6,371,008.771 m) rounded to the kilometer
6371000 m — Geodetic Reference System 1980
Default visible-light refraction coefficient k
0.13 — Geodesic Viewshed (Spatial Analyst)
Radio refraction, the median effective Earth radius factor of 4/3 (k = 0.25)
4/3 — ITU-R P.530, terrestrial line-of-sight propagation
Speed of light in vacuum
299792458 m/s — NIST SP 811 Guide for the Use of the SI
Free-space propagation clearance screen, as a share of the first Fresnel radius
60 % — ITU-R P.530, terrestrial line-of-sight propagation

Sources