107. Modifying actors

You can modify actors and their behavior in a Smart Replay scenario in the Foretify Manager GUI. You can also modify actor behavior using the Smart Replay scenario modifiers.

107.1 Modifying actors behavior in Foretify Manager

In Foretify Manager, when you add the actors they are added to the Extract Test tab.

107.1.1 Changing actor names

1. Click the Edit icon to open the actor's information.

   

2. Enter the changes to the Actor name.

   

3. Click Done

   

107.1.2 Modifying actor behaviors

The following actor behaviors can be modified:

• Speed
• Lateral shift

107.1.2.1 Modifying speed behavior

1. Click the Edit icon next to an actor.

   

2. Click Add and then select Change Speed.

   

3. In the Speed Modification Behavior window, enter the required changes:

   

   Parameter	Description
   Start time range	Defines when the modification begins. Specify a single value in the From field to start at an exact time. To allow flexibility, use both From and To to define a time range.
   Start ramp-up duration range	Indicates the preferred duration over which the speed change should occur. A shorter duration results in a quicker transition, while a longer duration leads to a smoother, more gradual change.
   Speed target range	Defines the target speed for the actor. Use the From field alone for a fixed speed, or use both From and To to define a range.
   Units	Specifies the units used for speed (e.g., m/s, km/h).
   Relative or Absolute	Determines whether the speed modification is relative to the current speed or an absolute value. When set to Relative, negative values can be used to reduce speed.

4. Click Save Behavior.

   

107.1.2.2 Restoring default speed behavior

To restore the default speed behavior:

1. Click Add Behavior, and then select Change Speed.

   

2. In the Speed Modification Behavior window, select the checkbox Restore default speed behavior.

   

3. Configure the Start time range and Start ramp-up duration range.

   Parameter	Description
   Start time range	Specifies when the actor's speed modification should begin transitioning back to its original value. This time is relative to the original scenario run.
   Start ramp-up duration range	Defines the duration (in seconds) for the actor to return to its original values. Shorter durations result in a faster reset, while longer durations allow for a smoother transition.

4. Click Save Behavior

   

107.1.2.3 Modifying position behavior

After adding actors, you can set their lateral shift.

1. Click the Edit icon next to an actor.

   

2. To change lateral shift, click Add and then select Lateral Shift.

   

3. In the Lateral Modification Behavior window, enter the required changes:

   

   Parameter	Description
   Start time range	Defines when the lateral shift should begin. Use the From field for a specific start time. To introduce variability, specify both From and To to create a time window.
   Start ramp-up duration range	Indicates the desired duration for the lateral shift transition. A smaller value results in a quicker shift, while a larger value produces a more gradual movement.
   Direction	Specifies the direction of the lateral shift, typically either Left or Right.
   Position shift range	Determines how far the actor should shift laterally. Use the From field for a fixed shift amount, or provide both From and To to define a range of possible shifts.
   Units	Specifies the measurement units for the shift distance (e.g., meters, feet).

   For example, suppose a speed modifier is predefined with a speed target range of [4..6] that starts at 3 seconds. To terminate this modifier at 7 seconds, you can define another speed modifier by selecting Restore default speed and specifying the Start time range to stop the previously defined modifier.

4. Click Save Behavior.

   

107.1.2.4 Restoring lateral shift behavior

To restore the lateral shift behavior:

1. Click Add Behavior, and then select Lateral Shift.

   

2. In the Speed Modification Behavior window, select the checkbox Restore default position behavior.

   

3. Configure the Start time range and Start ramp-up duration range.

   Parameter	Description
   Start time range	Specifies when the actor lateral shift modification must begin transitioning back to its original values. This time is relative to the original scenario run.
   Start ramp-up duration range	Defines how long (in seconds) the actor should take to return to its original values. Shorter durations result in a faster reset, while longer durations allow for a smoother transition.

4. Click Save Behavior.