Simulation with Dynawo

The dynamic module allows to run time domain simulation.

ModelMapping

ModelMapping()	class to map elements of a network to their respective dynamic behavior
ModelMapping.add_base_load([df])	Add a load mapping
ModelMapping.add_load_one_transformer([df])	Add a load with one transformer mapping
ModelMapping.add_load_one_transformer_tap_changer([df])	Add a load with one transformer and tap changer mapping
ModelMapping.add_load_two_transformers([df])	Add a load with two transformers mapping
ModelMapping.add_load_two_transformers_tap_changers([df])	Add a load with two transformers and tap changers mapping
ModelMapping.add_base_generator([df])	Add a base generator mapping
ModelMapping.add_synchronized_generator([df])	Add a synchronized generator mapping
ModelMapping.add_synchronous_generator([df])	Add a synchronous generator mapping
ModelMapping.add_wecc([df])	Add a WECC mapping
ModelMapping.add_grid_forming_converter([df])	Add a grid forming converter mapping
ModelMapping.add_hvdc_p([df])	Add an HVDC P mapping
ModelMapping.add_hvdc_vsc([df])	Add an HVDC VSC mapping
ModelMapping.add_base_transformer([df])	Add a transformer mapping
ModelMapping.add_base_static_var_compensator([df])	Add a static var compensator mapping
ModelMapping.add_base_line([df])	Add a line mapping
ModelMapping.add_base_bus([df])	Add a base bus mapping
ModelMapping.add_infinite_bus([df])	Add an infinite bus mapping
ModelMapping.add_overload_management_system([df])	Add a dynamic overload management system (not link to a network element)
ModelMapping.add_two_levels_overload_management_system([df])	Add a dynamic two levels overload management system (not link to a network element)
ModelMapping.add_under_voltage_automation_system([df])	Add a dynamic under voltage automation system (not link to a network element)
ModelMapping.add_phase_shifter_i_automation_system([df])	Add a dynamic phase shifter I automation system (not link to a network element)
ModelMapping.add_phase_shifter_p_automation_system([df])	Add a dynamic phase shifter P automation system (not link to a network element)
ModelMapping.add_tap_changer_automation_system([df])	Add a dynamic tap changer automation system (not link to a network element)
ModelMapping.add_tap_changer_blocking_automation_system(df, ...)	Add a dynamic tap changer blocking automation system (not link to a network element)

EventMapping

EventMapping()	Class to map events
EventMapping.add_disconnection([df])	Creates an equipment disconnection event
EventMapping.add_active_power_variation([df])	Creates an equipment active power variation event
EventMapping.add_node_fault([df])	Creates a bus node fault event

OutputVariableMapping

OutputVariableMapping()	Class to map Curves and Final State Values
OutputVariableMapping.add_dynamic_model_curves(...)	Adds curves mapping on a single dynamic model
OutputVariableMapping.add_standard_model_curves(...)	Adds curves mapping on a single network equipment without dynamic model
OutputVariableMapping.add_dynamic_model_final_state_values(...)	Adds final state values mapping on a single dynamic model
OutputVariableMapping.add_standard_model_final_state_values(...)	Adds final state values mapping on a single network equipment without dynamic model

Simulation

Simulation()
Simulation.run(network, model_mapping, ...)	Run the dynawo simulation

Results

SimulationResult(handle)	Can only be instantiated by run()
SimulationResult.status()	Status of the simulation (SUCCESS or FAILURE)
SimulationResult.status_text()	Status text of the simulation (failure description or empty if success)
SimulationResult.curves()	Dataframe of the curves results, columns are the curves names and rows are timestep
SimulationResult.final_state_values()	Dataframe of the final state values results, first column is the fsv names, second one the final state values
SimulationResult.timeline()	Dataframe of the simulation timeline, first column is the event time, second one the model name and the third one the event message