Step 9: Start the clock

When you first create your simulation, it has a clock but the clock isn't running. When your clock isn't running, your simulation won't update its state. After you start the clock, it will begin sending ticks to your apps. Each tick, your spatial apps step through the entities they own and commit the results to SimSpace Weaver

Note

It can take 30-60 seconds to start the clock.

Important

If you use AWS IAM Identity Center (successor to AWS Single Sign-On) or named profiles for the AWS Command Line Interface (AWS CLI), you must use SimSpace Weaver app SDK version 1.12.1 or higher. The latest version is 1.12.3. For information about SimSpace Weaver versions, see SimSpace Weaver versions. The SimSpace Weaver app SDK scripts use the AWS CLI. If you use IAM Identity Center, you can either copy your IAM Identity Center profile for the AWS CLI to your default profile or provide the name of your IAM Identity Center profile to SimSpace Weaver app SDK scripts with the --profile cli-profile-name parameter. For more information, see Configuring the AWS CLI to use AWS IAM Identity Center (successor to AWS Single Sign-On) in the AWS Command Line Interface User Guide and Named profiles for the AWS CLI in the AWS Command Line Interface User Guide.

Docker

To start the clock

1. If you aren't there already, go to the tools folder for your project and platform. Your project-folder is path\project-name using the values that you provided when you created the project.

   At a Windows command prompt, enter:

   cd project-folder\tools\windows

2. Use the CLI helper script to call the StartClock API.

   .\weaver-project-name-cli.bat start-clock --simulation simulation-name

   Note

   The StartClock API uses your simulation-name, which you can find using the ListSimulations API:

   .\weaver-project-name-cli.bat list-simulations

WSL

Important

We provide these instructions for your convenience. They are for use with Windows Subsystem for Linux (WSL), and are unsupported. For more information, see Set up your local environment for SimSpace Weaver.

To start the clock

1. If you aren't there already, go to the tools folder for your project and platform.Your project-folder is path/project-name using the values that you provided when you created the project.

   At a Linux shell prompt, enter:

   cd project-folder/tools/linux

2. Use the CLI helper script to call the StartClock API.

   ./weaver-project-name-cli.sh start-clock --simulation simulation-name

   Note

   The StartClock API uses your simulation-name, which you can find using the ListSimulations API:

   ./weaver-project-name-cli.sh list-simulations