Abschnitte der Dokumentation

5G-NR-Linkbudget-Rechner — Pfadverlust nach 3GPP TR 38.901, SINR und Reichweite

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

Slug 5g-nr-link-budget. Ein 5G-NR-Linkbudget auf Basis der 3GPP-Kanalmodelle: Pfadverlust nach TR 38.901 für ländliche Makrozelle, städtische Makrozelle, städtische Mikrozelle und Indoor-Büro, LOS oder NLOS, das Grundrauschen aus den Ressourcenblöcken, SINR, Linkreserve, die maximale Reichweite innerhalb der Modellgültigkeit und die Spitzendatenrate nach TS 38.306.

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 5g-nr-link-budget
Name	Einheit	Bereich	Standardwert	Beschreibung
scenarioZahl	keine	0 … 3	1	Einsatzszenario nach 3GPP TR 38.901: 0 ländliche Makrozelle, 1 städtische Makrozelle, 2 städtische Mikrozelle (Straßenschlucht), 3 Indoor-Büro
lineOfSightZahl	keine	0 … 1	0	Ob der direkte Pfad frei ist; bei NLOS gilt der größere Wert aus LOS- und NLOS-Formel
frequencyZahl	GHz	mindestens 0.1	3.5	Mittenfrequenz; TR 38.901 deckt 0,5 bis 100 GHz ab (30 GHz für RMa)
channelBandwidthZahl	MHz	mindestens 3	100	Kanalbandbreite des UE; legt die Ressourcenblöcke und damit die Rauschbandbreite fest
scsZahl	kHz	mindestens 15	30	15, 30 oder 60 kHz in FR1; 60 oder 120 kHz in FR2
bsHeightZahl	m	mindestens 1	25	TR 38.901 legt 25 m für UMa und 10 m für UMi fest; RMa deckt 10 bis 150 m ab
utHeightZahl	m	mindestens 0.5	1.5	Höhe des Endgeräts; 1,5 m auf Straßenniveau
distanceZahl	m	mindestens 1	500	Bodenentfernung von der Basisstation zum Nutzer
txPowerZahl	dBm	beliebig	46	Gesamte leitungsgebundene Leistung über den Träger (46 dBm sind 40 W)
txGainZahl	dBi	beliebig	17	Gewinn der Sendeantenne
rxGainZahl	dBi	beliebig	0	Gewinn der Empfangsantenne
lossesZahl	dB	mindestens 0	3	Kabel-, Körper- und sonstige Verluste
shadowMarginZahl	dB	mindestens 0	8	Für Abschattung zurückgehaltene Reserve; vergleichen Sie mit der Ausgabe σ_SF des Szenarios
noiseFigureZahl	dB	mindestens 0	7	Rauschzahl des Empfängers
requiredSinrZahl	dB	beliebig	0	SINR, das die gewählte Modulation und Codierung benötigt
interferenceMarginZahl	dB	mindestens 0	3	Anstieg von Rauschen plus Interferenz über das thermische Rauschen
layersZahl	keine	1 … 8	4	MIMO-Layer
modulationOrderZahl	keine	1 … 10	8	Modulationsordnung (Bits pro Symbol)
scalingFactorZahl	keine	0.1 … 1	1	Skalierungsfaktor der UE-Capability in TS 38.306: 1; 0,8; 0,75 oder 0,4
linkDirectionZahl	keine	0 … 1	0	Legt den Overhead nach TS 38.306 fest: 0,14 DL und 0,08 UL in FR1, 0,18 und 0,10 in FR2
extraLossCountZahl	keine	0 … 6	0	Wie viele weitere Verluste die Strecke enthält, etwa Gebäudedurchdringung, Bewuchs, Körper oder Polarisationsfehlanpassung (0–6)
extraLoss1Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss2Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss3Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss4Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss5Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung
extraLoss6Zahl	dB	0 … 50	0	Ein weiterer Verlust auf der Strecke, etwa Gebäudedurchdringung, Bewuchs, Körperdämpfung oder Polarisationsfehlanpassung

Ausgaben

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

Ausgaben von 5g-nr-link-budget
Feld	Einheit	Beschreibung
linkMarginHauptwert	dB	Linkreserve
pathLoss	dB	Pfadverlust (TR 38.901)
receivedPower	dBm	Empfangsleistung
sinr	dB	SINR (Median)
maxPathLoss	dB	Maximal zulässiger Pfadverlust
maxRange	m	Maximale Reichweite (2D, innerhalb der Modellgültigkeit)
resourceBlocks	keine	Ressourcenblöcke (N_RB)
occupiedBandwidth	MHz	Belegte Bandbreite (N_RB × 12 × SCS)
thermalNoise	dBm	Thermisches Rauschen (kTB)
noiseFloor	dBm	Grundrauschen des Empfängers (kTB + NF)
breakpointDistance	m	Breakpoint-Distanz
shadowFadingStd	dB	Shadow-Fading-Standardabweichung (σ_SF)
peakDataRate	Mbps	Spitzendatenrate (TS 38.306)
totalLoss	dB	Gesamtverlust

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": "5g-nr-link-budget",
    "inputs": {
      "scenario": 1,
      "lineOfSight": 0,
      "frequency": 3.5,
      "channelBandwidth": 100,
      "scs": 30,
      "bsHeight": 25,
      "utHeight": 1.5,
      "distance": 500,
      "txPower": 46,
      "txGain": 17,
      "rxGain": 0,
      "losses": 3,
      "shadowMargin": 8,
      "noiseFigure": 7,
      "requiredSinr": 0,
      "interferenceMargin": 3,
      "layers": 4,
      "modulationOrder": 8,
      "scalingFactor": 1,
      "linkDirection": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "extraLoss5": 0,
      "extraLoss6": 0
    }
  }'

import rftools

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

result = client.calculate("5g-nr-link-budget", {
    "scenario": 1,
    "lineOfSight": 0,
    "frequency": 3.5,
    "channelBandwidth": 100,
    "scs": 30,
    "bsHeight": 25,
    "utHeight": 1.5,
    "distance": 500,
    "txPower": 46,
    "txGain": 17,
    "rxGain": 0,
    "losses": 3,
    "shadowMargin": 8,
    "noiseFigure": 7,
    "requiredSinr": 0,
    "interferenceMargin": 3,
    "layers": 4,
    "modulationOrder": 8,
    "scalingFactor": 1,
    "linkDirection": 0,
    "extraLossCount": 0,
    "extraLoss1": 0,
    "extraLoss2": 0,
    "extraLoss3": 0,
    "extraLoss4": 0,
    "extraLoss5": 0,
    "extraLoss6": 0,
})
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": "5g-nr-link-budget",
    "inputs": {
      "scenario": 1,
      "lineOfSight": 0,
      "frequency": 3.5,
      "channelBandwidth": 100,
      "scs": 30,
      "bsHeight": 25,
      "utHeight": 1.5,
      "distance": 500,
      "txPower": 46,
      "txGain": 17,
      "rxGain": 0,
      "losses": 3,
      "shadowMargin": 8,
      "noiseFigure": 7,
      "requiredSinr": 0,
      "interferenceMargin": 3,
      "layers": 4,
      "modulationOrder": 8,
      "scalingFactor": 1,
      "linkDirection": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "extraLoss5": 0,
      "extraLoss6": 0
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "5g-nr-link-budget",
	  "inputs": {
	    "scenario": 1,
	    "lineOfSight": 0,
	    "frequency": 3.5,
	    "channelBandwidth": 100,
	    "scs": 30,
	    "bsHeight": 25,
	    "utHeight": 1.5,
	    "distance": 500,
	    "txPower": 46,
	    "txGain": 17,
	    "rxGain": 0,
	    "losses": 3,
	    "shadowMargin": 8,
	    "noiseFigure": 7,
	    "requiredSinr": 0,
	    "interferenceMargin": 3,
	    "layers": 4,
	    "modulationOrder": 8,
	    "scalingFactor": 1,
	    "linkDirection": 0,
	    "extraLossCount": 0,
	    "extraLoss1": 0,
	    "extraLoss2": 0,
	    "extraLoss3": 0,
	    "extraLoss4": 0,
	    "extraLoss5": 0,
	    "extraLoss6": 0
	  }
	}`)
	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": "5g-nr-link-budget",
  "values": {
    "linkMargin": 6.134701907799126,
    "pathLoss": 129.9158338083485,
    "receivedPower": -69.91583380834851,
    "sinr": 14.13470190779914,
    "maxPathLoss": 136.05053571614764,
    "maxRange": 718.1162910484755,
    "resourceBlocks": 273,
    "occupiedBandwidth": 98.28,
    "thermalNoise": -94.05053571614765,
    "noiseFloor": -87.05053571614765,
    "breakpointDistance": 560.3876799328955,
    "shadowFadingStd": 6,
    "peakDataRate": 2337.00012,
    "totalLoss": 132.9158338083485
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:5g-nr-link-budget",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "3GPP TR 38.901 V17.0.0, Table 7.4.1-1; TS 38.101-1 V18.15.0 Table 5.3.2-1; TS 38.306 V18.11.0, §4.1.2",
    "assumptions": [
      {
        "code": "tr38901-median-path-loss",
        "text": "Path loss is the median of the 3GPP TR 38.901 V17.0.0 Table 7.4.1-1 model for the chosen scenario and line-of-sight state; shadowing is covered only by the margin entered, and the LOS probability is not applied."
      },
      {
        "code": "effective-environment-height",
        "text": "UMa and UMi use an effective environment height of 1 m, and RMa the default building height of 5 m and street width of 20 m."
      },
      {
        "code": "exact-speed-of-light",
        "text": "Breakpoint distances use c = 299792458 m/s, where TR 38.901 writes 3.0×10⁸ m/s."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "scenario": {
          "min": 0,
          "max": 3,
          "unit": ""
        },
        "lineOfSight": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "frequency": {
          "min": 0.1,
          "max": null,
          "unit": "GHz"
        },
        "channelBandwidth": {
          "min": 3,
          "max": null,
          "unit": "MHz"
        },
        "scs": {
          "min": 15,
          "max": null,
          "unit": "kHz"
        },
        "bsHeight": {
          "min": 1,
          "max": null,
          "unit": "m"
        },
        "utHeight": {
          "min": 0.5,
          "max": null,
          "unit": "m"
        },
        "distance": {
          "min": 1,
          "max": null,
          "unit": "m"
        },
        "txPower": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "txGain": {
          "min": null,
          "max": null,
          "unit": "dBi"
        },
        "rxGain": {
          "min": null,
          "max": null,
          "unit": "dBi"
        },
        "losses": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "shadowMargin": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "noiseFigure": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "requiredSinr": {
          "min": null,
          "max": null,
          "unit": "dB"
        },
        "interferenceMargin": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "layers": {
          "min": 1,
          "max": 8,
          "unit": ""
        },
        "modulationOrder": {
          "min": 1,
          "max": 10,
          "unit": ""
        },
        "scalingFactor": {
          "min": 0.1,
          "max": 1,
          "unit": ""
        },
        "linkDirection": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "extraLossCount": {
          "min": 0,
          "max": 6,
          "unit": ""
        },
        "extraLoss1": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss2": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss3": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss4": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss5": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        },
        "extraLoss6": {
          "min": 0,
          "max": 50,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "scenario": 1,
      "lineOfSight": 0,
      "frequency": 3.5,
      "channelBandwidth": 100,
      "scs": 30,
      "bsHeight": 25,
      "utHeight": 1.5,
      "distance": 500,
      "txPower": 46,
      "txGain": 17,
      "rxGain": 0,
      "losses": 3,
      "shadowMargin": 8,
      "noiseFigure": 7,
      "requiredSinr": 0,
      "interferenceMargin": 3,
      "layers": 4,
      "modulationOrder": 8,
      "scalingFactor": 1,
      "linkDirection": 0,
      "extraLossCount": 0,
      "extraLoss1": 0,
      "extraLoss2": 0,
      "extraLoss3": 0,
      "extraLoss4": 0,
      "extraLoss5": 0,
      "extraLoss6": 0
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "scenario"
      ],
      "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 Rechnerseite5G-NR-Linkbudget-Rechner — Pfadverlust nach 3GPP TR 38.901, SINR und Reichweite, mit diesen Werten