Skip to main content
Docs / Network Model Import and Validation
Docs Menu

Network Model Import and Validation

Import an electrical case, resolve source and topology issues, and check readiness before running a study.

Watch the Video: Grid Circuit Builder & Model Import (1:06)

Choose the Input Path

InputWhere to use itWhat it means
Current map layersSetup & RunCapture a map scope or selected assets, then review how the layers map to electrical roles.
Displayed single-line diagramImport > Current Single-Line Diagram in Grid Circuit BuilderCreate an unsaved circuit draft from the displayed nodes and links. Preserve source limits and review inferred relationships.
RAW or RAWX electrical caseImport PSS/E in Grid Circuit BuilderPreview the file set, then create a circuit with a stored revision.
Published circuit revisionSetup & RunUse a specific validated published revision without recapturing map features.

Engineering Studies requires Professional or Enterprise access. Circuit imports also require an engineering project and an owner or editor role.

Import RAW or RAWX Files

  1. Open Grid Circuit Builder and select the project.
  2. Save any current draft changes.
  3. Select Import PSS/E.
  4. Select the case file and its optional companion files.
  5. Review Circuit file import preview.
  6. Check the detected format, version, source-file count, equipment counts, diagnostics, unsupported sections, and attachments.
  7. Enter Circuit name.
  8. Select Create circuit, or Cancel to leave the preview.
FileAccepted purpose
.rawText case in version 35 or 36.
.rawxJSON case in version 35 or 36.
.seqSequence data. Supported records are mapped; unsupported or unresolved records are reported.
.conContingency definitions.
.monMonitor definitions.
.subSubsystem definitions.
.dyrPreserved dynamic-model attachment. Preservation does not mean dynamic models are simulated or validated by the circuit importer.

Provide one RAW case, one RAWX case, or one compatible RAW/RAWX pair. A pair must use the same version and describe the same mapped electrical network. Each companion type can appear only once. Use distinct filenames. Binary SAV files are not supported.

Unsupported sections can remain preserved for round-trip evidence without being electrically mapped. Read their diagnostics before treating the imported case as complete. An error for an unmapped electrical section still needs correction; preserving its source text does not resolve it. File acceptance does not publish the circuit or prove that a study engine can use every imported section.

Grid Circuit Builder toolbar, dark theme, with New, Import + Current Single-Line Diagram, Import PSS/E, Save revision, Publish and Export PSS/E, the component list, an empty canvas and Circuit settings with Validation.
Grid Circuit Builder: Import PSS/E and Import + Current Single-Line Diagram are in the toolbar. A PSS®E licence is not included.

Reconcile a Map Diagram Import

For the capture and preview procedure, see Single-Line Diagrams and Engineering. In the imported circuit, use Import reconciliation to resolve each issue.

Issue or controlRequired action
Incomplete or capped scopeCapture a more complete local scope, or enter an Acknowledgement reason and select Accept narrowed scope when the reduced scope is intentional. The reason remains attached.
Missing, duplicate, stale, or mismatched source referenceCheck the original asset and recapture if needed. Use Detach as user-created only when you accept responsibility for maintaining the item independently of that source.
Unmapped componentSelect the item and choose its explicit Equipment type. Review the fields and connections after changing the type.
Inferred connectionSelect the link. Inspect its origin, method, confidence, and endpoint IDs. Use Confirm inferred link only after review, or use Remove link and reconnect it correctly.
Provisional equipment terminalsConnect a distinct bus to each terminal. Use Confirm endpoints when the sides are correct. Use Swap terminal sides for two-terminal equipment, then confirm the revised assignment.
Omitted link candidateUse Acknowledge omitted candidate only after checking that it is not an electrical connection in this circuit.
More issues below the visible listUse Show … more issues (… remaining). The button displays the next issue count and remaining total.
Suggested electrical valueCheck the source, then edit the property to confirm the intended value. Supply missing required values.

An unresolved issue still needs action. accepted-narrow-scope records an explicit scope limitation and reason. recaptured-complete marks a resolved reconciliation item. Review the recorded reason and scope for each reconciliation item.

Resolve Circuit Validation

The builder checks required values, numeric ranges, unique IDs, equipment mappings, source identities, terminals, inferred-link review, and unresolved scope issues. It also checks that each electrical island has a grid source.

  • Supply positive base power, frequency, bus voltages, and required ratings.
  • Provide line and transformer impedances. Do not use zero for both R and X.
  • Keep operating P and Q within the limits you supply.
  • Check tap limits and the supporting control fields for non-neutral taps or voltage control.
  • Match transformer terminal sides to bus voltages. The check uses the greater of 2% or 0.1 kV as its voltage tolerance.
  • Confirm terminal assignments again if you change their connected buses.
  • Review disconnected-equipment warnings.

See Grid Circuit Element Reference for type-specific fields. A draft can be saved before it is valid. Publication requires the current saved revision to pass blocking checks.

The strict circuit PSS/E export path also checks the saved revision. Missing required electrical values must be supplied before export. A successful save is not an export-readiness check.

Review Map-Layer Mapping

  1. In Setup & Run, select the intended scope, study type, and engine.
  2. Select Refresh Scope after changing the map or asset selection.
  3. Read captured-feature and skipped-feature information. Check any feature-cap warning.
  4. In Mapping Review, keep Auto detect or assign the correct role to each displayed input layer.
  5. Select Check Readiness.

The role choices are Bus / point, Branch / feeder, Transformer, Load, Generator / DER, Storage, and Switch. A role override changes model conversion. It does not add missing electrical fields to the source layer.

Use Add Inputs to Map to show a frozen copy of mapped inputs. If the mapped inputs change, use Update Inputs on Map. Inputs Added to Map marks the current overlay. Remove Inputs removes that overlay without deleting the source data.

Use a Published Circuit Revision

  1. Select the project in Session Context.
  2. Open Setup & Run and choose the study type and engine.
  3. Select Circuit Revision.
  4. Choose Published circuit revision and wait for its model to load.
  5. Select Check Readiness and review the returned diagnostics.

This input path supports model quality, power flow, contingency analysis, sensitivity analysis, PTDF/LODF, and cross-check studies. Other study types need their supported input path. Later circuit edits do not change the selected revision.

Read Model Readiness

Model Readiness shows the checked scope and equipment counts for buses, branches, transformers, loads, generators, storage, switches, and protective devices. It can also show Connection Score, Connection Status, and Connection Bus when the response provides them.

StatusMeaning and next step
Not checked / PendingNo readiness result is available. Select Run Readiness Check.
CheckingThe model check is in progress. Wait for the result.
Ready / Engineering Ready = YesThe returned model passes the engineering-readiness gate. Read diagnostics before running the selected study.
Needs work / Engineering Ready = NoThe model needs corrections. Use the diagnostics to fix input data or scope, then rerun the check.
errorCorrect the reported problem before relying on the affected model or study.
warningReview the reported limitation or assumption. Decide whether the study scope remains suitable.
infoRead the supporting detail and preserve it with the study basis.
N/AThe value was not supplied or is not applicable. It is not a measured zero or a pass.

Diagnostics lists each code, severity, message, and related element ID when available. Correct the underlying input, then select Run Readiness Check again. A check without a required limit is not assessed. An absent limit must not be treated as unlimited capacity.

Use readiness findings to resolve model-conversion issues before running a study.
Model Readiness in Engineering Studies, dark theme: Engineering Ready Pending, counts for buses, branches, transformers, loads, generators, storage, switches, protective devices, connection score and connection status, with Refresh Scope and Run Readiness Check.
Model Readiness before a check is run. All counts show N/A until you run it.

Review the Dynamic Source Inputs

A static model import is not proof that a dynamic model is valid. For generated PSS/E dynamic cases, review each in-service generator's explicit source resistance and reactance on its machine MVA base and supply suitable authorized plant dynamics. The stock single-machine harness does not provide a plant dynamic model.

Check attachment identity and compatibility after model changes. Read the handoff guidance before using the case in a licensed solver.

Related Guides

Can't find what you need? Email support@networkmap.energy or call 1300 936 116. Sign in to Network Map.