jhw45birch / pypowerworld Goto Github PK

pypowerworld

==== OVERVIEW ====

pypowerworld provides a class as a user-friendly wrapper for the PowerWorld COM object. It initializes a class object with a loadflow case. If the case fails to open, the program does not error out but prints an error and proceeds without a case. The ‘open_case’ method may be used to attempt to open the PowerWorld case again.

==== REQUIREMENTS ====

pypowerworld requires COM which means it must be run on a Windows operating system. It also requires the user to have PowerWorld and SimAuto licenses. Any PowerWorld tools which require additional license are also necessary.

==== INPUT ====

The inputs are labeled similarly to the PowerWorld Auxiliary File documentation. The inputs can either be method parameters or attributes used to set data or get data from the PowerWorld program.

==== OUPUT ====

Data output is sent in dataframe format and set to the ‘output’ attribute. This is true only when the get data method is run. For all other operations, this attribute will be set to None.

==== ERROR HANDLING ====

If an error occurs, the ‘error’ attribute is set to True and the ‘error_message’ attribute is set to an error string value explaining the error. If an error is not encountered, the ‘error’ attribute is set to False and the ‘error_message’ is set to an empty string.

==== TYPICAL IMPLEMENTATION ====

   from pypowerworld import PowerWorld
   case_path = r'somepathsomecase.pwb'
   pw = PowerWorld(case_path)
   print(pw.solve())
   if pw.error:
       print("Error encountered solving power flow: %s" % pw.error_message)
   else:
       print("The case was solved using the Newton-Raphson method.")
   script_cmd = 'SolvePowerFlow(RECTNEWT);'
   if pw.run_script(script_cmd):
       print("The case was solved using the Newton-Raphson method.")
   else:
       print("Error encountered solving power flow: %s" % pw.error_message)