ArcFM Desktop Developer Guide
Import Electric Solver Results
|
Importing analysis results into ArcFM is optional functionality. Implement this only if you wish to view analysis results from SynerGEE in ArcMap. Common calculations performed on a feeder loaded in SynerGEE are load allocation, load flow analysis, and short-circuit analysis. The Electric Solver API in Network Adapter supports execution of these types of analysis and returns results in an XML document. Each result value is identified by an attribute name as defined in the tables below. |
|
Before executing load allocation, the Implementation must assign a demand to the feeder and assign connected kVAs to sections in the feeder. Use the IMMElecSolverAPI::ApplyTestCase method to assign connected kVAs.
Before executing load flow analysis, either load allocation should be executed or loads should be applied to sections in the feeder using the IMMElecSolverAPI::ApplyTestCase method.
Result Value
Units
Attribute Name
Volts out of device
Volts
VBaseA_In, VBaseA_In, VBaseA_In
Amps into device
Amps
IA_In, IB_In, IC_In
Result Value
Units
Attribute Name
Three phase fault current out of device
Amps
LLLamp_In
Line to ground max. fault current out of device
Amps
LGampMax_In
Line to ground min. fault current out of device
Amps
LGampMin_In
Import analysis results by calling the appropriate import method on the IMMXMLData interface (depending on the type of XML file being imported). The Analysis API imports results into tables in the Network Adapter database. The name of the results table is based on the analysis type identified in the results XML, and the name of the feature class (as shown below). If you are importing load case results, specify the "TestCaseName" by including the TestCaseName property in the import properties.
AnalysisType_FeatureClass
TestCaseName_FeatureClass
The results for Transformers are stored in the table LoadFlow_Transformer or ShortCircuit_Transformer (depending on the type of analysis). Load cases are stored in LoadCase_Transformer.
SynerGEE generates results in terms of "sections," which represent conductors. The Electric Solver API can return results in terms of the conductor section, or in terms of the point feature at the end of the conductor section, or in terms of both.
No results will be returned for conductor sections that are part of complex edges. These results are available only in terms of the point feature downstream from the section.
The results XML contains the results for all features in the analysis, for a single analysis type. The analysis type is identified in an attribute on the top level of the results XML.
All results tables for an analysis type are created in the Network Adapter database the first time the results are imported for that analysis type. The implementer should add all results tables that will be used for display to the map using the Add Data button.
You may display results in ArcMap by joining map layers to the results tables in the Network Adapter database, and then using labels or symbology.
After creating results layers for a feature class, the same feature may appear multiple times in the Attribute Editor when selected. To avoid confusion, you may wish to designate all results layers as not selectable.
