Montar rede multibarra e calcular Icc em todas as barras (IEC 60909)
montar_redeMonta uma REDE MULTIBARRA (concessionária → transformadores → cabos →
quadros) e calcula o curto-circuito IEC 60909 em TODAS as barras de uma vez,
pelo mesmo motor validado da plataforma (redução nodal do Anexo B: aceita
alimentação radial, em paralelo e malha). Use quando o usuário tem os dados
de VÁRIOS equipamentos — típico de quem acabou de ler um datasheet, uma carta
da concessionária ou um memorial antigo — em vez de chamar
calcular_curto_circuito (que é de UM ponto) várias vezes.
Devolve também projeto_json: o arquivo de projeto da plataforma com a rede
inteira. Entregue esse conteúdo ao usuário para salvar como .json e abrir em
"Abrir projeto" no app — a rede aparece nas tabelas para ele CONFERIR e seguir
para coordenograma, arco elétrico e memorial. Nenhum valor extraído de
documento deve virar laudo sem essa conferência humana.
── barras: lista de objetos ────────────────────────────────────────────────
{"id": "SE_BT", "label": "Subestação 480 V", "Vn_kV": 0.48}
id é o identificador único (sem espaços é mais seguro); Vn_kV é a tensão
NOMINAL da barra em kV (0,48 = 480 V). A barra de conexão com a
concessionária é a que NÃO recebe nenhum elemento (nenhum to_id aponta
para ela) — é ela a raiz da rede.
── elementos: lista de objetos (o que liga uma barra à outra) ──────────────
element_type "transformer": {"from_id","to_id","element_type":"transformer",
"Sn_kVA":1000,"Vcc_pct":5.0,"Pcu_W":10000,"XR_trafo":null}
Sn e Vcc são de PLAQUETA e obrigatórios (>0). Pcu_W = perdas no cobre;
XR_trafo (opcional) sobrepõe o X/R estimado por Pcu.
element_type "cable" (ou "busbar"): {"from_id","to_id","element_type":"cable",
"secao_mm2":95,"material":"Cu","comprimento_m":40,"num_conductors":1}
Liga barras de MESMA tensão (para mudar de tensão use "transformer").
element_type "reactor": {"from_id","to_id","element_type":"reactor",
"u_kR_pct":6,"I_rR_A":400} (reator limitador, §6.5 — u_kR e I_rR de plaqueta)
── fonte: a contribuição da concessionária ────────────────────────────────
{"Vn_kV":13.8, "Scc_MVA":500, "XR":10, "Icc_1ph_kA":0, "XR_1ph":0}
Informe Scc_MVA OU Icc_kA (não os dois). Vn_kV é a tensão do ponto de
conexão. §7.1.2 d): use a contribuição MÁXIMA declarada pela concessionária,
não a de hoje — dimensionar pelo valor de hoje subdimensiona o equipamento
quando a rede reforça. Icc_1ph_kA/XR_1ph são opcionais (0 = estimar Z0).
── motores (opcional): contribuição de motores por barra ────────────────── {"bus_id":"QD-01","P_kW":75,"n_motores":4,"cos_phi":0.85,"rendimento":0.92, "Xd_sub_pu":0.17}
Erro de FORMA (campo faltando, valor não-numérico) e erro de FÍSICA (tensões que não casam num cabo, trafo sem Sn/Vcc, duas alimentações para a mesma barra) voltam em {"erro": ...} explicando o que corrigir — nada é calculado "pela metade". Gratuito (uso limitado).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | pt | |
| fonte | Yes | ||
| barras | Yes | ||
| api_key | No | ||
| motores | No | ||
| elementos | Yes |