Abschnitte der Dokumentation

Q-Faktor-Rechner für Induktoren und Kondensatoren

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

Slug q-factor. Berechnen Sie den Qualitätsfaktor (Q) für Induktoren und Kondensatoren aus ESR und Frequenz. Bestimmen Sie die Resonanzbandbreite und die Frequenzen mit halber Leistung. Kostenlose, sofortige Ergebnisse.

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 q-factor
Name	Einheit	Bereich	Standardwert	Beschreibung
componentTypeZahl	keine	0 … 1	0	Art der KomponenteEiner von: 0 Induktor · 1 Kondensator
valueZahl	μH / nF	mindestens 0.001	10	Induktivität/Kapazität
esrZahl	Ω	mindestens 0.001	0.5	Äquivalenter Serienwiderstand aus Datenblatt
frequencyZahl	MHz	mindestens 0.001	10	Frequenz
targetQZahl	keine	1 … 10000	50	Den Qualitätsfaktor, den das Bauteil erreichen muss, beispielsweise bei einer Filterkonstruktion. Der Status fällt unter 10 aus.

Ausgaben

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

Ausgaben von q-factor
Feld	Einheit	Beschreibung
qFactorHauptwert	keine	Q-Faktor
reactance	Ω	Reaktanz
bandwidth	kHz	Bandbreite
halfPowerFreqLow	MHz	Niedrigere Frequenz mit halber Leistung
halfPowerFreqHigh	MHz	Obere Frequenz mit halber Leistung

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": "q-factor",
    "inputs": {
      "componentType": 0,
      "value": 10,
      "esr": 0.5,
      "frequency": 10,
      "targetQ": 50
    }
  }'

import rftools

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

result = client.calculate("q-factor", {
    "componentType": 0,
    "value": 10,
    "esr": 0.5,
    "frequency": 10,
    "targetQ": 50,
})
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": "q-factor",
    "inputs": {
      "componentType": 0,
      "value": 10,
      "esr": 0.5,
      "frequency": 10,
      "targetQ": 50
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "q-factor",
	  "inputs": {
	    "componentType": 0,
	    "value": 10,
	    "esr": 0.5,
	    "frequency": 10,
	    "targetQ": 50
	  }
	}`)
	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": "q-factor",
  "values": {
    "qFactor": 1256.6370614359173,
    "reactance": 628.3185307179587,
    "bandwidth": 7.957747154594767,
    "halfPowerFreqLow": 9.996021126422702,
    "halfPowerFreqHigh": 10.003978873577298
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:q-factor",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "Microwave Engineering, 4th ed., David M. Pozar (2011), Chapter 6.1 — Quality factor and resonator loss",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "componentType": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "value": {
          "min": 0.001,
          "max": null,
          "unit": "μH / nF"
        },
        "esr": {
          "min": 0.001,
          "max": null,
          "unit": "Ω"
        },
        "frequency": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "targetQ": {
          "min": 1,
          "max": 10000,
          "unit": ""
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "componentType": 0,
      "value": 10,
      "esr": 0.5,
      "frequency": 10,
      "targetQ": 50
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "componentType"
      ],
      "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 RechnerseiteQ-Faktor-Rechner für Induktoren und Kondensatoren, mit diesen Werten