Dot raw to SAInt Translation v0.1.0

Plugins
1

A simple plugin that translates power system data from .raw files to SAInt format.

Download it here: dot-raw-to-saint-plugin-v0.1.0.zip (114.5 MB)

Screenshot:

screenshot
screenshot921×863 17.2 KB

Overview

This plugin translates power system data from .raw files to SAInt format.

  • Multi-Component Translation: Supports translation of all major power system components:

    • ZONE
    • BUS
    • GENERATOR
    • LOAD
    • TRANSFORMER
    • BRANCH
    • SWITCHING DEVICE
    • FIXED AND SWITCHED SHUNT DEVICES

  • Version Compatibility: Currently supports .raw file versions 33 and 35. Additional versions will be supported in future updates.

  • Reporting: Generates comparison plots to validate translation accuracy.

  • Synthetic Coordinate Generation: Optionally generates synthetic BUS coordinates for network visualization in SAInt GUI.

Inputs

  • Path to RAW File
    Full path to the *.raw file.

  • RAW Version
    Version number of the *.raw file (e.g., 33 or 35).

  • Headers in RAW File
    Specify whether the *.raw file includes column headers.

  • Generate Synthetic Coordinates
    Option to generate synthetic bus coordinates for visualization in SAInt.

  • Output Directory
    Full path to the directory where the translated SAInt network, scenario, and condition files will be saved.
    If the network successfully converges in SAInt, validation plots will also be saved here.

Advanced Inputs (Optional)

  • Network Name
    Name for the translated SAInt network. Default is "DOT_RAW_NETWORK".

  • Parse RAW File
    Set to True to parse the .raw data into readable CSV files.

  • Translate Data
    Set to True to convert parsed data into SAInt-compatible Excel import files.

  • Run Simulation for Validation
    Set to True to generate native SAInt network and scenario files and run a SteadyACPF simulation for validation.

  • Generate Validation Report
    Set to True to create validation plots comparing results from the .raw file and the SAInt simulation.

  • Save Output Files
    Set to True to save all generated SAInt files and validation plots.

Example with IEEE 118 Bus System

The following is an example of running the plugin with the IEEE 118 Bus System.

What You Will Need

To start, please download:

  • The latest version of SAInt.
  • The IEEE 118-Bus System .raw dataset, downloadable from: here
  • This DOT-RAW to SAInt plugin. Unzip it and note the location of the download.
dot-raw-to-saint-plugin/
├── main.exe
├── form.yaml
└── (other files)

Running the PlugIn

  • Open SAInt GUI
  • Select Plugin In SAInt: Tools → Plugin → Select (select the folder containing the plugin)
  • Execute Plugin: Tools → Plugin → Execute

Fill out the form with the following required inputs:

  • Path to RAW File: ./path to your .raw file.
  • RAW Version: 33
  • Headers in RAW File: True
  • Generate Synthetic Coordinates: True
  • Output Directory: ./path to your output directory

Expand the advanced inputs section in the form and write “IEEE_118” in the Network Name input.

Understanding the Output

In the specified Output Directory, the following files will be created:

  1. SAInt native files:
    1. IEEE_118.enet: SAInt network file
    2. acpf.esce: Scenario file
    3. acpf.econ: Scenario condition file
  2. Logs
    1. info.log: Contains logs of the translation operations.
  3. SAInt network Excel
    1. network.xlsx: SAInt network import Excel file
  4. Reporting
    1. voltage_comparison.html: Comparison plot of voltage magnitudes and voltage angles.
    2. branch_power_flow_comparison.html: Comparison plot of line active, reactive, and apparent power flow.
  5. parsed: Contains raw-to-CSV parsed data for reference.
2 Likes