pub fn emit_canonical(
network: &MulticonductorNetwork,
destination: Destination,
) -> Result<EmitResult, Error>Expand description
Emit fresh GLM from the current typed network, without retained-source echo.
The initial profile supports earth/phase-pair P/I/Z loads, ideal fixed sources, explicit phase line matrices, ordinary grounded-wye transformers and fixed contacts. Grounded center-tapped services with private impedance core loads emit native transformers; triplex P/I/Z terms and qualified full-neutral or direct hot-conductor line matrices emit from current typed coefficients. Fixed generator and explicitly fixed inverter injections emit signed constant-power loads; component identity and metadata losses are diagnosed. Coherent three-coil phase-pair banks emit native delta-grounded-wye configurations using current effective winding voltages and impedances. Fixed resistive regulator equivalents emit manual Type B settings. Ideal closed contacts and grounded ideal phase ratios select exact FBS output on a checked forest with one source bus per component. Independent phase ratios use native series stages; private service core circuits are contracted for the forest check. Redundant fully open ties use unloaded parented endpoint aliases to preserve their voltages and zero port currents. FBS uses a 1,000-iteration budget with unchanged node stopping precision. NR uses a nominal-voltage-scaled convergence limit of 1e-9 per unit; the electrical circuit and source constraints remain unchanged. Symmetric line end shunts use exact admittance-load equivalents when native line parameters cannot preserve their port equations. Returned diagnostics identify the generated loads that contribute to physical line port flows. Unsupported electrical behavior fails before the destination is written; omitted non-electrical metadata is reported. This entry point deliberately takes a value, not a source module.