---
title: "Ct Sizing"
method: POST
path: "/api/v1/tools/ct/sizing"
tags: ["ferramentas"]
---

# Ct Sizing

`POST /api/v1/tools/ct/sizing`

## Request

- Base URL: `https://app.estudoseletricos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.estudoseletricos.com/api/v1/tools/ct/sizing`
- Auth: none declared

## Request body

- TcIn: Dimensionamento de TC de proteção (IEC 61869-2) — `ct_sizing.size_ct` e as verificações que decidem junto: robustez ao curto, saturação pela componente CC e, quando há núcleo de medição, a classe de exatidão. ESCOPO desta rota: o dimensionamento, as três verificações acima e — pelos blocos `psrc` e `partida` — a falta e a partida de motor NO TEMPO (IEEE PSRC), com as figuras do memorial (G202) — e, pelo bloco `diferencial`, a estabilidade do 87T de dois núcleos na falta passante (G203).
  - `Icc_A` number, required: corrente de curto no primário (A)
  - `Isn_A` 1 | 5: secundário nominal (A)
  - `classe` '5P' | '10P'
  - `ALF` number: fator-limite de exatidão nominal
  - `burden_VA` number: carga nominal do TC
  - `relay_ohm` number: impedância do relé
  - `cable_ohm_km` number: Ω/km do cabo de controle
  - `dist_m` number: distância até o relé
  - `loop` boolean: ida e volta (laço) no cabo
  - `Rct_ohm` number, nullable: resistência do enrolamento; None = estimada
  - `I_load_A` number, nullable: corrente de carga
  - `Fter` number: fator de sobrecorrente térmica
  - `xr` number: X/R do curto — decide a componente CC
  - `t_relay_ms` number, nullable: tempo do relé; None = sem verificação de saturação CC
  - `pickup_sec_A` number, nullable: pickup do 50 no secundário — troca o gate pelo Δt real
  - `Ei_ponto_cal` number, nullable: energia incidente no ponto NO TEMPO DO RELÉ (cal/cm²) — recompõe a energia com o atraso da saturação e diz a categoria (G238)
  - `Ith_A` number, nullable: Ith de placa do TC
  - `t_s` number: duração da falta (s)
  - `tth_s` number: tempo de referência do Ith
  - `Idyn_A` number, nullable: Idyn de placa; None = 2,5·Ith
  - `medicao` boolean: há núcleo de medição a verificar
  - `classe_medicao` '0.2S' | '0.2' | '0.5S' | '0.5' | '1'
  - `FS` number: fator de segurança do núcleo de medição
  - `In_A` number, nullable: corrente PRIMÁRIA nominal do TC de medição (≈ 1,2× a carga máxima) — é ela que define a relação; a do circuito é I_load_A
  - `instr_withstand_A` number, nullable: suportabilidade do instrumento
  - `adotado` string, nullable: relação adotada (ex.: '600/5'); None = a recomendada — é ela que vai ao memorial e às verificações
  - `psrc` TcPsrcIn: A falta NO TEMPO (IEEE PSRC) do TC adotado — o pickup do 50 em A primários e as premissas do modelo, que o memorial declara (G202).
    - `pickup_A` number, required: pickup do 50 que este TC alimenta (A primários)
    - `S` number: declividade S da curva de excitação (típico 15–25)
    - `remanencia` number: fluxo remanescente antes da falta, em fração do de saturação
    - `Xb_ohm` number: reatância do burden — só o PSRC a usa
  - `partida` TcPartidaIn: A partida de motor com offset CC contra o 50 do alimentador — o mesmo modelo e as mesmas premissas da falta (`psrc`).
    - `I_partida_A` number, required: corrente de partida (rotor bloqueado), A primários eficazes
    - `xr` number: X/R do circuito na partida (motores de MT: 15–40)
  - `diferencial` TcDiffIn: O 87T de dois núcleos na falta passante (G203): o lado 2 é o TC ADOTADO; aqui vão o transformador, o núcleo do lado 1 e a característica do relé. As premissas do lado 2 (S, remanência, Xb) são as do bloco `psrc`, como na página; sem ele, as do núcleo.
    - `Sn_MVA` number, required: potência de referência do 87T (IrW = Sn/(√3·U) em cada lado)
    - `U1_kV` number, required: tensão do lado 1 (kV)
    - `U2_kV` number, required: tensão do lado 2 — o do TC adotado (kV)
    - `Ip1_A` number, required: primário do TC do lado 1 (A)
    - `Isn1_A` 1 | 5: secundário do TC do lado 1
    - `ALF1` number: fator-limite do TC do lado 1
    - `VA1` number: carga nominal do TC do lado 1 (VA)
    - `Rct1_ohm` number, nullable: Rct do TC do lado 1; None = estimada
    - `Zb1_ohm` number: carga REAL do lado 1 (relé + fiação, laço)
    - `remanencia1` number
    - `Xb1_ohm` number
    - `I_passante_kA` number, nullable: falta passante vista do lado 2; None = o Icc do dimensionamento
    - `xr` number, nullable: X/R da passante; None = o X/R da entrada
    - `polarizacao` 'ret630' | 'max'
    - `caracteristica` 'ret630' | 'generic'
    - `Iop_min_pu` number
    - `inclinacao2_pct` number
    - `fim2_pu` number
    - `fim1_pu` number: só na característica genérica (no TR2PTDF é fixo)
    - `inclinacao3_pct` number: só na característica genérica (no TR2PTDF é fixa)

## Response `200`

Successful Response

- TcOut
  - `Icc_A` number, required
  - `Isn_A` number, required
  - `ALF` number, required
  - `designacao` string, required: ex.: 5P20 — classe e fator-limite
  - `burden_VA` number, required
  - `Zb_real_ohm` number, required: carga REAL do secundário (relé + cabo)
  - `Fter` number, required
  - `recomendado` CandidatoTcOut
    - `Ip_A` number, required
    - `ratio` string, required
    - `Rct_ohm` number, required
    - `Zbn_ohm` number, required
    - `ALF_eff` number, required: fator-limite EFETIVO com a carga real
    - `Ip_min_A` number, required: primária mínima para não saturar
    - `vsat_req_V` number, required
    - `vsat_avail_V` number, required
    - `sat_ok` boolean, required
    - `load_ok` boolean, required
    - `ok` boolean, required
  - `candidatos` CandidatoTcOut[]
    - `Ip_A` number, required
    - `ratio` string, required
    - `Rct_ohm` number, required
    - `Zbn_ohm` number, required
    - `ALF_eff` number, required: fator-limite EFETIVO com a carga real
    - `Ip_min_A` number, required: primária mínima para não saturar
    - `vsat_req_V` number, required
    - `vsat_avail_V` number, required
    - `sat_ok` boolean, required
    - `load_ok` boolean, required
    - `ok` boolean, required
  - `robustez` RobustezOut, required
    - `kappa` number, required
    - `ip_A` number, required: valor de crista da corrente de curto
    - `Icc_equiv_A` number, required
    - `Ith_A` number, nullable
    - `Ith_eq_A` number, required: térmica equivalente no tempo de referência
    - `thermal_ok` boolean, nullable
    - `Idyn_A` number, nullable
    - `Idyn_assumed` boolean: Idyn arbitrado como 2,5·Ith
    - `dynamic_ok` boolean, nullable
    - `m_dc` number, required
  - `saturacao_cc` SaturacaoCcOut
    - `ratio` string, required
    - `xr` number, required
    - `Tp_ms` number, required: constante de tempo do primário
    - `Ks` number, required: fator de saturação transitória
    - `alf_eff` number, required
    - `alf_req_dc` number, required: fator-limite que a componente CC exigiria
    - `saturates_dc` boolean, required
    - `ts_ms` number, nullable: tempo até saturar; None = não satura
    - `recovery_ms` number, required
    - `delays` boolean, required: a saturação ATRASA a atuação?
    - `dt_ms` number, nullable: None = não finito
    - `source` string, required: 'gate' (estimativa) ou 'psrc' (Δt real ao pickup)
    - `pickup_sec_A` number, nullable
    - `psrc_reaches_pickup` boolean, nullable
    - `psrc_ratio_min` number, nullable
    - `onda_png_b64` string, nullable: a forma de onda simplificada (critério 'gate'); com o pickup do 50 a figura é a do PSRC, no bloco psrc
    - `tc_sem_saturacao_cc` TcSemSaturacaoCcOut: O menor TC que não satura nem na falta assimétrica (G238).
      - `ratio` string, required
      - `ALF_eff` number, required
      - `alf_exigido` number, required: (Icc/Ip)·(1 + X/R) — o que a componente CC exige
    - `atraso_pct` number, nullable: o atraso em % de energia incidente (Ei ∝ t); None = a saturação não atrasa a atuação
    - `impacto_arco` ImpactoArcoTcOut: A energia incidente recomposta pelo atraso da saturação (G238) — Ei ∝ t (IEEE 1584), limitada a 2 s; a categoria é a da NBR 17227.
      - `Ei_base_cal` number, required: a energia do ponto no tempo do relé, informada
      - `Ei_eff_cal` number, required: a energia com o atraso
      - `dEi_cal` number, required
      - `pct` number, required
      - `dt_ms` number, required
      - `limitado_2s` boolean, required: o tempo com o atraso passou de 2 s e foi limitado
      - `categoria_antes` integer, required
      - `categoria_depois` integer, required
  - `medicao` MedicaoOut
    - `classe` string, required
    - `FS` number, required
    - `FS_eff` number, required: FS efetivo com a carga real — protege o instrumento
    - `I_sec_security_A` number, required
    - `instr_withstand_A` number, nullable
    - `instrument_ok` boolean, nullable
    - `In_A` number, required
    - `I_load_A` number, nullable
    - `load_pct` number, nullable
    - `class_lower_pct` number, required: piso da faixa em que a classe vale
    - `load_in_range` boolean, nullable
    - `Zbn_ohm` number, required
    - `Zb_real_ohm` number, required
    - `burden_flag` string, required
  - `adotado` CandidatoTcOut
    - `Ip_A` number, required
    - `ratio` string, required
    - `Rct_ohm` number, required
    - `Zbn_ohm` number, required
    - `ALF_eff` number, required: fator-limite EFETIVO com a carga real
    - `Ip_min_A` number, required: primária mínima para não saturar
    - `vsat_req_V` number, required
    - `vsat_avail_V` number, required
    - `sat_ok` boolean, required
    - `load_ok` boolean, required
    - `ok` boolean, required
  - `psrc` TcPsrcOut: A falta no tempo: o resumo e a figura do gerador do memorial.
    - `resumo` PsrcResumoOut, required: A falta no tempo — o MESMO resumo que o memorial imprime (`resumo_psrc_falta`).
      - `ratio` string, required
      - `Vs_V` number, required
      - `Rct_ohm` number, required
      - `Rb_ohm` number, required
      - `N` number, required
      - `Icc_kA` number, required
      - `xr` number, required
      - `offset` number, required
      - `remanence` number, required
      - `S` number, required
      - `pickup_A` number, required
      - `Xb_ohm` number, required
      - `pickup_sec_A` number, nullable
      - `ts_ms` number, nullable: None = o núcleo não satura
      - `I2_min_A` number, nullable
      - `ratio_min` number, nullable
      - `t_pickup_ideal_ms` number, nullable
      - `t_pickup_real_ms` number, nullable: None = o relé não vê o pickup na janela simulada
      - `dt_ms` number, nullable
      - `reaches` boolean, nullable: a fundamental REAL alcança o pickup? None = pickup acima da falta
      - `delays` boolean, required
      - `window_ms` number, nullable
      - `t_relay_ms` number, required
    - `figura_png_b64` string, nullable
  - `partida` TcPartidaOut: A partida no tempo: o resumo e a figura do gerador do memorial.
    - `resumo` PartidaTcResumoOut, required: A partida de motor no tempo — o MESMO resumo que o memorial imprime (`resumo_partida`).
      - `ratio` string, required
      - `I_start_A` number, required
      - `xr` number, required
      - `pickup_A` number, required
      - `pickup_sec_A` number, required
      - `I1_fund_max_A` number, required
      - `I2_fund_max_A` number, required
      - `I2_peak_rms_A` number, required
      - `secure_ideal` boolean, required
      - `secure_fund` boolean, required
      - `secure_peak` boolean, required
      - `margin_ideal` number, nullable
      - `ts_ms` number, nullable
      - `ratio_min` number, nullable
      - `I_start_sec_A` number, required
      - `margin_classic` number, nullable: pickup ÷ partida eficaz (critério ≥ 1,2×); None = infinita
      - `Xb_ohm` number, required
      - `remanence` number, required
      - `S` number, required
      - `N` number, required
    - `figura_png_b64` string, nullable
  - `diferencial` TcDiffOut: O 87T de dois núcleos: o resumo, a figura do gerador do memorial e os avisos.
    - `resumo` DiffResumoOut, required: O 87T de dois núcleos — o MESMO resumo que o memorial imprime (`study_diferencial_87t`).
      - `hv_label` string, required
      - `lv_label` string, required
      - `Sn_MVA` number, required
      - `U1_kV` number, required
      - `U2_kV` number, required
      - `IrW1_A` number, required
      - `IrW2_A` number, required
      - `I1_A` number, required
      - `I2_A` number, required
      - `xr` number, required
      - `rem1` number, required
      - `rem2` number, required
      - `S` number, required
      - `xb1` number, required
      - `xb2` number, required
      - `low_op` number, required
      - `end1` number, required
      - `slope2` number, required
      - `end2` number, required
      - `slope3` number, required
      - `charac_mode` string, required
      - `bias_mode` string, required
      - `Ik1_pu` number, required
      - `Ik2_pu` number, required
      - `fa_avail_hv` number, required
      - `fa_avail_lv` number, required
      - `fa_req_hv` number, required
      - `fa_req_lv` number, required
      - `fa_ratio` number, required
      - `idiff_max_pu` number, required
      - `t_idiff_max_ms` number, required
      - `margin_min` number, nullable: mín(Iop/Idiff) pelo fasor; None = sem corrente diferencial
      - `t_margin_min_ms` number, nullable
      - `margin_min_mag` number, nullable
      - `stable` boolean, required
      - `ratio_min_hv` number, required
      - `ratio_min_lv` number, required
      - `ts_hv_ms` number, nullable
      - `ts_lv_ms` number, nullable
      - `mismatch` number, required
      - `matched` boolean, required
    - `figura_png_b64` string, nullable
    - `avisos` string[]
  - `escopo` string
  - `avisos` string[]
  - `norma` string
  - `tier` string: anon · free · full

## Other responses

- `422`: entrada recusada pela IEC 61869-2
- `429`: teto de chamadas

---

[API](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api.md) · [All operations](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/estudoseletricos/apis/arc-flash-platform-api/revisions/5877d717cb1b?raw)
