Seções da documentação

Calculadora de índice de modulação FM

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

Slug fm-modulation-index. Calcule o índice de modulação FM, o desvio de frequência e a largura de banda usando a regra de Carson.

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 fm-modulation-index
Nome	Unidade	Faixa	Padrão	Descrição
frequencyDeviationnúmero	kHz	no mínimo 0.001	75	Desvio de frequência de pico do sinal FM
messageFreqnúmero	kHz	no mínimo 0.001	15	Frequência mais alta do sinal modulante
channelLownúmero	kHz	no mínimo 0	98000	Onde começa o canal em que a emissão deve caber; a portadora fica no seu centro. Os canais de radiodifusão FM têm 200 kHz de largura, de 88,1 a 107,9 MHz (47 CFR 73.201)
channelHighnúmero	kHz	no mínimo 0	98200	Onde o canal termina

Descontinuadas, ainda aceitas e ignoradas com um aviso: carrierFreq (Carrier Frequency, 12 de outubro de 2026).

Saídas

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

Saídas de fm-modulation-index
Campo	Unidade	Descrição
modulationIndexprincipal	nenhuma	Índice de modulação (β)
carsonBandwidth	kHz	Largura de banda da regra de Carson
besselBandwidth	kHz	Largura de banda de Bessel
snrImprovement	dB	Melhoria do SNR
occupiedBandwidth	kHz	Largura de banda ocupada (99%)
powerInChannel	%	Potência no canal
sidebandsInChannel	nenhuma	Bandas laterais significativas no canal
sidebandsOutside	nenhuma	Bandas laterais significativas fora do canal

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": "fm-modulation-index",
    "inputs": {
      "frequencyDeviation": 75,
      "messageFreq": 15,
      "channelLow": 98000,
      "channelHigh": 98200
    }
  }'

import rftools

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

result = client.calculate("fm-modulation-index", {
    "frequencyDeviation": 75,
    "messageFreq": 15,
    "channelLow": 98000,
    "channelHigh": 98200,
})
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": "fm-modulation-index",
    "inputs": {
      "frequencyDeviation": 75,
      "messageFreq": 15,
      "channelLow": 98000,
      "channelHigh": 98200
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "fm-modulation-index",
	  "inputs": {
	    "frequencyDeviation": 75,
	    "messageFreq": 15,
	    "channelLow": 98000,
	    "channelHigh": 98200
	  }
	}`)
	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": "fm-modulation-index",
  "values": {
    "modulationIndex": 5,
    "carsonBandwidth": 180,
    "besselBandwidth": 240,
    "snrImprovement": 26.532125137753436,
    "occupiedBandwidth": 180,
    "powerInChannel": 99.35588993208525,
    "sidebandsInChannel": 12,
    "sidebandsOutside": 4
  },
  "warnings": [],
  "errors": [],
  "provenance": {
    "method": "calculator:fm-modulation-index",
    "version": "api@3f2c1a9b04de",
    "formulaRef": null,
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "frequencyDeviation": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "messageFreq": {
          "min": 0.001,
          "max": null,
          "unit": "kHz"
        },
        "channelLow": {
          "min": 0,
          "max": null,
          "unit": "kHz"
        },
        "channelHigh": {
          "min": 0,
          "max": null,
          "unit": "kHz"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "frequencyDeviation": 75,
      "messageFreq": 15,
      "channelLow": 98000,
      "channelHigh": 98200
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "frequencyDeviation"
      ],
      "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 calculadoraCalculadora de índice de modulação FM, com estes valores