Secciones de la documentación

Calculadora de acoplador direccional: impedancias de modo par e impar de líneas acopladas

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

Slug directional-coupler. Diseñe un acoplador direccional de líneas acopladas de cuarto de onda y una sola sección: las impedancias de modo par e impar para el acoplamiento que necesita, la longitud acoplada, la pérdida en el camino directo y el aislamiento, con un aviso cuando el acoplamiento es demasiado fuerte para una sola sección de acoplamiento por borde.

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 directional-coupler
Nombre	Unidad	Rango	Valor predeterminado	Descripción
couplingnúmero	dB	al menos 0.1	20	Relación entre la potencia de entrada y la potencia en el puerto acoplado, en dB (10 dB acopla una décima parte de la potencia)
z0número	Ω	al menos 1	50	Impedancia a la que está adaptado cada puerto
frequencynúmero	GHz	al menos 0.001	3	Frecuencia a la que la sección acoplada mide un cuarto de longitud de onda y el acoplamiento es máximo
effPermittivitynúmero	ninguna	al menos 1	2.2	Permitividad efectiva de la sección acoplada; igual a εr en stripline
directivitynúmero	dB	al menos 0	30	Potencia en el puerto acoplado dividida entre la potencia en el puerto aislado, en dB; la fijan el layout y el equilibrio de velocidades de los modos, no este diseño
couplingLimitnúmero	dB	al menos 0	8	Se señalan los acoplamientos más fuertes que este valor: una sola sección acoplada por los bordes necesitaría entonces una separación tan estrecha que no es práctica

Salidas

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

Salidas de directional-coupler
Campo	Unidad	Descripción
evenModeImpedanceprincipal	Ω	Impedancia de modo par
oddModeImpedance	Ω	Impedancia de modo impar
couplingFactor	ninguna	Factor de acoplamiento de tensión
throughLoss	dB	Pérdida en el trayecto directo (potencia extraída por acoplamiento)
isolation	dB	Aislamiento (I = C + D)
coupledLength	mm	Longitud acoplada (λ/4)

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": "directional-coupler",
    "inputs": {
      "coupling": 20,
      "z0": 50,
      "frequency": 3,
      "effPermittivity": 2.2,
      "directivity": 30,
      "couplingLimit": 8
    }
  }'

import rftools

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

result = client.calculate("directional-coupler", {
    "coupling": 20,
    "z0": 50,
    "frequency": 3,
    "effPermittivity": 2.2,
    "directivity": 30,
    "couplingLimit": 8,
})
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": "directional-coupler",
    "inputs": {
      "coupling": 20,
      "z0": 50,
      "frequency": 3,
      "effPermittivity": 2.2,
      "directivity": 30,
      "couplingLimit": 8
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "directional-coupler",
	  "inputs": {
	    "coupling": 20,
	    "z0": 50,
	    "frequency": 3,
	    "effPermittivity": 2.2,
	    "directivity": 30,
	    "couplingLimit": 8
	  }
	}`)
	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": "directional-coupler",
  "values": {
    "evenModeImpedance": 55.27707983925667,
    "oddModeImpedance": 45.22670168666455,
    "couplingFactor": 0.1,
    "throughLoss": 0.04364805402450088,
    "isolation": 50,
    "coupledLength": 16.843336162593108
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:directional-coupler",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Pozar, Microwave Engineering, 4th ed. (2012), §7.1, Eqs. (7.20)–(7.21), and §7.6, Eqs. (7.85)–(7.87)",
    "assumptions": [
      {
        "code": "equal-mode-velocities",
        "text": "The even and odd modes travel at the same phase velocity (TEM, as in stripline); in microstrip they do not, and the directivity is degraded."
      },
      {
        "code": "single-section",
        "text": "One quarter-wave coupled section, so the coupling is exact only at the centre frequency; losses are not modelled."
      }
    ],
    "validRange": {
      "status": "inside",
      "bounds": {
        "coupling": {
          "min": 0.1,
          "max": null,
          "unit": "dB"
        },
        "z0": {
          "min": 1,
          "max": null,
          "unit": "Ω"
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "GHz"
        },
        "effPermittivity": {
          "min": 1,
          "max": null,
          "unit": ""
        },
        "directivity": {
          "min": 0,
          "max": null,
          "unit": "dB"
        },
        "couplingLimit": {
          "min": 0,
          "max": null,
          "unit": "dB"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "coupling": 20,
      "z0": 50,
      "frequency": 3,
      "effPermittivity": 2.2,
      "directivity": 30,
      "couplingLimit": 8
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "coupling"
      ],
      "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 acoplador direccional: impedancias de modo par e impar de líneas acopladas, con estos valores