SOPFLOW able to read contingencies in PSS/E format

[wperkins]

Merge request type

• New feature

Relates to

• SOPFLOW

This MR updates

• Header files
• Source code
• Manual
• Other

Summary

This PR makes SOPFLOW understand contingencies in PSS/E format. Like SCOPFLOW, the contingency file format is determined by the file extension: .con indicates PSSE, .cont is the ExaGO NATIVE (PTI) format.

Closes #107.

[wperkins]

@cameronrutherford, in this PR I've added a utility script. I did not see an appropriate place to put it, so made a new directory, scripts, and put it there. Is this a precedent that should be set?

[wperkins]

The Python script I've added converts ExaGO/PTI contingency format files to PSS/E format. This was used to generate input to PowerWorld from ExaGO cases. The script should be modified, or another script added, to go the other way. At this time, I don't have time to do that.

[cameronrutherford]

@abhyshr there are conflicts with the user manual that don't allow an auto-rebase, but with a re-review and perhaps some more documentation to explain the scripts added this is good to merge.

[maksud]

Was able to build python library using python version 3.12 and version 3.13 does not work.

Ran python contingency_psse_native.py ../datafiles/case9/case9.con which converts case9.con file (PSS/E format) to NATIVE format.

Output:

1,2,0,4,5,'1 ',1,0,0.01
2,2,0,4,6,'1 ',1,0,0.01
3,2,0,5,7,'1 ',1,0,0.01
4,2,0,6,9,'1 ',1,0,0.01
5,2,0,7,8,'1 ',1,0,0.01
6,2,0,8,9,'1 ',1,0,0.01
7,1,1,0,0,'1 ',1,0,0.01
8,1,2,0,0,'1 ',1,0,0.01
9,1,3,0,0,'1 ',1,0,0.01

Ran python contingency_native_psse.py ../datafiles/case9/case9.cont which converts case9.cont (in NATIVE format) to PSS/E format

Output:

CONTINGENCY L_4-5_1_1
OPEN BRANCH FROM BUS 4 TO BUS 5 CIRCUIT 1
END
CONTINGENCY L_4-6_1_2
OPEN BRANCH FROM BUS 4 TO BUS 6 CIRCUIT 1
END
CONTINGENCY L_5-7_1_3
OPEN BRANCH FROM BUS 5 TO BUS 7 CIRCUIT 1
END
CONTINGENCY L_6-9_1_4
OPEN BRANCH FROM BUS 6 TO BUS 9 CIRCUIT 1
END
CONTINGENCY L_7-8_1_5
OPEN BRANCH FROM BUS 7 TO BUS 8 CIRCUIT 1
END
CONTINGENCY L_8-9_1_6
OPEN BRANCH FROM BUS 8 TO BUS 9 CIRCUIT 1
END
CONTINGENCY G_7_1_1
REMOVE UNIT 1 FROM BUS 1
END
CONTINGENCY L_1-4_1_7
OPEN BRANCH FROM BUS 1 TO BUS 4 CIRCUIT 1
END
CONTINGENCY G_8_1_2
REMOVE UNIT 1 FROM BUS 2
END
CONTINGENCY L_2-7_1_8
OPEN BRANCH FROM BUS 2 TO BUS 7 CIRCUIT 1
END
CONTINGENCY G_9_1_3
REMOVE UNIT 1 FROM BUS 3
END
CONTINGENCY L_3-9_1_9
OPEN BRANCH FROM BUS 3 TO BUS 9 CIRCUIT 1
END

[maksud]

With the minor modification as posted as comments. Also add a note that it works for Python 3.12 as of now.

[pelesh]

lgtm