docs.unity3d.com
    Show / Hide Table of Contents

    Class VectorSensor

    A sensor implementation for vector observations.

    Inheritance
    Object
    VectorSensor
    Inherited Members
    Object.ToString()
    Object.Equals(Object)
    Object.Equals(Object, Object)
    Object.ReferenceEquals(Object, Object)
    Object.GetHashCode()
    Object.GetType()
    Object.MemberwiseClone()
    Namespace: Unity.MLAgents.Sensors
    Syntax
    public class VectorSensor : ISensor, IBuiltInSensor

    Constructors

    VectorSensor(Int32, String, ObservationType)

    Initializes the sensor.

    Declaration
    public VectorSensor(int observationSize, string name = null, ObservationType observationType = ObservationType.Default)
    Parameters
    Type Name Description
    Int32 observationSize

    Number of vector observations.

    String name

    Name of the sensor.

    ObservationType observationType

    Methods

    AddObservation(Boolean)

    Adds a boolean observation to the vector observation of the agent.

    Declaration
    public void AddObservation(bool observation)
    Parameters
    Type Name Description
    Boolean observation

    Observation.

    AddObservation(IList<Single>)

    Adds a list or array of float observations to the vector observations of the agent.

    Declaration
    public void AddObservation(IList<float> observation)
    Parameters
    Type Name Description
    IList<Single> observation

    Observation.

    AddObservation(Int32)

    Adds an integer observation to the vector observations of the agent.

    Declaration
    public void AddObservation(int observation)
    Parameters
    Type Name Description
    Int32 observation

    Observation.

    AddObservation(Single)

    Adds a float observation to the vector observations of the agent.

    Declaration
    public void AddObservation(float observation)
    Parameters
    Type Name Description
    Single observation

    Observation.

    AddObservation(Quaternion)

    Adds a quaternion observation to the vector observations of the agent.

    Declaration
    public void AddObservation(Quaternion observation)
    Parameters
    Type Name Description
    Quaternion observation

    Observation.

    AddObservation(Vector2)

    Adds an Vector2 observation to the vector observations of the agent.

    Declaration
    public void AddObservation(Vector2 observation)
    Parameters
    Type Name Description
    Vector2 observation

    Observation.

    AddObservation(Vector3)

    Adds an Vector3 observation to the vector observations of the agent.

    Declaration
    public void AddObservation(Vector3 observation)
    Parameters
    Type Name Description
    Vector3 observation

    Observation.

    AddOneHotObservation(Int32, Int32)

    Adds a one-hot encoding observation.

    Declaration
    public void AddOneHotObservation(int observation, int range)
    Parameters
    Type Name Description
    Int32 observation

    The index of this observation.

    Int32 range

    The upper limit on the value observation can take (exclusive).

    GetBuiltInSensorType()

    Declaration
    public BuiltInSensorType GetBuiltInSensorType()
    Returns
    Type Description
    BuiltInSensorType

    GetCompressedObservation()

    Return a compressed representation of the observation. For small observations, this should generally not be implemented. However, compressing large observations (such as visual results) can significantly improve model training time.

    Declaration
    public virtual byte[] GetCompressedObservation()
    Returns
    Type Description
    Byte[]

    Compressed observation.

    Implements
    ISensor.GetCompressedObservation()

    GetCompressionSpec()

    Return information on the compression type being used. If no compression is used, return Default().

    Declaration
    public CompressionSpec GetCompressionSpec()
    Returns
    Type Description
    CompressionSpec

    An object describing the compression used by the sensor.

    Implements
    ISensor.GetCompressionSpec()

    GetName()

    Get the name of the sensor. This is used to ensure deterministic sorting of the sensors on an Agent, so the naming must be consistent across all sensors and agents.

    Declaration
    public string GetName()
    Returns
    Type Description
    String

    The name of the sensor.

    Implements
    ISensor.GetName()

    GetObservationSpec()

    Returns a description of the observations that will be generated by the sensor. See ObservationSpec for more details, and helper methods to create one.

    Declaration
    public ObservationSpec GetObservationSpec()
    Returns
    Type Description
    ObservationSpec

    An object describing the observation.

    Implements
    ISensor.GetObservationSpec()

    Reset()

    Resets the internal state of the sensor. This is called at the end of an Agent's episode. Most implementations can leave this empty.

    Declaration
    public void Reset()
    Implements
    ISensor.Reset()

    Update()

    Update any internal state of the sensor. This is called once per each agent step.

    Declaration
    public void Update()
    Implements
    ISensor.Update()

    Write(ObservationWriter)

    Write the observation data directly to the ObservationWriter. Note that this (and GetCompressedObservation()) may be called multiple times per agent step, so should not mutate any internal state.

    Declaration
    public int Write(ObservationWriter writer)
    Parameters
    Type Name Description
    ObservationWriter writer

    Where the observations will be written to.

    Returns
    Type Description
    Int32

    The number of elements written.

    Implements
    ISensor.Write(ObservationWriter)

    Extension Methods

    SensorExtensions.ObservationSize(ISensor)
    Back to top
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023