How to test CrowdMechanics

After modifying the C++ code, run a series of eight series of tests (covering distinct scenarios) by following the steps below:

  1. Navigate to the tests/mechanical_layer directory.

  2. Run the following command in the terminal:

    ./run_mechanical_tests.sh

  3. To further visualize the results of the tests as videos, ensure that ffmpeg is installed. And run the following command in the terminal:

    ./make_tests_videos.sh

    All videos are saved in the tests/mechanical_layer/videos folder.

Note

  • If ffmpeg is not already installed, installation instructions can be found on the official website: https://ffmpeg.org/.

  • The details of the test series are described in Mechanical layer (C++). These tests are designed to verify the behavior of each mathematical term in the mechanical model and are not intended as comparisons with experimental data. They rely on tolerance thresholds that the user can adjust in the respective test folders if necessary.

The eight test scenarios are as follows:

  1. Agent pushing another agent (test_push_agent_agent folder)

    Tests the force orthogonal to the contact surface, representing a damped spring interaction between two agents.

  2. Agent colliding with a wall (test_push_agent_wall folder)

    Tests the force orthogonal to the contact surface, representing a damped spring interaction between an agent and a wall.

  3. Agent sliding over other agents (test_slip_agent_agent folder)

    Tests the Coulomb friction interaction between two agents as one slides over the other.

  4. Agent sliding over a wall (test_slip_agent_wall folder)

    Tests the Coulomb friction interaction between an agent and a wall as the agent slides.

  5. Agent translating and relaxing (test_t_translation folder)

    Tests the behaviour as an agent undergoes a translation and gradually relaxes to a stationary state (no motion), due to the fluid-like force with the damping coefficient of \(1/t^{(\text{translation})}\).

  6. Agent rotating and relaxing (test_t_rotation folder)

    Tests the behaviour as an agent rotates and gradually relaxes to a stationary state (no motion), due to the fluid-like torque with the damping coefficient of \(1/t^{(\text{rotation})}\).

  7. Agent rolling over other agents without sliding (test_tangential_spring_agent_agent folder)

    Tests the force tangential to the contact surface, representing a damped spring interaction between two agents.

  8. Agent rolling over a wall without sliding (test_tangential_spring_agent_wall folder)

    Tests the force tangential to the contact surface, representing a damped spring interaction between an agent and a wall.