Seções da documentação

Conversor de ruído de fase para instabilidade

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

Slug phase-noise-to-jitter. Converta o ruído da fase do oscilador (dBc/Hz) em instabilidade RMS em ps e limite ADC SNR. Integre a faixa de frequência de compensação para o design do relógio. Resultados gratuitos e instantâneos.

Entradas

Envie cada uma destas em inputs, nas unidades mostradas. A maioria é obrigatória: uma chamada sem alguma delas é recusada (400) e não custa nada; uma entrada que a calculadora dispensa assume o padrão mostrado. Uma entrada fora da sua faixa ainda é calculada e sinalizada na procedência.

Entradas de phase-noise-to-jitter
Nome	Unidade	Faixa	Padrão	Descrição
carrierFreqnúmero	MHz	no mínimo 0.001	100	Frequência portadora do oscilador em MHz
phaseNoisenúmero	dBc/Hz	no máximo 0	-120	Densidade espectral do ruído de fase em banda lateral única num offset representativo
offsetFreqLownúmero	kHz	no mínimo 0.001	1	Limite inferior de integração da largura de banda do ruído de fase
offsetFreqHighnúmero	kHz	no mínimo 1	10000	Limite superior de integração da largura de banda do ruído de fase
profileModenúmero	nenhuma	0 … 1	0	O modo multiponto integra um perfil L(f) de quatro pontos em vez de um nível planoUm de: 0 Nível plano único · 1 Perfil multiponto
offset2número	kHz	no mínimo 0.001	10	Offset do ponto 2
pn2número	dBc/Hz	no máximo 0	-140	Ruído de fase do ponto 2
offset3número	kHz	no mínimo 0.001	100	Offset do ponto 3
pn3número	dBc/Hz	no máximo 0	-155	Ruído de fase do ponto 3
offset4número	kHz	no mínimo 0.001	1000	Offset do ponto 4
pn4número	dBc/Hz	no máximo 0	-165	Ruído de fase do ponto 4

Saídas

Devolvidas em values, pelo nome. Um valor ilimitado ou indefinido é null.

Saídas de phase-noise-to-jitter
Campo	Unidade	Descrição
rmsJitterprincipal	ps	Jitter RMS
cycleToCycleJitter	ps	Jitter de ciclo a ciclo
phaseNoisePower	dBc	Potência de ruído de fase integrada
rmsPhaseError	deg	Erro de fase RMS
adcSnrLimit	dB	Limite de SNR do ADC (jitter)
pointsIntegrated	nenhuma	Pontos do perfil integrados

Como chamar

Calcular: uma chamada, a requisição e a resposta completas, e os seus erros.
Lote: esta calculadora com outras, ou uma varredura, em uma requisição.
Resolver para um valor-alvo: o valor de uma entrada que leva uma saída a um alvo.

curl -X POST https://rftools.io/api/py/v1/calculate \
  -H "X-API-Key: $RFTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "slug": "phase-noise-to-jitter",
    "inputs": {
      "carrierFreq": 100,
      "phaseNoise": -120,
      "offsetFreqLow": 1,
      "offsetFreqHigh": 10000,
      "profileMode": 0,
      "offset2": 10,
      "pn2": -140,
      "offset3": 100,
      "pn3": -155,
      "offset4": 1000,
      "pn4": -165
    }
  }'

import rftools

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

result = client.calculate("phase-noise-to-jitter", {
    "carrierFreq": 100,
    "phaseNoise": -120,
    "offsetFreqLow": 1,
    "offsetFreqHigh": 10000,
    "profileMode": 0,
    "offset2": 10,
    "pn2": -140,
    "offset3": 100,
    "pn3": -155,
    "offset4": 1000,
    "pn4": -165,
})
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": "phase-noise-to-jitter",
    "inputs": {
      "carrierFreq": 100,
      "phaseNoise": -120,
      "offsetFreqLow": 1,
      "offsetFreqHigh": 10000,
      "profileMode": 0,
      "offset2": 10,
      "pn2": -140,
      "offset3": 100,
      "pn3": -155,
      "offset4": 1000,
      "pn4": -165
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "phase-noise-to-jitter",
	  "inputs": {
	    "carrierFreq": 100,
	    "phaseNoise": -120,
	    "offsetFreqLow": 1,
	    "offsetFreqHigh": 10000,
	    "profileMode": 0,
	    "offset2": 10,
	    "pn2": -140,
	    "offset3": 100,
	    "pn3": -155,
	    "offset4": 1000,
	    "pn4": -165
	  }
	}`)
	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": "phase-noise-to-jitter",
  "values": {
    "rmsJitter": 7.117269544002596,
    "cycleToCycleJitter": 10.065339116193446,
    "phaseNoisePower": -50.00043431619807,
    "rmsPhaseError": 0.2562217035840934,
    "adcSnrLimit": 46.990134359558255,
    "pointsIntegrated": 2
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:phase-noise-to-jitter",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "A Simple Model of Feedback Oscillator Noise Spectrum, D. B. Leeson, Proc. IEEE 54(2), pp. 329–330 (1966)",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "carrierFreq": {
          "min": 0.001,
          "max": null,
          "unit": "MHz"
        },
        "phaseNoise": {
          "min": null,
          "max": 0,
          "unit": "dBc/Hz"
        },
        "offsetFreqLow": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "offsetFreqHigh": {
          "min": 1,
          "max": null,
          "unit": "kHz"
        },
        "profileMode": {
          "min": 0,
          "max": 1,
          "unit": ""
        },
        "offset2": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "pn2": {
          "min": null,
          "max": 0,
          "unit": "dBc/Hz"
        },
        "offset3": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "pn3": {
          "min": null,
          "max": 0,
          "unit": "dBc/Hz"
        },
        "offset4": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "pn4": {
          "min": null,
          "max": 0,
          "unit": "dBc/Hz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "carrierFreq": 100,
      "phaseNoise": -120,
      "offsetFreqLow": 1,
      "offsetFreqHigh": 10000,
      "profileMode": 0,
      "offset2": 10,
      "pn2": -140,
      "offset3": 100,
      "pn3": -155,
      "offset4": 1000,
      "pn4": -165
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

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

Uma entrada enviada como texto. Nada foi contabilizado.

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

Requisições demais em um minuto, com Retry-After.

As mesmas entradas na página da calculadoraConversor de ruído de fase para instabilidade, com estes valores