Sections de la documentation

Calculateur de tolérance et d'erreur de fréquence Crystal PPM

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

Slug frequency-ppm-tolerance. Convertissez la tolérance cristalline en ppm en erreur de fréquence absolue en Hz. Insère la tolérance initiale, la stabilité de la température et le vieillissement dans les budgets les plus pessimistes et RSS, avec une dérive de l'horloge en secondes par jour.

Entrées

Envoyez chacune de ces entrées dans inputs, dans les unités indiquées. La plupart sont obligatoires : un appel auquel il en manque une est refusé (400) et ne coûte rien ; une entrée dont le calculateur peut se passer prend la valeur par défaut indiquée. Une entrée hors de sa plage est tout de même calculée et signalée dans la provenance.

Entrées de frequency-ppm-tolerance
Nom	Unité	Plage	Valeur par défaut	Description
nominalFrequencynombre	MHz	0.000001 … 1000	25	Fréquence marquée sur le quartz ou l'oscillateur.
initialTolerancenombre	ppm	0 … 1000	20	Précision de l'étalonnage à température ambiante, selon la fiche technique.
tempStabilitynombre	ppm	0 … 1000	15	Écart de fréquence sur toute la plage de température de fonctionnement.
agingPerYearnombre	ppm/yr	0 … 100	3	Dérive à long terme par an. Les quartz à coupe AT vieillissent généralement de 1 à 5 ppm la première année.
yearsnombre	years	0 … 30	3	Durée sur laquelle le vieillissement se cumule.

Sorties

Renvoyées dans values, par nom. Une valeur non bornée ou non définie vaut null.

Sorties de frequency-ppm-tolerance
Champ	Unité	Description
totalPpmWorstprincipale	ppm	Erreur totale (pire cas)
totalPpmRss	ppm	Erreur totale (RSS)
agingTotalPpm	ppm	Vieillissement cumulé
deviationHz	Hz	Écart de fréquence
fMinHz	Hz	Fréquence minimale
fMaxHz	Hz	Fréquence maximale
spanHz	Hz	Plage de fréquence totale
driftSecPerDay	s/day	Dérive d'horloge
driftMinPerYear	min/year	Dérive d'horloge

Comment l'appeler

Calculer : un appel, la requête et la réponse complètes, et ses erreurs.
Calcul par lots : ce calculateur avec d'autres, ou un balayage, en une seule requête.
Résoudre pour une valeur cible : la valeur d'une entrée qui amène une sortie à une cible.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "frequency-ppm-tolerance",
    "inputs": {
      "nominalFrequency": 25,
      "initialTolerance": 20,
      "tempStability": 15,
      "agingPerYear": 3,
      "years": 3
    }
  }'

import rftools

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

result = client.calculate("frequency-ppm-tolerance", {
    "nominalFrequency": 25,
    "initialTolerance": 20,
    "tempStability": 15,
    "agingPerYear": 3,
    "years": 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": "frequency-ppm-tolerance",
    "inputs": {
      "nominalFrequency": 25,
      "initialTolerance": 20,
      "tempStability": 15,
      "agingPerYear": 3,
      "years": 3
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "frequency-ppm-tolerance",
	  "inputs": {
	    "nominalFrequency": 25,
	    "initialTolerance": 20,
	    "tempStability": 15,
	    "agingPerYear": 3,
	    "years": 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": "frequency-ppm-tolerance",
  "values": {
    "totalPpmWorst": 44,
    "totalPpmRss": 26.570660511172846,
    "agingTotalPpm": 9,
    "deviationHz": 1100,
    "fMinHz": 24998900,
    "fMaxHz": 25001100,
    "spanHz": 2200,
    "driftSecPerDay": 3.8016,
    "driftMinPerYear": 23.1264
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:frequency-ppm-tolerance",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IEEE 177 quartz resonator definitions; typical AT-cut crystal datasheet parameters",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "nominalFrequency": {
          "min": 0.000001,
          "max": 1000,
          "unit": "MHz"
        },
        "initialTolerance": {
          "min": 0,
          "max": 1000,
          "unit": "ppm"
        },
        "tempStability": {
          "min": 0,
          "max": 1000,
          "unit": "ppm"
        },
        "agingPerYear": {
          "min": 0,
          "max": 100,
          "unit": "ppm/yr"
        },
        "years": {
          "min": 0,
          "max": 30,
          "unit": "years"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "nominalFrequency": 25,
      "initialTolerance": 20,
      "tempStability": 15,
      "agingPerYear": 3,
      "years": 3
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

Une entrée envoyée sous forme de texte. Rien n'a été décompté.

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

Trop de requêtes en une minute, avec Retry-After.

Les mêmes entrées sur la page du calculateurCalculateur de tolérance et d'erreur de fréquence Crystal PPM, avec ces valeurs