Parsers#

parse_rawx(path)#

Parse a PSS(R)E RAWX case without validating its records.

Parameters:

path -- Path to the RAWX or JSON file.

Returns:

The parsed case.

Raises:

  • OSError -- If the file cannot be read.

  • JSONDecodeError -- If the file does not contain valid JSON.

  • ValueError -- If the document has no network object.

parse_raw(path)#

Parse a PSS(R)E RAW case without validating its records.

Parameters:

path -- Path to the RAW file.

Returns:

The parsed case.

Raises:

  • OSError -- If the file cannot be read.

  • ValueError -- If the file is too short, has no header, or contains malformed data.

parse_matpower(path)#

Parse a MATPOWER case without validating its records.

Parameters:

path -- Path to the MATPOWER .m file.

Returns:

The parsed case.

Raises:

  • OSError -- If the file cannot be read.

  • ValueError -- If the file exceeds 50 MB or contains no bus data.

parse_dss(path)#

Parse one supported OpenDSS snapshot command file.

Parameters:

path -- Root DSS file path.

Returns:

The interpreted source circuit. The function does not solve it.

Raises:

DssParseError -- The file contains invalid or unsupported electrical semantics.

class DssParseError#

Report unsupported or invalid snapshot source semantics.