Secciones de la documentación

Calculadora de Distorsión por Intermodulación

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

Slug intermodulation-distortion. Calcula productos de intermodulación de tercer orden (IMD3), punto de intercepción IP3 y rango dinámico.

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 intermodulation-distortion
Nombre	Unidad	Rango	Valor predeterminado	Descripción
outputPowernúmero	dBm	cualquiera	10	Potencia de salida fundamental por tono en dBm
inputPowernúmero	dBm	cualquiera	0	Potencia de excitación de entrada por tono en dBm
oip3número	dBm	cualquiera	30	Punto de intercepción de tercer orden de salida, de la hoja de datos
oip2número	dBm	cualquiera	50	Punto de intercepción de segundo orden de salida. Más alto = menos distorsión IM2.
freq1número	MHz	al menos 0.1	100	Frecuencia del primer tono de prueba para el análisis de dos tonos
freq2número	MHz	al menos 0.1	101	Frecuencia del segundo tono de prueba
bandLownúmero	MHz	al menos 0	88	Donde empieza la banda a la que no deben llegar los productos: una banda de recepción o el canal que se escucha
bandHighnúmero	MHz	al menos 0	108	Donde termina la banda

Salidas

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

Salidas de intermodulation-distortion
Campo	Unidad	Descripción
iip3	dBm	IP3 de entrada (IIP3)
im3Power	dBm	Potencia del producto IM3
im3Ratioprincipal	dBc	Relación entre IM3 y portadora
dynamicRange	dB	Rango dinámico libre de espurios
iip2	dBm	IP2 de entrada (IIP2)
im2Power	dBm	Potencia del producto IM2
im2Ratio	dBc	Relación entre IM2 y portadora
im3Low	MHz	IM3 bajo (2f₁−f₂)
im3High	MHz	IM3 alto (2f₂−f₁)
im2Sum	MHz	Suma IM2 (f₁+f₂)
im2Diff	MHz	Diferencia IM2 (\|f₁−f₂\|)
toneSpacing	MHz	Espaciado de tonos
productsInBand	ninguna	Productos en la banda

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": "intermodulation-distortion",
    "inputs": {
      "outputPower": 10,
      "inputPower": 0,
      "oip3": 30,
      "oip2": 50,
      "freq1": 100,
      "freq2": 101,
      "bandLow": 88,
      "bandHigh": 108
    }
  }'

import rftools

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

result = client.calculate("intermodulation-distortion", {
    "outputPower": 10,
    "inputPower": 0,
    "oip3": 30,
    "oip2": 50,
    "freq1": 100,
    "freq2": 101,
    "bandLow": 88,
    "bandHigh": 108,
})
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": "intermodulation-distortion",
    "inputs": {
      "outputPower": 10,
      "inputPower": 0,
      "oip3": 30,
      "oip2": 50,
      "freq1": 100,
      "freq2": 101,
      "bandLow": 88,
      "bandHigh": 108
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "intermodulation-distortion",
	  "inputs": {
	    "outputPower": 10,
	    "inputPower": 0,
	    "oip3": 30,
	    "oip2": 50,
	    "freq1": 100,
	    "freq2": 101,
	    "bandLow": 88,
	    "bandHigh": 108
	  }
	}`)
	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": "intermodulation-distortion",
  "values": {
    "iip3": 20,
    "im3Power": -30,
    "im3Ratio": -40,
    "dynamicRange": 122.66666666666666,
    "iip2": 40,
    "im2Power": -30,
    "im2Ratio": -40,
    "im3Low": 99,
    "im3High": 102,
    "im2Sum": 201,
    "im2Diff": 1,
    "toneSpacing": 1,
    "productsInBand": 2
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:intermodulation-distortion",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "RF Microelectronics, 2nd ed., Behzad Razavi (2011), Chapter 2, section 2.2 — Effects of nonlinearity",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "outputPower": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "inputPower": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "oip3": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "oip2": {
          "min": null,
          "max": null,
          "unit": "dBm"
        },
        "freq1": {
          "min": 0.1,
          "max": null,
          "unit": "MHz"
        },
        "freq2": {
          "min": 0.1,
          "max": null,
          "unit": "MHz"
        },
        "bandLow": {
          "min": 0,
          "max": null,
          "unit": "MHz"
        },
        "bandHigh": {
          "min": 0,
          "max": null,
          "unit": "MHz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "outputPower": 10,
      "inputPower": 0,
      "oip3": 30,
      "oip2": 50,
      "freq1": 100,
      "freq2": 101,
      "bandLow": 88,
      "bandHigh": 108
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "outputPower"
      ],
      "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 Distorsión por Intermodulación, con estos valores