Secciones de la documentación

Calculadora de inclinación de antena (downtilt)

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

Slug antenna-downtilt. Calcule la inclinación hacia abajo que sitúa el borde superior de media potencia del haz de una antena sectorial en el borde de la celda, la huella del haz de media potencia en el suelo y la ganancia hacia el borde de la celda con el diagrama vertical de 3GPP, incluida la curvatura de la Tierra.

Entradas

Envíe cada una de estas en inputs, en las unidades indicadas. La mayoría son obligatorias: una llamada a la que le falte una se rechaza (400) y no cuesta nada; una de la que la calculadora puede prescindir toma el valor predeterminado indicado. Una entrada fuera de su rango se calcula igualmente y se marca en la procedencia.

Entradas de antenna-downtilt
Nombre	Unidad	Rango	Valor predeterminado	Descripción
antennaHeightnúmero	m	al menos 0.1	30	Altura del centro de la antena sobre el suelo
ueHeightnúmero	m	al menos 0	1.5	Altura del teléfono o terminal sobre el suelo
cellEdgenúmero	m	al menos 1	1000	Distancia sobre el terreno desde el mástil hasta el borde de la celda
verticalBeamwidthnúmero	°	0.1 … 179	7	Ancho de haz vertical a media potencia de la hoja de datos de la antena
kFactornúmero	ninguna	al menos 0.1	1.3333333333333333	k = 4/3 para la atmósfera estándar
appliedTiltnúmero	°	−90 … 90	5	Inclinación total realmente ajustada (eléctrica más mecánica), para la huella y la ganancia en el borde

Salidas

Se devuelven en values, por nombre. Un valor ilimitado o no definido es null.

Salidas de antenna-downtilt
Campo	Unidad	Descripción
recommendedTiltprincipal	°	Inclinación recomendada (downtilt)
depressionAngle	°	Ángulo de depresión al borde de la celda
innerEdge	m	Borde interior a media potencia (inclinación recomendada)
appliedInnerEdge	m	Borde interior a media potencia (inclinación aplicada)
appliedOuterEdge	m	Borde exterior a media potencia (inclinación aplicada)
edgeGain	dB	Ganancia relativa hacia el borde de la celda (inclinación aplicada)
losDistance	km	Distancia con línea de vista

Cómo llamarla

Calcular: una llamada, la solicitud y la respuesta completas, y sus errores.
Cálculo por lotes: esta calculadora con otras, o un barrido, en una sola solicitud.
Resolver para un valor objetivo: el valor de una entrada que lleva una salida a un objetivo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "antenna-downtilt",
    "inputs": {
      "antennaHeight": 30,
      "ueHeight": 1.5,
      "cellEdge": 1000,
      "verticalBeamwidth": 7,
      "kFactor": 1.3333333333333333,
      "appliedTilt": 5
    }
  }'

import rftools

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

result = client.calculate("antenna-downtilt", {
    "antennaHeight": 30,
    "ueHeight": 1.5,
    "cellEdge": 1000,
    "verticalBeamwidth": 7,
    "kFactor": 1.3333333333333333,
    "appliedTilt": 5,
})
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": "antenna-downtilt",
    "inputs": {
      "antennaHeight": 30,
      "ueHeight": 1.5,
      "cellEdge": 1000,
      "verticalBeamwidth": 7,
      "kFactor": 1.3333333333333333,
      "appliedTilt": 5
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "antenna-downtilt",
	  "inputs": {
	    "antennaHeight": 30,
	    "ueHeight": 1.5,
	    "cellEdge": 1000,
	    "verticalBeamwidth": 7,
	    "kFactor": 1.3333333333333333,
	    "appliedTilt": 5
	  }
	}`)
	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": "antenna-downtilt",
  "values": {
    "recommendedTilt": 5.135857529058267,
    "depressionAngle": 1.635857529058267,
    "innerEdge": 187.66674981063792,
    "appliedInnerEdge": 190.71227737998746,
    "appliedOuterEdge": 1091.0468217457628,
    "edgeGain": -2.771621526071988,
    "losDistance": 27.624261535006116
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:antenna-downtilt",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "3GPP TR 38.901 V17.0.0, Table 7.3-1; ITU-R P.526-15, Eqs. (21) and (44); ITU-R P.834-9, §2",
    "assumptions": [
      {
        "code": "smooth-earth",
        "text": "The ground is a smooth sphere of effective radius k × 6371 km; terrain and clutter are not modelled."
      },
      {
        "code": "3gpp-vertical-pattern",
        "text": "The vertical pattern is the parabolic main lobe with a 30 dB floor of 3GPP TR 38.901 Table 7.3-1, with the reader's half-power beamwidth."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "antennaHeight": {
          "min": 0.1,
          "max": null,
          "unit": "m"
        },
        "ueHeight": {
          "min": 0,
          "max": null,
          "unit": "m"
        },
        "cellEdge": {
          "min": 1,
          "max": null,
          "unit": "m"
        },
        "verticalBeamwidth": {
          "min": 0.1,
          "max": 179,
          "unit": "°"
        },
        "kFactor": {
          "min": 0.1,
          "max": null,
          "unit": ""
        },
        "appliedTilt": {
          "min": -90,
          "max": 90,
          "unit": "°"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "antennaHeight": 30,
      "ueHeight": 1.5,
      "cellEdge": 1000,
      "verticalBeamwidth": 7,
      "kFactor": 1.3333333333333333,
      "appliedTilt": 5
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

Una entrada enviada como texto. No se contó nada.

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

Demasiadas solicitudes en un minuto, con Retry-After.

Las mismas entradas en la página de la calculadoraCalculadora de inclinación de antena (downtilt), con estos valores