estudo

Study Bus

post/api/v1/study/bus

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/study/bus
  • Auth: none declared

Request body

barra_estudostring required
ajustesobject

por placement_key (ver resposta): curve, in, ir, tms, isden, isd, tsd, iien, ii, tinst, tab, a tolerância digitada toli/tolt/tolii (± % nos pickups · no tempo das curvas L e S · só na instantânea) e a curva térmica tabelada pts/pts_rapida/pts_base/pts_fonte (G325)

cb_open_msnumber

tempo de abertura do disjuntor (ms), somado ao tempo de atuação das proteções nos dois lados do compartimento. Com um RELÉ decidindo, 0 ms deixa de fora os ciclos do disjuntor que ele comanda — e o aviso sai em avisos

t_sem_atuacao_msnumber nullable

OPÇÃO, desligada por padrão (nulo): o tempo máximo de arco, em ms, adotado na barra cuja proteção EXISTE e não vê nenhuma das correntes de arco (G329). Com ela a barra ganha energia no tempo declarado — sem somar abertura — e a marca t_max_adotado = sem_atuacao; sem ela, sai sem número, como sempre. Maior que zero e no máximo 2000 ms (IEEE 1584:2018 §6.9.1), senão 422. A barra sem proteção declarada continua sem número, e o alerta retaguarda_cega permanece

banda_padrao'norma' nullable

banda PADRÃO do disparador de curto-circuito onde o banco não declara banda e nenhuma tolerância foi digitada: 'norma' aplica ±20 % na instantânea do disjuntor termomagnético (IEC 60947-2), dito na folha como premissa do estudo; eletrônico e relé seguem na curva ajustada. Nulo = a curva nominal, como sempre foi

base_ibf'pior_caso' | 'nominal' nullable

OPÇÃO, desligada por padrão (nulo = a corrente de curto MÁXIMA, como sempre): 'pior_caso' calcula cada barra também com a corrente MÍNIMA (IEC 60909-0 §7.1.2, ou a fonte mínima que a concessionária declara em fonte.Icc_min_kA) e fica com a que dá MAIS energia no cenário governante (NBR 17227 §4.2.1.3 e §5.1.12). O modo que governou sai em ibf_base de cada cenário; a corrente mínima que não pôde ser calculada é 422. 'nominal' (G328) calcula a energia com a corrente de TENSÃO NOMINAL — c = 1,0 no ponto de falta, sem K_T e os cabos em t_cabo_C (nulo = a temperatura de cada cabo): a base dos estudos feitos em tensão nominal, FORA do §7.1.2, dita no laudo; a máxima da norma segue dimensionando a barra

t_cabo_Cnumber nullable

a temperatura dos cabos (°C) na base nominal de Ibf (G328): nula = a temperatura declarada em cada cabo. Só vale com base_ibf='nominal'

geometriaobject

por id de barra

figuraboolean

renderiza a folha TCC (PNG base64)

svgboolean

devolve também a folha em SVG (tcc_svg) — o mesmo desenho do PNG, com um id por curva: tcc-curva-{n} é o número do badge e o tag da folha de ajustes, e tcc-faixa-reprovada-{par}-{k} a faixa de seletividade do par

I_max_kAnumber nullable
T_max_msnumber
erms_onboolean

modo MANUTENÇÃO (ERMS · NEC 240.87): desenha a curva de manutenção ao lado da normal e compara as duas energias. Não altera o ajuste de operação — é um modo comutável, para trabalho energizado

erms_ii_punumber

instantâneo do modo manutenção, em múltiplos de In

Response

Successful Response

camadasstring[]

o que a folha TCC desenha além das curvas: as camadas das FERRAMENTAS da suíte, as do PRÓPRIO elemento e as de leitura pedidas (o Ith, com o tempo e o m; as zonas de energia)

camadas_premissasstring[]

o que a camada ASSUME porque a rede não declara (inrush, tempos de partida) — padrão da plataforma não pode passar por dado do equipamento

folha_declarastring[]

o que a FOLHA somou e de onde veio cada banda (G307 · G308): a curva do relé com os ciclos do disjuntor que ele comanda (e se foram assumidos) e a banda do fabricante de cada disjuntor, com a fonte — o que o traço não diz sozinho

estudos_realizadosstring[]

o estudo de UMA barra resolve a cadeia de proteção e a energia incidente dela: são as duas análises, e o índice recebe as duas

barraobject required
correntesobject required
pior_casoobject nullable

com base_ibf='pior_caso' (G333): os DOIS modos que o estudo comparou — max e min, cada um com a corrente (ibf_kA), o Ei governante e o lado que governou. O que valeu está em ibf_base dos cenários. Nulo sem a opção

operacaostring nullable

G336: o cenário de OPERAÇÃO que governa a barra (o de mais energia) — a folha, o desenho e os números são os dele. Nulo sem cenários

operacoesobject nullable

G336: a energia governante da barra em cada cenário em que ela está energizada (nulo = sem número nele)

placement_keysstring[] required
janelaobject[] required
cenariosobject required
governantestring required
Ei_govnumber nullable
t_gov_msnumber nullable
impressao_modelostring nullable

a IMPRESSÃO DO MODELO (W8): sha256 (16 hex) da forma canônica do que define os números — rede, proteções, ajustes, geometria e tempo de abertura. É a que a capa do documento imprime; o carimbo e o idioma não a mudam, e é a MESMA no estudo da planta

tabela_mestraobject[] required
tagsobject[] required
tcc_png_b64string nullable
tcc_svgstring nullable

a MESMA folha em SVG (só com svg=true), com um id por curva

sequenciaobject

quem abre e em quantos ms: ibf na falta franca (a da coordenação) e iarc na corrente de arco (a da energia), com o intervalo até a seguinte

fora_escala_notastring nullable

o porquê e o remédio, no texto do núcleo

I_max_kAnumber nullable

a corrente máxima do eixo da folha — a que foi usada

unifilar_svgstring required
avisosstring[] required
enginestring required
tierstring required

Changes

No recorded changes to this operation across all 1 revision of this API.