Node Level Results
This feature is in active development and is only available to select customers. If you are interested in using this feature, please contact Zepben for more information.
Overview
The Node Level Results feature enables collection of detailed electrical measurements at specific points in the network during power flow simulations. This provides granular visibility into network behaviour at switches, transformers, conductors, and energy consumers.
The node_level_results table is populated independently from all other output tables. You can enable or disable other result tables without any impact on Node Level Results, and vice versa.
Configuration
Node Level Results are configured within the NodeLevelResultsConfig section of the GeneratorConfig in your Work Package configuration.
Parameters
| Variable Name | Data Type | Default | Description |
|---|---|---|---|
| collect_voltage | bool | true | Include voltage values in node level results. |
| collect_current | bool | true | Include current values in node level results. |
| collect_power | bool | true | Include power values in node level results. |
| mrids_to_collect | List[str] | null | A list of MRIDs to collect node level results at. Note: Depending on network simplification and translation, these MRIDs may not exist in the final OpenDSS and no results will be collected in that case. Note that if running work package across multiple feeders, this will generate a lot of logs as the MRIDs won't be found on feeders they are not in, but the core functionality will still work. |
| collect_all_switches | bool | false | Collect node level results at all switches in the feeders that are part of this work package. |
| collect_all_transformers | bool | false | Collect node level results at all transformers in the feeders that are part of this work package. |
| collect_all_conductors | bool | false | Collect node level results at all conductors in the feeders that are part of this work package. |
| collect_all_energy_consumers | bool | false | Collect node level results at all energy consumers in the feeders that are part of this work package. |
How It Works
Enabling the Feature
If any of the parameters are set to a non-null/non-false value, the node_level_results table will be populated. Otherwise, it will not be created.
You can collect results by:
- Specific MRIDs: Provide a list of equipment MRIDs in
mrids_to_collect - Equipment Class: Enable collection for all instances of a specific equipment type (switches, transformers, conductors, or energy consumers)
- Combination: Use both methods together for flexible collection strategies
What Gets Collected
Based on your configuration, the following measurements can be collected at each specified location:
- Voltage: Per-phase voltage magnitudes and angles
- Current: Per-phase current magnitudes and angles
- Power: Active and reactive power flows
Important Considerations
Depending on the settings used for collapsing and simplifying switches, transformers and conductors, the results collected may not match 1:1 with the objects in the CIM model. Some equipment may have been collapsed or simplified away during model generation (particularly conductors).
If you want to ensure results are collected at every single location, you should set simplify_network to false in the GeneratorConfig.
When specifying mrids_to_collect:
- MRIDs that don't exist in the feeder will not produce results
- If running a work package across multiple feeders, you'll see log messages for MRIDs not found on each feeder (this is expected behaviour)
- Network simplification may remove equipment, preventing collection even if the MRID was valid in the original CIM model
Configuration Examples
Performance Considerations
The Node Level Results feature has performance implications that scale with the amount of data collected:
| Collection Scope | Performance Impact |
|---|---|
| Specific MRIDs (≤100) | Minimal-Low |
| All switches/transformers | Low-Medium |
| All conductors/consumers | Medium-High |
| All equipment types | High |
- Be selective - Only collect at locations you need
- Limit measurement types - Disable unused measurements (voltage/current/power)
- Use specific MRIDs - More efficient than collecting all equipment of a type
- Balance simplification vs coverage - Weigh simplified networks against result completeness