Monta 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,"Rn_ohm":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. Modelado como Dyn
(delta na alta, estrela na baixa). `Rn_ohm` = resistor de aterramento do
NEUTRO de baixa (NGR), em Ω: ausente = neutro SÓLIDO, e a resposta avisa
que foi assumido. Com NGR a fase-terra cai em ordem de grandeza — SEMPRE
informe quando a instalação tiver. `tipo_aterramento` (opcional) aceita
'solido' ou 'resistivo' (este exige Rn_ohm), como no
`calcular_curto_circuito`; 'isolado' é RECUSADO aqui (neutro isolado não
é modelado na rede multibarra). O aterramento é do TRANSFORMADOR, nunca
da `fonte`.
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).
