==== Warning ====

Scripts are unrestricted programs that can do anything. Do not run a script sent to you unless you trust the developer who wrote it.

==== Overview ====

Scripting allows you to write short Java programs to automate tasks. They can be used for building models, for importing/exporting data or to run simulations. 

Scripts can be imported to a project, or be run separately. Scripts that are imported in a project can be configured to launch automatically during different stages of a simulation by creating [[#Script Actions]].

For instructions on how to write scripts and for examples, see [[Creating Scripts]]


==== Importing a script to a project ====

1. In the [[Projects window]], expand the project folder. 

2. Right-click the **Scripts** folder, and select **Add...**

3. Select a file from the window which appears.

**Note**: You can also import .class files or .jar files that contain resources required by the script.

==== Running a script ====

To run a script which has //not// been imported into a project:

1. Open the **Script** menu in the [[menu bar]]. 

2. From the menu, select **Run script...**.

3. Select the script file to run.

To run a script which has been imported:

1. In the [[Projects window]], expand the project folder. 

2. Expand the **Scripts** folder. This is only possible if scripts have been imported to the project.

3. Right-click the script you wish to run and choose **Run script...**

==== Script Actions ====

Scripts can be configured to automatically execute during a simulation. The most common use is to perform post processing of results, or to export results, once a simulation has completed. They can also be used to inject parameter data or to provide visual feedback during a simulation.

==== See also ====

  - [[Creating scripts]]
  - [[Example scripts|Examples]]