Skip to main content
Docs / Network Model Builder
Docs Menu

Network Model Builder

Build a reviewed DGS package from versioned network sources and validate the handoff in your own licensed engineering environment.

Open the Builder

Open PowerFactory Model Builder under Validation & Handoffs in Engineering Studies. Professional or Enterprise access is required. Select a project that you can edit before creating sources, recipes, or builds.

The workspace is titled Self-Service PowerFactory Model Builder. It has six steps: 1. Data, 2. Scope, 3. Enrichment, 4. Data Quality, 5. Build, and 6. Outputs. You can select a step directly.

The server creates exchange files and a local bootstrap script. It does not run a licensed PowerFactory session. You need your own licensed installation for local import and engineering checks.

1. Data

  1. Choose Project, or enter New project name and select Create Project. The initial project name is “PowerFactory Model Builds”.
  2. Select Refresh to reload the project’s sources, recipes, and jobs when needed.
  3. Choose an existing Source, or enter Source name, Data kind, and Transport, then select Create Source.
  4. Use Upload revision to upload the source file.
  5. Choose a completed Source revision.

The initial source name is “CIM network model”. A source keeps versioned uploads. A completed upload is available for recipe selection; an unfinished or failed revision is not.

Use the Map Instead

Select Use Current Map to capture available engineering features and selected assets into a versioned map snapshot. A project and usable map features are required. The builder creates or reuses a source named “Current Network Map” and advances to Scope.

Source Types and Files

Data kindAccepted input and purpose
CIM RDF/XML or ZIPCIM RDF/XML or a ZIP archive containing the network source.
Current Network MapA captured map snapshot in JSON. Use Use Current Map for the browser map.
Smart-meter timeseriesCSV, XLSX, or JSON rows. Required column groups are meterId or meter_id; timestamp or datetime; and pKw, p_kw, or value.
Protection databaseCSV, XLSX, or JSON rows. Supply deviceMrid, device_mrid, or deviceId to identify the device.
QDSL model bindingsCSV, XLSX, or JSON rows. Supply modelKey or model_key, and foreignKey or foreign_key.
Customer PFD templateA customer-provided .pfd file. It is preserved and packaged, not inspected as an executable model on the server.

JSON enrichment input can be an array of rows or an object with a rows array. Column checks are case-insensitive. Missing required columns produce findings; they are not silently replaced.

Secure upload is the normal transport. Map snapshot is available for the map-source kind. Only an administrator can create or refresh an Allowlisted HTTPS connector. When that transport is enabled, the administrator enters HTTPS endpoint and Credential environment reference, then uses Refresh Connector. The reference names a configured server credential; it is not a password field. The connector requires an approved HTTPS host.

Self-Service PowerFactory Model Builder, dark theme, on step 1 Data: steps Data, Scope, Enrichment, Data Quality, Build and Outputs; Project and source foundation; Create or select a versioned data source.
The Model Builder on step 1, Data. The steps run from Data to Outputs.

2. Scope

  1. Enter Recipe name. The initial value is “PowerFactory model”.
  2. Choose Scope and supply its required inputs.
  3. Choose Target PowerFactory: 2024, 2025, or 2026. The default is 2026.
  4. Set Minimum kV and Maximum kV if you need voltage bounds. The minimum cannot exceed the maximum.
  5. Set PowerFactory project name. The initial value is “Network Map Model”.
  6. Enter Existing project type mappings (JSON; optional foreign keys) if your local project supplies reusable equipment-type foreign keys.
  7. Select Create Recipe. For an existing recipe, select Save New Revision.
  8. Select 3. Enrichment in the step list to add optional data. Create Recipe opens 4. Data Quality, so use the step list to return to enrichment when needed.
Scope choiceInput
Whole networkUse the selected source revision as the network scope.
Substation containersEnter comma-separated Container IDs (comma separated).
Feeder containersEnter comma-separated Container IDs (comma separated).
Network zonesEnter comma-separated Container IDs (comma separated).
Map polygonPaste a GeoJSON Polygon. This field is not a map-drawing tool.
Selected map assetsUse the current selected map assets. Check the displayed selection count.

Use Recipe and Immutable revision to return to a stored recipe version. A new revision preserves the earlier one. A recipe records the source revision, scope, target version, enrichment choices, and review decisions.

3. Enrichment

  1. Choose sources for Smart-meter timeseries, Protection database, QDSL catalog/bindings, and Customer PFD template.
  2. Keep Not included for data you do not have.
  3. Select Save Enrichment Revision.
  4. Select Next: Data Quality.

The choices refer to the latest revision of each listed source. Use completed sources from the same project and of the correct data kind. Enrichment preserves traceable links and customer files. It does not invent meter profiles, protection settings, or licensed dynamic-model definitions.

4. Data Quality

  1. Select Run Preflight.
  2. Read each finding’s severity, rule, message, element identity, and field path.
  3. Use Accept proposal when a proposed correction is suitable.
  4. Use Override value to enter a reviewed replacement in the browser prompt where the finding identifies a field. Cancel the prompt to leave that decision unchanged.
  5. Use Acknowledge only for findings that allow acknowledgement.
  6. Select Save Review Decisions.
  7. Run preflight again for the new revision.
  8. Select Next: Build when ready.

Ready means no unresolved blocking findings remain. A count followed by blocking means the build still needs review. Correct the source and upload a new revision when a finding cannot be resolved safely in the review controls.

Review decisions create an immutable recipe revision. Accepted changes are applied to a working copy and recorded in a correction ledger. The build checks the resulting model again. The original source revision remains available.

5. Build

  1. Select Build PowerFactory Package.
  2. Read Status, Stage, Progress, and Compatibility.
  3. Use Refresh Queue when needed.
  4. In Recent model-builder jobs, select Open beside the job you want to inspect.
StatusMeaning and next step
queuedThe job is waiting for a worker.
runningThe job is processing. Check its stage and progress.
waiting_for_reviewBlocking findings require decisions. Return to Data Quality.
completedThat job finished. Open a completed build to inspect its output files.
failedThe job did not complete successfully. Read the message and correct the source or recipe before another build.
cancelledThe job stopped without completing the requested work.
skippedNo build work was performed for that job. Read its message for the reason.

A completed scheduling job can mean that a child build was queued. Inspect the build job itself before treating a package as complete.

6. Outputs and Local Validation

Outputs shows the target version, compatibility status, reviewed-correction count, and artifact cards. Each card shows a filename, size, kind, SHA-256 hash, and Download button.

  • The ZIP contains the DGS file, canonical model, bootstrap script and configuration, source-to-output mapping, reports, enrichment data, instructions, and checksums.
  • Individual downloads include networkmap_powerfactory.dgs, manifest.json, model_coverage.geojson, quality_findings.geojson, quality_report.json, correction_ledger.json, enrichment_linkage.json, powerfactory_mapping.csv, bootstrap.py, README_POWERFACTORY.txt, and SHA256SUMS.
  • Use Add to Map or Update Map to show model coverage and quality findings. Remove from Map removes those overlays.
  1. Download the completed build ZIP.
  2. Read README_POWERFACTORY.txt.
  3. Use the selected licensed PowerFactory version and its supported local Python environment.
  4. Import and activate your customer template if the package uses one.
  5. Follow the DGS import and bootstrap instructions.
  6. Perform the required local consistency and engineering checks.
  7. Use Upload powerfactory_local_report.json to attach the matching local report.
  8. Optionally use Upload customer-generated .pfd to attach your locally generated project file.

The report must identify the same build, build digest, and target version. A report for a different build is not valid evidence for this package. Upload the report produced by the supplied local procedure. A report can record a completed or failed local check. Read its contents; uploading a failed check is not evidence of a successful import.

Compatibility statusMeaning
syntactic_candidateThe generated package is an import candidate. Local import and engineering checks are still required.
local_import_reportedA matching completed local report was uploaded. Preserve that report and review what it actually tested.
The bootstrap records evidence from local import and engineering checks for the saved build. Customer-generated PFD files are retained as attachments.

Weekly Automatic Update

  1. Select the recipe, open 6. Outputs, and find Weekly automatic update.
  2. Set Enabled to Yes.
  3. Choose Weekday, Local time, and a valid IANA timezone.
  4. Select Save Schedule.

A new schedule defaults to disabled, Monday, 02:00, UTC. Set Enabled to No and save to stop automatic updates.

An administrator can schedule refreshes for an allowed HTTPS connector. Uploaded and map-snapshot sources use the latest completed stored revision. A schedule does not recapture the map open in your browser. New source revisions require fresh review decisions where findings apply.

Related Guides

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