Dot raw to SAInt Translation v0.3.0

Plugins
1

The DOT-RAW to SAInt translation plugin translates power system data from .raw files to SAInt format.

Download it here:dot-raw-to-saint-plugin-0.3.3.zip (118.2 MB)

Screenshot:

screenshot
screenshot726×761 45.8 KB

Overview

The DOT-RAW to SAInt translation plugin translates power system data from .raw files to SAInt format.

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

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

  • Version Compatibility: Supports DOT-RAW file versions 33, 34 and 35.

  • Validation & Reporting: Automatically generates comparison plots to validate translation accuracy.

  • Synthetic Coordinates: Optionally generates synthetic BUS coordinates for visualization in SAInt GUI.

Inputs

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

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

  • Destination of Translated Files
    Full path to the directory where the translated SAInt network, scenario, and condition files will be saved.
    If the network converges, validation plots will also be saved here.

Advanced Inputs (Optional)

  • Name of the translated network
    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.

  • Generate Validation Report
    Set to True to generate HTML comparison plots.

  • Save Output Files
    Set to True to save all generated files.

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
  • Go To Tools → Plugin → Select (select the folder containing the plugin)
  • Execute via Tools → Plugin → Execute

Fill out the form:

  • Path to RAW File: ./path to your .raw file
  • Generate Synthetic Coordinates: True
  • Destination of Translated Files: ./path to your output directory
  • Name of the translated network (Advanced Input): IEEE_118

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: Records translation operations
  3. SAInt network Excel
    1. network.xlsx: SAInt-compatible network import file
  4. Validation plots (Interactive HTML)
    1. Direct comparison
      1. voltage_comparison.html
      2. branch_power_flow_comparison.html
      3. generator_power_comparison.html
      4. load_power_comparison.html
      5. shunt_power_comparison.html
    2. Difference distribution
      1. voltage_difference_distribution_violin.html
      2. branch_power_flow_distribution_violin.html
      3. generator_power_difference_violin.html
      4. load_power_difference_violin.html
      5. shunt_power_difference_violin.html
  5. Parsed Data (CSV)
    1. A parsed/ folder containing .csv representations of .raw sections for reference.

What’s New?

  • System data parsing: Properties like version, network frequency are now automatically parsed.
  • Version 34 support: Files with version 34 can now be translated!
  • Group Translation Logic: SAInt EGRP objects are now created from raw zone objects!
  • Bug Fixes: Various bug fixes like fixing translation failures for switched shunt objects.
1 Like