| YAML path | Type | Default | Allowed values | Meaning | Use when | Avoid when | Performance impact | Interactions |
|---|
matpower_import.case | String | case14.m | case path/name | MATPOWER case selector. | Case studies and benchmarks. | Invalid/missing paths. | Parse/solve scales with case size. | benchmark.*, runtime/profile. |
matpower_import.auto_profile | Symbol/String | recommend | off, recommend, apply | Auto select import profile behavior. | Normal import workflows (recommend). | Forcing profile blindly. | Low compute; can change downstream defaults. | Output profile visibility options. |
matpower_import.auto_profile_log | Bool | false | true, false | Log auto-profile reasoning. | Debug import decisions. | Quiet high-volume runs. | Logging overhead only. | output.console_auto_profile, logfile settings. |
matpower_import.pv_voltage_source | Symbol/String | gen_vg | gen_vg | PV voltage setpoint source policy. | Standard MATPOWER semantics. | Nonstandard conversion assumptions. | None. | compare_voltage_reference, PF starts. |
matpower_import.pv_voltage_mismatch_tol_pu | Float64 | 1e-4 | nonnegative real | Tolerance for PV voltage mismatch checks. | Tight validation studies. | Overly strict noisy data. | Low. | compare_voltage_reference. |
matpower_import.compare_voltage_reference | Symbol/String | imported_setpoint | imported_setpoint | Voltage reference used for comparisons. | MATPOWER comparison workflows. | When historical/SCADA ref should dominate. | Low. | pv_voltage_source, diagnostics. |
matpower_import.bus_shunt_model | Symbol/String | admittance | admittance | Bus shunt interpretation model. | Default import path. | Alternative models not implemented. | None. | Import convention diagnostics. |
matpower_import.shift_unit | Symbol/String | deg | deg, rad | Phase-shift input unit. | Cases with radians metadata. | Wrong unit declaration. | Negligible. | shift_sign, branch shift diagnostics. |
matpower_import.shift_sign | Float64 | 1.0 | real (typ. 1.0, -1.0) | Phase-shift sign convention. | Cross-tool convention alignment. | Unnecessary flipping. | None. | shift_unit, branch-shift diagnostics. |
matpower_import.ratio | Symbol/String | normal | normal | Branch ratio interpretation mode. | Standard MATPOWER import. | Unsupported alternate conventions. | None. | Transformer/tap interpretation. |
matpower_import.enable_pq_gen_controllers | Bool | true | true, false | Enable controller behavior on imported PQ generators. | Realistic controlled studies. | Raw imported behavior reproduction. | Small control bookkeeping cost. | PF Q-limit behavior. |
matpower_import.preallocate_network | Symbol/String | auto | off, on, auto | Controls import-time sizehint! preallocation for large MATPOWER network construction. | Large imports where construction allocations dominate runtime. | Tiny cases where tuning is unnecessary. | Can reduce import allocations/time; no model changes. | matpower_import.preallocate_min_buses. |
matpower_import.preallocate_min_buses | Int | 1000 | positive integer | Bus-count threshold used when preallocate_network = auto. | Auto-tuning preallocation trigger for site-specific case sizes. | If fixed always-on/off behavior is preferred. | Threshold only; no model changes. | matpower_import.preallocate_network. |