Skip to content

Researcher info

Mirka-S edited this page Mar 1, 2024 · 8 revisions

This page has a video of an example setup, as well as details on what every menu in the developer room does.

Developer room research setup step-by-step

  1. Choose an amount of boats in the boat generation menu and press generate
  2. For each boat set the amount of rowers and press regenerate boat in the boat menu
  3. Choose whether to put the race on distance or time in the training menu
  4. Indicate which boats are AI boats in the boat menu
  5. Set up the AI boat's speed and the base animation of the avatars in the boat menu
  6. Indicate which rowers are avatars in the non-AI boats
  7. Set up the rowers in all boats, indicating whether they need to copy an animation by filling in the matching settings
  8. Set up the rowers with the Setup rower guide up until entering the boat
  9. Check if all the websockets have been set up correctly in the rower menus of the participants
  10. Check the settings in the training menu for the starting and resetting requirements
  11. Have the rowers enter the seat
  12. Press start race
  13. When a training is completed, press stop race to reset
  14. Repeat step 11-13 for more trials with the same settings

The developer room

The developer room is the location in which menus that change things about the rowing system are located. This section discusses all the menus in details

Location

The developer room is located next to the main dock. In the image you can see a birds eye view of the platform. The developer room is the brown platform next to the dock. There is a gap in the fence around the deck that you can head trough to reach it as the researcher. 20240220145053_1

Camera feed

There is a screen in the developer room that shows a camera feed of the boats. This screen can be used to see any changes in the boats. image

Menus

Boat generation menu

image

In this menu fill in the amount of boats that are necessary and then click generate. Each boat contains 1 seats. The river size will automatically change based on the amount of boats. You might need to navigate back to the developer room after the world has changed size.

Boat menu

image The Boat menu allows you to put in settings for the whole boat and change some settings for all avatars.

Participant/non-AI boat (Boat 1) In the Boat 1 menu on the left bottom the basic screen can be seen. In this menu you are able to change the amount of rowers in the boat using rower count. Once you have the amount of rowers you want to have, click regenerate boat.

The stroke rate and stroke active menu is always present for boats. This controls the stroke rate of any avatars that have been activated in the boat. Any stroke animation attributes will only be applied each time the stroke is activated. If you have changed stroke settings for any avatar, restart the stroke.

AI/non-participant boat (Boat 2) Once the checkmark in the top right is clicked, the AI boat will be activated. This boat is automatically filled with avatars. There will now also be a menu on the left side to determine the speed of the boat. This can be done by three metrics: Difference, speed and time. Determined by the top bar.

Difference When choosing difference you can fill in which boat ID to match. The boat ID can be found in the tot left of the menu. You can also fill in the difference as a percentage. If you were to fill in 1% difference to a boat going 10km/h, the boat will travel at 10.1km/h.

Speed In this menu you can directly fill in a speed for the boat to travel at. This speed is in metres per second (m/s). You can also add a max speed delay which is the time the boat takes to get up to maximum speed.

Time/Distance This menu changes based on the training type, refer to the training menu. You can fill in the distance in metres or the finish time in seconds. The boat will then automatically calculate its speed based on the training length.

Rower menu

image The rower menu allows you to see information on seats claimed by participants, as well as change the settings for the avatar rower. Rower 1 is the stroke rower.

Participant rower (Boat 1 Rower 1) Once a participant (or researcher for participant) has claimed a seat (refer to the rower setup) , the menu will display some values related to the rower on the left. On the right the activity status of the RP3 interface and data WebSocket is displayed. These should both be green when the training is started.

Basic rower (Boat 1 Rower 2) When the seat the menu is connected to nor has a participant claimed the seat the menu will appear like this. The only thing displayed will be "Info will appear here"

Avatar rower (Boat 2 Rower 1 & 2) When the checkbox is marked on the avatar rower, an avatar will appear in the seat. This avatar can be animated to row at a certain pace. To animate it at a certain pace use the right side of the menu to set a strokerate and to activate the animation. To animate it based on another rower use the match function. At match boat fill in the boat ID of the rower you want to match. At match rower fill in the Rower ID that you want to match. For example match boat 1, match rower 1 will have the avatar row in the same tempo as the first (stroke) rower of boat 1. To delay the animation you can fill in a value in seconds in the delay field. This means the avatar will delay the movement for that long.

Start and stop buttons

image

Start training Start training will send the command to all boats to go and start rowing after the delay set in the training menu.

Stop training This will stop the training. Instantly returning all boats to the starting position. Use this to get boats back to the dock.

Training menu

image

The training menu can be used to set the settings that generalise over all boats.

Training type The first two options allow you to set the goal of the training at either distance or time.

General settings Starting delay This sets the time delay for the boat to start after the start button is pressed.

Start on full boat This will allow a boat to start the race when it is fully filled with rowers. This only starts the boat that is filled up by a human rower.

Reset after training This allows the boat to automatically reset after it has completed the training.

Automatically animate avatars This settings starts the rowing animation automatically upon the start of the training and disables it after completion.

Setting a distance/duration In this menu you can fill in either the distance of the training or the time that you will be rowing for.

Velocity multiplier

image

Change the value in the velocity multiplier to change the calculated speed of the boat. A higher multiplier means a higher calculated speed.

Template editor

image

This checkbox allows you to activate and change the template from which all boats and rowers are generated. You can change the templates the templates that appear in the world by navigating to them in the inspector. Or selecting them by pressing secondary on the Dev tool and then opening the inspector.

Menu templates image

Boat template image

Clone this wiki locally