Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Run Rehearsal module allows the user to run simulations of an elections event. To access this module, select the Rehearsal tab from the navigation bar.

...

Starting a Rehearsal Simulation

To run a simulation, first choose a rehearsal scenario from the Rehearsal Scenario drop-down list. If non none are available, please create one as outlined in the Rehearsal Setup document.

Note

Be aware that running a rehearsal simulation willoverwrite the polls and votes for the contests of the elections event in the database. It won’t change the elected and acclaimed flags though as these flags are managed manually in FlowChameleon.

...

Before starting the simulation run, check the Step Duration value and modify it as desired. This duration value is only kept for this run. If the duration change is wanted for all future runs of the selected scenario, press on the Save Duration button (blue star).

Note that the grid will show the rehearsal steps for step 0 which will reset all the votes and polls to 0 when a simulation is started. You can change which step the simulation run starts on by changing the value in the Select Step control (blue star) or pressing on the Next Step button (blue star) to advance the steps shown in the grid.

Also note that on Step 0, you are not allowed to edit the votes and polls values for the contests.

Start the simulation by clicking on the Start Simulation button (blue star). The will change the button label to be Stop Simulation (blue star) and also enable the Auto Next Step button (blue star).

...

This will write the values of step 0 (or whatever the start step you selected prior to starting the simulation) into the database.

Once a simulation run is started for a Rehearsal Scenario, any Rehearsal Setup and Generate Step pages that have their scenarios selected with the same scenario will not be allowed to change any of the scenario’s settings. Deletion of the scenario will also be disallowed.

You can start the Auto Next Step timer if you wish by clicking on the Auto Next Step button (blue star). This will start the timer and will show the count down time on the left of the button. Once the timer reaches 0:00, the step value will be advanced to the next step and the timer restarted.

...

To stop the timer, press the Auto Next Step button (blue star) again. You can always advance the step by pressing on the Next Step button (blue star) at any time during the simulation run. If the Auto Next Step timer is running, this will reset the timer after the Next Step button is pressed.

...

If you wish to end the simulation, click on the Stop Simulation button (blue star). This will also disable the Auto Next Step feature if it is in use. The label of the button will switch back to show Start Simulation.

...

Here is an example of the Results page showing an active simulation run on rehearsal step 2:

...

Editing a Contest’s Results

You can edit a contest’s results on any non-zero step by clicking on the Edit icon (blue star) on the left side of the grid row for the contest. The Edit dialog will look the same as the one available in the Generate Steps module.

...

Modify any of the votes or the polls value as needed and then press the Update Now button (blue star) to save the changes.

If the rehearsal simulation is started, the new values will be output on the results when the changes are saved.

Multiple Rehearsal Simulation Runs

As of version 16.1.3.5 or later, you can run more than one Rehearsal Scenario at a time so long as the scenarios are different and do not reference the same Election Event. To do this, you will have to open up a browser tab or window for each of the different Rehearsal runs.

There will be a lock-out mechanism that prevents different Rehearsal pages from running the same scenario or a scenario with the same Election Event. When a scenario is selected from the Rehearsal Scenario drop-down list and it or its Election Event is being used in an active Simulation Run, you will see red text to the right of the Start Simulation button indicating so.

...

The Start Simulation button will also be disabled. Along with the red warning text, there will be an information icon (blue star) which when pressed will bring up an information tooltip showing who is running the other simulation and what scenario is being used.

...

There will also be a Stop Other Run button (blue star) to the right of the red warning text that will be visible. You can press this button to end the currently active simulation run. Of course, you should only do this if you know that the other run has been abandoned or is a result of a run that can no longer be accessed due to its browser being closed before the run was stopped.