Creating a Simulation Script

You can write scripts to execute commands or simulate various events and run them sequentially.

Note: If you have purchased only the Transient Motor Starting module and not the Dynamic Stability module, your menus and options will reflect the names "Transient Motor Starting" or "TMS" instead of Dynamic Stability.

To write a new script:

Click Script Edit on the Stability tab.
Click New to add a new script.
Type the name of the new script.
Add commands to the script in a sequential order as shown in the figure below.
Click OK and then click Close.

Edit Script Columns

Figure 1: Script Example

Column	Description
Command	The command to be executed (event to be simulated), such as closing a breaker a faulting a bus.
Equipment ID	The ID Name of the equipment for which the command is applicable. For example, the ID Name of the breaker to be closed.
Value 1, Value 2	Fault resistance and reactance respectively, specified in Ohms.
Time	The time in seconds up to which or for which duration the command is executed.

Edit Script Commands

The commands available in the Edit Script dialog are described below:

Command	Description
Fault Bus (R+jX Ohms)	Faults the specified bus. Faults with impedance, such as arcing faults, can have resistance and/or reactance positive values. Bolted faults have zero impedance. When this command is executed, the fault clears only when an upstream protective device opens or the Remove Fault command is run. Compare with Fault Bus for command. Only one equipment item can be faulted at a time during the simulation.
Fault Bus For (R+jX Ohms)	The specified bus is faulted for the duration specified in the Time column. Compare with Fault Bus command. Only one equipment item can be faulted at a time during the simulation.
Remove Fault	Removes the existing fault.
Run to Time	Runs the simulation up to the specified time in seconds. This is the point in time from the start of the simulation, and therefore is the absolute time. The next command is executed only after the specified point in time has elapsed. If you have several Run to Time commands, make sure that the elapsed time before the start of the command is less than the specified time. Make sure you have Run for Time or Run to Time commands in your script so that events are simulated at the appropriate time.
Run for Time	Runs the simulation for the specified duration in seconds. The next command is executed only after the specified duration has elapsed.
Close LV Breaker	Closes the specified LV breaker.
Close HV Breaker	Closes the specified HV breaker.
Open LV Breaker	Opens the specified LV breaker.
Open HV Breaker	Opens the specified HV breaker.
Close Switch	Closes the specified switch.
Close Fused Switch	Closes the specified fused switch.
Open Switch	Opens the specified switch.
Open Fused Switch	Opens the specified fused switch.
Transfer ATS	Transfers the connection of the ATS from one source to the alternate.
Enable Contactors	This command enables simulation of contactors dropping out. You can also enable contactor action globally through Dynamic Stability Options. While a simulation is performed from the script, the script command is followed regardless of how the contactor action option was specified in the Dynamic Stability Options. After the simulation is complete, the script command is no longer effective—the Dynamic Stability Option prevails.
Disable Contactors	Disables simulation of contactors dropping out. This command is effective only while the script is being run.
Enable Prot Devices	Enables simulation of protective devices pickup and tripping. This command is effective only while the script is being run.
Disable Prot Devices	Disables simulation of protective devices pickup and tripping. This command is effective only while the script is being run.
Set Time Step	Specifies the time interval for each computation of simulation. This time step is used to set the time step different than what is specified in the Dynamics Stability Options. This time step is effective only while the script is being run and the time step is not changed with another command in the script.

Next: Dynamic Stability Options

More Information

Dynamic Stability
Dynamic Stability Options