Seções da documentação

Calculadora de diâmetro máximo da almofada

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

Slug maximum-pad-diameter. Encontre a maior almofada que se ajusta à inclinação de um componente enquanto mantém a folga do fabricante, com ou sem condutores roteados entre as almofadas adjacentes.

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 maximum-pad-diameter
Nome	Unidade	Faixa	Padrão	Descrição
pitchnúmero	mm	0.1 … 10	1.27	Passo (centro a centro)
minClearancenúmero	mm	0.01 … 1	0.15	Folga mínima
tracesBetweennúmero	nenhuma	0 … 4	0	Condutores roteados entre pads
traceWidthnúmero	mm	no mínimo 0.01	0.15	Ignorada quando nenhum condutor passa entre os pads

Saídas

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

Saídas de maximum-pad-diameter
Campo	Unidade	Descrição
maxPadDiameterprincipal	mm	Diâmetro máximo do pad
clearanceDemand	mm	Folga consumida
copperBetween	mm	Cobre dos condutores entre pads
remainingGap	mm	Espaço entre as bordas dos pads
padToPitchRatio	nenhuma	Pad como fração do passo
fits	nenhuma	Geometria cabe

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": "maximum-pad-diameter",
    "inputs": {
      "pitch": 1.27,
      "minClearance": 0.15,
      "tracesBetween": 0,
      "traceWidth": 0.15
    }
  }'

import rftools

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

result = client.calculate("maximum-pad-diameter", {
    "pitch": 1.27,
    "minClearance": 0.15,
    "tracesBetween": 0,
    "traceWidth": 0.15,
})
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": "maximum-pad-diameter",
    "inputs": {
      "pitch": 1.27,
      "minClearance": 0.15,
      "tracesBetween": 0,
      "traceWidth": 0.15
    }
  }),
});
console.log(response.status, await response.json());

package main

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

func main() {
	body := []byte(`{
	  "slug": "maximum-pad-diameter",
	  "inputs": {
	    "pitch": 1.27,
	    "minClearance": 0.15,
	    "tracesBetween": 0,
	    "traceWidth": 0.15
	  }
	}`)
	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": "maximum-pad-diameter",
  "values": {
    "maxPadDiameter": 1.12,
    "clearanceDemand": 0.15,
    "copperBetween": 0,
    "remainingGap": 0.1499999999999999,
    "padToPitchRatio": 0.8818897637795277,
    "fits": 1
  },
  "warnings": [
    "The pad occupies most of the pitch — there is no room left to route between these pads on this layer"
  ],
  "errors": [],
  "provenance": {
    "method": "calculator:maximum-pad-diameter",
    "version": "api@3f2c1a9b04de",
    "formulaRef": "IPC-2221B clearance practice; the clearance value is a fabricator rule supplied as an input.",
    "assumptions": [],
    "validRange": {
      "status": "inside",
      "bounds": {
        "pitch": {
          "min": 0.1,
          "max": 10,
          "unit": "mm"
        },
        "minClearance": {
          "min": 0.01,
          "max": 1,
          "unit": "mm"
        },
        "tracesBetween": {
          "min": 0,
          "max": 4,
          "unit": ""
        },
        "traceWidth": {
          "min": 0.01,
          "max": null,
          "unit": "mm"
        }
      },
      "outside": [],
      "model": null
    },
    "computedAt": "2026-09-24T14:05:11.003Z",
    "inputs": {
      "pitch": 1.27,
      "minClearance": 0.15,
      "tracesBetween": 0,
      "traceWidth": 0.15
    },
    "seed": null,
    "elapsedSeconds": 0.003
  }
}

{
  "detail": [
    {
      "type": "float_parsing",
      "loc": [
        "body",
        "inputs",
        "pitch"
      ],
      "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 diâmetro máximo da almofada, com estes valores