File IO

parse_file(io::String; import_all=false, validate=true)
parse_file(io::IO; import_all=false, validate=true, filetype="json")

Parse a file into a PowerModels data structure.

The supported file types are:

• .m: a Matpower file
• .raw: a PTI (PSS(R)E-v33)
• .json: a PowerModels.jl JSON file

All fields from PTI files will be imported if import_all is true.

If validate = true, PowerModels will validate the imported data for correctness.

Parses json from iostream or string

Parses the matpwer data from either a filename or an IO object

adds dcline costs, if gen costs exist

Export cost data

Export fields of a component type

Get a default value for dict entry

Converts a Matpower dict into a PowerModels dict

merges bus name data into buses, if names exist

merges generator cost functions into generator data, if costs exist

merges Matpower tables based on the table extension syntax

sets all branch transformer taps to 1.0, to simplify branch models

adds pmin and pmax values at to and from buses

_split_loads_shunts!(data)

Seperates Loads and Shunts in data under separate "load" and "shunt" keys in the PowerModels data format. Includes references to originating bus via "loadbus" and "shuntbus" keys, respectively.

Export power network data to a file in the matpower format

Export power network data in the matpower format

Export power network data in the matpower format

Parses the matpwer data from either a filename or an IO object

parse_pti(filename::String)

Open PTI raw file given by filename, returning a Dict of the data parsed into the proper types.

parse_pti(io::IO)

Reads PTI data in io::IO, returning a Dict of the data parsed into the proper types.

parse_psse(filename::String; kwargs...)::Dict

Parses directly from file

function parse_psse(io::IO; kwargs...)::Dict

Parses directly from iostream

create_starbus(pm_data, transformer)

Creates a starbus from a given three-winding transformer. "sourceid" is given by `["busi", "name", "I", "J", "K", "CKT"]` where "bus_i" and "name" are the modified names for the starbus, and "I", "J", "K" and "CKT" come from the originating transformer, in the PSS(R)E transformer specification.

_find_max_bus_id(pm_data)

Returns the maximum bus id in pm_data

_get_bus_value(bus_i, field, pm_data)

Returns the value of field of bus_i from the PowerModels data. Requires "bus" Dict to already be populated.

Imports remaining top level component lists from data_in into data_out, excluding keys in exclude

Imports remaining keys from a source component into detestation component, excluding keys in exclude

_init_bus!(bus, id)

Initializes a bus of id id with default values given in the PSS(R)E specification.

_psse2pm_branch!(pm_data, pti_data)

Parses PSS(R)E-style Branch data into a PowerModels-style Dict. "source_id" is given by ["I", "J", "CKT"] in PSS(R)E Branch specification.

_psse2pm_bus!(pm_data, pti_data)

Parses PSS(R)E-style Bus data into a PowerModels-style Dict. "source_id" is given by ["I", "NAME"] in PSS(R)E Bus specification.

_psse2pm_dcline!(pm_data, pti_data)

Parses PSS(R)E-style Two-Terminal and VSC DC Lines data into a PowerModels compatible Dict structure by first converting them to a simple DC Line Model. For Two-Terminal DC lines, "sourceid" is given by ["IPR", "IPI", "NAME"] in the PSS(R)E Two-Terminal DC specification. For Voltage Source Converters, "sourceid" is given by ["IBUS1", "IBUS2", "NAME"], where "IBUS1" is "IBUS" of the first converter bus, and "IBUS2" is the "IBUS" of the second converter bus, in the PSS(R)E Voltage Source Converter specification.

_psse2pm_generator!(pm_data, pti_data)

Parses PSS(R)E-style Generator data in a PowerModels-style Dict. "source_id" is given by ["I", "ID"] in PSS(R)E Generator specification.

_psse2pm_load!(pm_data, pti_data)

Parses PSS(R)E-style Load data into a PowerModels-style Dict. "source_id" is given by ["I", "ID"] in the PSS(R)E Load specification.

_psse2pm_shunt!(pm_data, pti_data)

Parses PSS(R)E-style Fixed and Switched Shunt data into a PowerModels-style Dict. "source_id" is given by ["I", "ID"] for Fixed Shunts, and ["I", "SWREM"] for Switched Shunts, as given by the PSS(R)E Fixed and Switched Shunts specifications.

_psse2pm_transformer!(pm_data, pti_data)

Parses PSS(R)E-style Transformer data into a PowerModels-style Dict. "source_id" is given by ["I", "J", "K", "CKT", "winding"], where "winding" is 0 if transformer is two-winding, and 1, 2, or 3 for three-winding, and the remaining keys are defined in the PSS(R)E Transformer specification.

_pti_to_powermodels!(pti_data)

Converts PSS(R)E-style data parsed from a PTI raw file, passed by pti_data into a format suitable for use internally in PowerModels. Imports all remaining data from the PTI file if import_all is true (Default: false).

function parse_psse(io::IO; kwargs...)::Dict

Parses directly from iostream

parse_psse(filename::String; kwargs...)::Dict

Parses directly from file

Export remaining keys of a componet

_get_line_elements(line)

Internal function. Uses regular expressions to extract all separate data elements from a line of a PTI file and populate them into an Array{String}. Comments, typically indicated at the end of a line with a '/' character, are also extracted separately, and Array{Array{String}, String} is returned.

This is an experimental method for parsing elements and setting defaults at the same time. It is not currently working but would reduce memory allocations if implemented correctly.

_parse_line_element!(data, elements, section)

Internal function. Parses a single "line" of data elements from a PTI file, as given by elements which is an array of the line, typically split at ,. Elements are parsed into data types given by section and saved into data::Dict.

_parse_pti_data(data_string, sections)

Internal function. Parse a PTI raw file into a Dict, given the data_string of the file and a list of the sections in the PTI file (typically given by default by get_pti_sections().

Parses PM transformer branch to PSS(R) E-style. returns a dict with all the keys later pass this dict to printptistr with differents _transformerdtypes

Reference: PSSE 33 - POM - 5-20

Parses 3 PM transformer branch to PSS(R) E-style.

Parses PM area interchange to PSS(R) E-style

Parses PM branch data to PSS(R) E-style.

Parses PM Bus data to PSS(R)E-style.

Parses PM fixed shunt to PSS(R)E-style

Parses PM generator data to PSS(R)E-style.

Create a header for the case

Parses PM interarea to PSS(R) E-style

Parses PM Load data to PSS(R)E-style.

Parses PM zone to PSS(R) E-style

Parses PM fixed shunt to PSS(R)E-style

Parses PM dcline to PSS(R)E style

Parses PM zone to PSS(R) E-style

_populate_defaults!(pti_data)

Internal function. Populates empty fields with PSS(R)E PTI v33 default values

Given a PTI component dict print it in the .raw file

Export power network data to a file in the pti format

Export power network data in the pti format

export_pti(io::IO, data::Dict{String, Any})

Export PowerModels network data dictionary to the as a power flow raw data acording to the pti format RAW V33.

It is highly recommend to export the PowerModel data dictionary in the same format as the source data.

The export_pti function exports the essential components of a network:

• Buses
• Loads
• Fixed Shunts
• Generators
• Non Tansformers Branchs
• Transformers (Two-Windings and Three-Windings)
• Switched Shunts (aproximate)

If the PowerModels was parsed from a pti file with the import_all=true parameter: data = parse_file(case3.raw, import_all=true)

It will export these aditionals items:

• Header Options
• Comment Lines
• Zone Data
• Area Data
• Owner Data
• Switched Shunts (with block steps)

Things that are not exported:

• TNEP network specification
• Generation Cost Data
• Storage
• Switches
• DC Lines (future work, #754)

Things that are not exported if you use import_all = true to make the PowerModel data dict:

• FACTS (Maybe in future work)
• GNE (No intentions to export it)
• Inter Area Transfer Data (No intentions to export it)

parse_pti(io::IO)

Reads PTI data in io::IO, returning a Dict of the data parsed into the proper types.

parse_pti(filename::String)

Open PTI raw file given by filename, returning a Dict of the data parsed into the proper types.