docs.unity3d.com
Search Results for

    Show / Hide Table of Contents

    Sensor types reference

    Find the sensor types Simulation Pro provides and their properties.

    This reference covers the properties and published topics for each sensor type. To add a sensor to your scene, refer to Add a sensor to a scene. For an overview of how sensors work, refer to Introduction to sensors.

    Camera sensor

    CameraSensor captures RGB and depth images from an attached Camera and publishes them as sensor_msgs/Image and sensor_msgs/CameraInfo messages.

    The following properties configure CameraSensor:

    Property Description
    UpdateRate Capture frequency in Hz.
    HorizontalFov Horizontal field of view, in degrees.
    ImageWidth / ImageHeight Output image resolution, in pixels.
    ClipNear / ClipFar Near and far clip planes, in meters.
    Camera The Camera component this sensor reads from.
    ImageDataOutput SensorPort<RenderTexture> carrying the rendered RGB image.

    CameraSensor publishes the following topics:

    Publisher node Message type Default content
    Image publisher sensor_msgs/Image Encoded RGB image.
    Depth publisher sensor_msgs/Image Per-pixel depth (distance in meters).
    Camera info publisher sensor_msgs/CameraInfo Intrinsic calibration for the RGB camera.
    Depth camera info publisher sensor_msgs/CameraInfo Intrinsic calibration for the depth camera.

    Fisheye camera sensor

    FisheyeCameraSensor extends CameraSensor with a fisheye projection model using a pre-built lookup table (LUT). It renders a wide-angle image and warps it through the LUT to produce the fisheye output. Configure the LUT parameters in the Inspector. FisheyeCameraSensor builds the LUT once, at InitializeSensor().

    Time-of-flight sensor

    TofSensor extends CameraSensor and additionally converts the depth image into a 3D point cloud (sensor_msgs/PointCloud2) through a DepthToPointCloudNode.

    TofSensor publishes the following topic in addition to the CameraSensor topics:

    Publisher node Message type
    Depth point cloud publisher sensor_msgs/PointCloud2

    Stereo depth sensor

    StereoDepthSensor runs a stereo-matching algorithm on images from two cameras (left and right) to produce a depth map and, optionally, a point cloud. Configure the left and right camera topic subscriptions in the Inspector. Published topics include a depth image and a depth error image.

    Physics LiDAR sensor

    PhysicsLidarSensor simulates LiDAR using Unity's Physics.Raycast system. In progressive mode, PhysicsLidarSensor distributes raycasts across multiple fixed-update frames based on the configured rotation rate, and a complete sweep produces one message.

    The following properties configure PhysicsLidarSensor:

    Property Description
    UpdateRate Horizontal sweep frequency in Hz.
    OutputType LaserScan or PointCloud2.

    Raster LiDAR sensor

    RasterLidarSensor simulates LiDAR by rendering depth images using the GPU rasterization pipeline. It's faster than the physics LiDAR sensor for dense point clouds, but requires a compatible render pipeline (URP or HDRP).

    The following properties configure RasterLidarSensor:

    Property Description
    UpdateRate Horizontal sweep frequency in Hz.
    VerticalSampleCount Number of beams in the vertical spread.
    OutputType LaserScan or PointCloud2.

    Ray-traced LiDAR sensor

    RayTracedLidarSensor uses a Vulkan ray-tracing backend for high-fidelity LiDAR simulation, computing accurate per-beam hit distances and intensities. It supports multiple movement technologies (spinning, DC, solid-state), optional motion correction (de-skewing based on sensor pose during the sweep), beam divergence simulation, and laser configuration assets (LaserConfigAsset subclasses) for real-device emulation.

    Note

    This sensor requires a GPU that supports Vulkan ray tracing and a Linux or Windows build target. Editor simulation is supported on compatible hardware.

    The following properties configure RayTracedLidarSensor:

    Property Description
    OutputType LaserScan or PointCloud2.
    LaserConfigAsset Optional BaseLaserConfigAsset that defines the beam layout.

    Laser configuration assets

    LiDAR sensors support BaseLaserConfigAsset ScriptableObjects that define the beam layout for real-device emulation.

    The following BaseLaserConfigAsset types are available:

    Type Description
    LaserConfigAsset Arbitrary beam angles defined by a list.
    FrustumLaserConfigAsset Beams distributed across a frustum.
    GridLaserConfigAsset Regular grid beam layout.
    SingleForwardLaserConfigAsset Single forward-facing beam, for simple 1D ranging.

    IMU sensor

    ImuSensor reads linear acceleration and angular velocity from an ArticulationBody and publishes them as sensor_msgs/Imu messages. This sensor requires an ArticulationBody on the same GameObject.

    The following properties configure ImuSensor:

    Property Description
    UpdateRate Publication frequency in Hz.
    Noise.Mean / Noise.Stddev Gaussian noise parameters applied to the IMU readings.

    Joint sensor

    JointSensor reads ArticulationBody positions, velocities, and efforts for all joints in the hierarchy and publishes them as sensor_msgs/JointState messages.

    The following properties configure JointSensor:

    Property Description
    UpdateRate Publication frequency in Hz.

    Additional resources

    • Introduction to sensors
    • Add a sensor to a scene
    In This Article
    Back to top
    Copyright © 2026 Unity Technologies — Trademarks and terms of use
    • Legal
    • Privacy Policy
    • Cookie Policy
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)