Abschnitte der Dokumentation

Sichtlinien-Rechner — Funkhorizont und Erdwölbung

POSThttps://rftools.io/api/py/v1/calculate

Slug line-of-sight. Funkhorizont jeder Antenne, maximale Sichtlinienentfernung zwischen zwei Masten, Erdwölbung und Radius der ersten Fresnelzone an jedem Punkt der Strecke sowie die Freiheit, die die Verbindung dort braucht, über einer glatten Erde mit dem k-Faktor Ihrer Wahl.

Eingaben

Senden Sie jede dieser Eingaben in inputs, in den gezeigten Einheiten. Die meisten sind erforderlich: Ein Aufruf, dem eine davon fehlt, wird abgelehnt (400) und kostet nichts; eine, auf die der Rechner verzichten kann, erhält den gezeigten Standardwert. Eine Eingabe außerhalb ihres Bereichs wird trotzdem berechnet und in der Provenienz markiert.

Eingaben von line-of-sight
Name	Einheit	Bereich	Standardwert	Beschreibung
antennaHeight1Zahl	m	0 … 10000	40	Höhe von Antenne 1 über dem Bezugsniveau (Boden oder Meeresspiegel)
antennaHeight2Zahl	m	0 … 10000	30	Höhe von Antenne 2 über demselben Bezugsniveau
kFactorZahl	keine	mindestens 0.1	1.3333333333333333	k = 4/3 für die Standardatmosphäre; ein kleineres k krümmt die Strahlen weniger und erhöht die Erdwölbung
pathLengthZahl	km	mindestens 0.001	30	Entfernung zwischen den beiden Antennen
pointDistanceZahl	km	mindestens 0	15	Stelle der Strecke, an der Erdwölbung und Fresnelzone ausgewertet werden; muss zwischen 0 und der Streckenlänge liegen
frequencyZahl	GHz	mindestens 0.001	6	Frequenz der Verbindung, für den Fresnelzonenradius
fresnelFractionZahl	keine	mindestens 0	0.6	Anteil des Radius der ersten Fresnelzone, der frei bleiben soll

Ausgaben

Zurückgegeben in values, nach Namen. Ein Wert, der unbegrenzt oder nicht definiert ist, ist null.

Ausgaben von line-of-sight
Feld	Einheit	Beschreibung
maxLosDistanceHauptwert	km	Maximale Sichtlinienentfernung
horizon1	km	Funkhorizont von Antenne 1
horizon2	km	Funkhorizont von Antenne 2
bulge	m	Erdwölbung am Punkt
fresnelRadius	m	Radius der ersten Fresnelzone
requiredClearance	m	Erforderliche Freiheit (Wölbung + Fresnel)
rayHeight	m	Strahlhöhe über glatter Erde
maxObstacleHeight	m	Höchstes zulässiges Hindernis am Punkt

Aufruf

Berechnen: ein Aufruf, Anfrage und Antwort vollständig, und seine Fehler.
Batch: dieser Rechner zusammen mit anderen oder ein Sweep, in einer Anfrage.
Nach einem Zielwert auflösen: der Wert einer Eingabe, der eine Ausgabe auf einen Zielwert bringt.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "line-of-sight",
    "inputs": {
      "antennaHeight1": 40,
      "antennaHeight2": 30,
      "kFactor": 1.3333333333333333,
      "pathLength": 30,
      "pointDistance": 15,
      "frequency": 6,
      "fresnelFraction": 0.6
    }
  }'

import rftools

client = rftools.Client()  # reads RFTOOLS_API_KEY, or the key `rftools login` saved

result = client.calculate("line-of-sight", {
    "antennaHeight1": 40,
    "antennaHeight2": 30,
    "kFactor": 1.3333333333333333,
    "pathLength": 30,
    "pointDistance": 15,
    "frequency": 6,
    "fresnelFraction": 0.6,
})
print(result.values)
print(result.warnings, result.provenance.formula_ref)

const response = await fetch("https://rftools.io/api/py/v1/calculate", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.RFTOOLS_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "slug": "line-of-sight",
    "inputs": {
      "antennaHeight1": 40,
      "antennaHeight2": 30,
      "kFactor": 1.3333333333333333,
      "pathLength": 30,
      "pointDistance": 15,
      "frequency": 6,
      "fresnelFraction": 0.6
    }
  }),
});
console.log(response.status, await response.json());

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	body := []byte(`{
	  "slug": "line-of-sight",
	  "inputs": {
	    "antennaHeight1": 40,
	    "antennaHeight2": 30,
	    "kFactor": 1.3333333333333333,
	    "pathLength": 30,
	    "pointDistance": 15,
	    "frequency": 6,
	    "fresnelFraction": 0.6
	  }
	}`)
	req, err := http.NewRequest("POST", "https://rftools.io/api/py/v1/calculate", bytes.NewReader(body))
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("RFTOOLS_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

application/json

{
  "slug": "line-of-sight",
  "values": {
    "maxLosDistance": 48.64472092771843,
    "horizon1": 26.068627377238972,
    "horizon2": 22.576093550479456,
    "bulge": 13.243603829854028,
    "fresnelRadius": 19.35821718289161,
    "requiredClearance": 24.858534139588993,
    "rayHeight": 21.756396170145972,
    "maxObstacleHeight": 10.141465860411007
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:line-of-sight",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "ITU-R P.526-15, Eqs. (2), (21) and (22); ITU-R P.530-17, §2.2.2; ITU-R P.834-9, §2",
    "assumptions": [
      {
        "code": "smooth-earth",
        "text": "The Earth is a smooth sphere of effective radius k × 6371 km; terrain, buildings and vegetation are not modelled."
      },
      {
        "code": "uniform-refraction",
        "text": "Refraction is a single k-factor along the whole path; ducting (negative or very large k) is not modelled."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "antennaHeight1": {
          "min": 0,
          "max": 10000,
          "unit": "m"
        },
        "antennaHeight2": {
          "min": 0,
          "max": 10000,
          "unit": "m"
        },
        "kFactor": {
          "min": 0.1,
          "max": null,
          "unit": ""
        },
        "pathLength": {
          "min": 0.001,
          "max": null,
          "unit": "km"
        },
        "pointDistance": {
          "min": 0,
          "max": null,
          "unit": "km"
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "GHz"
        },
        "fresnelFraction": {
          "min": 0,
          "max": null,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "antennaHeight1": 40,
      "antennaHeight2": 30,
      "kFactor": 1.3333333333333333,
      "pathLength": 30,
      "pointDistance": 15,
      "frequency": 6,
      "fresnelFraction": 0.6
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "antennaHeight1"
      ],
      "msg": "Input should be a valid number, unable to parse string as a number",
      "input": "abc"
    }
  ]
}

Eine als Text gesendete Eingabe. Es wurde nichts gezählt.

{
  "detail": "More than 120 requests in 60 seconds from this address.",
  "errorKind": "rate_limited",
  "limit": 120,
  "windowSeconds": 60,
  "upgradeUrl": "https://rftools.io/pricing/"
}

Zu viele Anfragen in einer Minute, mit Retry-After.

Dieselben Eingaben auf der RechnerseiteSichtlinien-Rechner — Funkhorizont und Erdwölbung, mit diesen Werten