---
title: "Detuning Study Route"
method: POST
path: "/api/v1/tools/detuning/study"
tags: ["ferramentas"]
---

# Detuning Study Route

`POST /api/v1/tools/detuning/study`

## 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/detuning/study`
- Auth: none declared

O banco dessintonizado com a comparação de fatores p, as harmônicas no
banco e a conformidade, o K-factor do trafo e o filtro sintonizado — e as
figuras do MESMO gerador do memorial (`reactive_figures`).

## Request body

- DessintoniaIn: Dessintonia de banco de capacitores (reator anti-harmônicas) — `reactive.study_detuning`. O reator entra pelo fator p OU pela indutância (um define o outro); o Scc no ponto habilita a ressonância paralela, as harmônicas no banco e as varreduras |Z(h)|.
  - `Q_kvar` number, required: banco (kVAr)
  - `V_kV` number, required: tensão (kV)
  - `f_Hz` 50 | 60
  - `p_pct` number, nullable: fator de dessintonia (%)
  - `L_mH` number, nullable: indutância do reator (mH)
  - `Scc_MVA` number, nullable: Scc no ponto do banco
  - `Un_kV` number, nullable: Un de placa do capacitor — V_cap ≤ 1,10·Un
  - `xr_rede` number, nullable: X/R da rede — amortece o pico de ressonância
  - `q_reator` number, nullable: Q (X/R) do reator
  - `espectro` string, nullable: espectro típico da biblioteca (`tools/detuning/espectros`)
  - `I1_A` number, nullable: corrente fundamental da carga não linear
  - `filtro` FiltroIn: O filtro sintonizado de múltiplas seções (IEC 61642 / IEEE 1531): 5ª e 7ª, e a 11ª quando pedida — cada seção sintonizada um pouco ABAIXO da harmônica, margem ao envelhecimento do capacitor.
    - `incluir_11` boolean
    - `sintonia` number: n_tune = fator × ordem (0,95 = 5 % abaixo)
    - `q` number: fator de qualidade do reator do filtro
  - `figuras` boolean: as figuras do MESMO gerador do memorial

## Response `200`

Successful Response

- DessintoniaOut
  - `p_pct` number, required
  - `f_tune_Hz` number, required
  - `n_tune` number, required
  - `XC_ohm` number, required
  - `XL_ohm` number, required
  - `L_mH` number, required
  - `V_cap_kV` number, nullable: nula quando a física não fecha (a resposta diz por quê)
  - `I_cap_A` number, required
  - `I_fund_A` number, nullable
  - `Q_rede_kvar` number, nullable: o reativo EFETIVO entregue à rede
  - `Q_cap_nom_kvar` number, nullable
  - `Un_sugerida_kV` number, nullable
  - `Un_kV` number, nullable
  - `V_cap_pu_Un` number, nullable
  - `Un_ok` boolean, nullable
  - `h_par_sem` number, nullable
  - `f_par_sem` number, nullable
  - `h_par_com` number, nullable
  - `f_par_com` number, nullable
  - `plausivel` boolean, required
  - `comparacao` object[]
  - `harmonicas` object, nullable
  - `conformidade` object, nullable
  - `kfactor` object, nullable
  - `filtro` object[]
  - `filtro_ok` boolean, nullable: nula sem a varredura (sem o Scc no ponto)
  - `filtro_amplifica` number[]: as ordens características que o filtro AMPLIFICA
  - `complementos_fora` string[]: COBERTURA: o que foi pedido e não se aplica
  - `notas` string[]
  - `avisos` string[]
  - `figura_unifilar_b64` string, nullable
  - `figura_impedancia_b64` string, nullable
  - `figura_harmonicas_b64` string, nullable
  - `figura_filtro_b64` string, nullable
  - `norma` string
  - `tier` string

## Other responses

- `422`: fora do domínio do núcleo (nomeado)

---

[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)