Secciones de la documentación

Calculadora de Error de Medición de Pérdida de Retorno

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

Slug return-loss-error. Calcula la incertidumbre de medición para pérdida de retorno usando acopladores direccionales o puentes.

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 return-loss-error
Nombre	Unidad	Rango	Valor predeterminado	Descripción
dutReturnLossnúmero	dB	0 … 60	20	Pérdida de retorno del dispositivo sometido a prueba
directivitynúmero	dB	10 … 60	35	Directividad del acoplador direccional o puente utilizado para la medición
sourceMatchnúmero	dB	10 … 60	30	Pérdida de retorno del puerto fuente de medición (qué tan bien coincide la fuente)
targetUncertaintynúmero	dB	0.01 … 30	3	La mayor incertidumbre de rentabilidad-pérdida que pueda tener la medición. El estado falla por encima de 6 dB.

Salidas

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

Salidas de return-loss-error
Campo	Unidad	Descripción
rlMax	dB	URL en el mejor de los casos
rlMin	dB	URL en el peor de los casos
uncertaintyDbprincipal	dB	Incertidumbre de medición
dirError	dB	Error de directividad

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": "return-loss-error",
    "inputs": {
      "dutReturnLoss": 20,
      "directivity": 35,
      "sourceMatch": 30,
      "targetUncertainty": 3
    }
  }'

import rftools

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

result = client.calculate("return-loss-error", {
    "dutReturnLoss": 20,
    "directivity": 35,
    "sourceMatch": 30,
    "targetUncertainty": 3,
})
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": "return-loss-error",
    "inputs": {
      "dutReturnLoss": 20,
      "directivity": 35,
      "sourceMatch": 30,
      "targetUncertainty": 3
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "return-loss-error",
	  "inputs": {
	    "dutReturnLoss": 20,
	    "directivity": 35,
	    "sourceMatch": 30,
	    "targetUncertainty": 3
	  }
	}`)
	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": "return-loss-error",
  "values": {
    "rlMax": 21.73421822963028,
    "rlMin": 18.55507398672743,
    "uncertaintyDb": 3.1791442429028507,
    "dirError": 1.421637052990647
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:return-loss-error",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Agilent AN 1287-3: Applying Error Correction to VNA Measurements",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "dutReturnLoss": {
          "min": 0,
          "max": 60,
          "unit": "dB"
        },
        "directivity": {
          "min": 10,
          "max": 60,
          "unit": "dB"
        },
        "sourceMatch": {
          "min": 10,
          "max": 60,
          "unit": "dB"
        },
        "targetUncertainty": {
          "min": 0.01,
          "max": 30,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "dutReturnLoss": 20,
      "directivity": 35,
      "sourceMatch": 30,
      "targetUncertainty": 3
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "dutReturnLoss"
      ],
      "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 Error de Medición de Pérdida de Retorno, con estos valores