unreal.ScalarPositionArrayObservation

class unreal.ScalarPositionArrayObservation(outer: Object | None = None, name: Name | str = 'None')

Bases: LearningAgentsObservation

An observation of an array of positions along a single axis.

C++ Source:

  • Plugin: LearningAgents

  • Module: LearningAgents

  • File: LearningAgentsObservations.h

Editor Properties: (see get_editor_property/set_editor_property)

  • interactor (LearningAgentsInteractor): [Read-Only] Reference to the Interactor this observation is associated with.

classmethod add_scalar_position_array_observation(interactor, name='None', position_num=1, scale=100.000000) → ScalarPositionArrayObservation

Adds a new scalar position array observation to the given agent interactor. Call during ULearningAgentsInteractor::SetupObservations event.

Parameters:

  • interactor (LearningAgentsInteractor) – The agent interactor to add this observation to.

  • name (Name) – The name of this new observation. Used for debugging.

  • position_num (int32) – The number of positions in the array.

  • scale (float) – Used to normalize the data for the observation.

Returns:

The newly created observation.

Return type:

ScalarPositionArrayObservation

set_scalar_position_array_observation(agent_id=-1, positions, relative_position=0.000000) → None

Sets the data for this observation. The relative position can be used to make this observation relative to the agent’s perspective, e.g. by passing the agent’s position. Call during ULearningAgentsInteractor::SetObservations event.

Parameters:

  • agent_id (int32) – The agent id this data corresponds to.

  • positions (Array[float]) – The positions currently being observed.

  • relative_position (float) – The vector Positions will be offset from.

set_scalar_position_array_observation_with_axis(agent_id=-1, positions, relative_position=[0.000000, 0.000000, 0.000000], axis=[0.000000, 0.000000, 1.000000]) → None

Sets the data for this observation. The relative position can be used to make this observation relative to the agent’s perspective, e.g. by passing the agent’s position. Call during ULearningAgentsInteractor::SetObservations event.

Parameters:

  • agent_id (int32) – The agent id this data corresponds to.

  • positions (Array[Vector]) – The positions currently being observed.

  • relative_position (Vector) – The vector Positions will be offset from.

  • axis (Vector) – The axis along which to encode the positions