# LiDAR Analysis Object

After your room is all setup, you can add the different LiDAR Analysis object to simulate the placement of these sensors within your space.

The LiDAR Analysis object is the object that is managing the simulation of a LiDAR sensor and how the rays are projected out and where it will hit a surface in a 3D space.

The same LiDAR Analysis object is responsible for the simulation of the following types of LiDAR:

* [Frustum](/grid/lidar-analysis/lidar-analysis-object/frustum.md)
* [2D Rotation](/grid/lidar-analysis/lidar-analysis-object/2d-rotation.md)
* [3D Rotation](/grid/lidar-analysis/lidar-analysis-object/3d-rotation.md)

## General Settings

### 1. Creating the Object

Create the `Lidar Analysis` Object from the project tree.

***

### 2. Choosing LIDAR Type

After creating the object, the next thing you would most likely want to do is the choose the appropriate LiDAR type. 

Under the `Lidar Analysis` Tab, within the `Lidar` container, you have and its detail settings. 

You can manually choose the type of LiDAR and define the appropriate settings.

Please refer to the individual LiDAR type pages for more details on how to configure the settings.

To help with quicker setup, you can find the container icon where you can see some predefined LiDAR settings for the LiDAR that are supported directly within Grid Studio.

<figure><img src="/files/51ziIP9s0RgfMIygilaf" alt=""><figcaption></figcaption></figure>

***

### 3. Placing the LiDAR in the Correct Location

No matter which type of LiDAR you are working with, you would need to define where it is in 3D space.

This is controlled by the `Position` parameter under the `Coordinates` tab.

<figure><img src="/files/KoyRPMnWjk2ztpdgYKt7" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can add an actual LiDAR sensor object and put the LiDAR Analysis object as a child of it.  \
\
In that case, place your actual LiDAR sensor object in the correct location.\
\
When the LiDAR Analysis object is a child object to your LiDAR sensor object, make sure the entire `Coordinates` container is reset to default (position & rotation = 0,0,0 and scale =1). This way the LiDAR Analysis object is sitting exactly where your LiDAR is placed in your 3D viewport.
{% endhint %}

***

### Optional Step: Exclude Objects

<figure><img src="/files/ClTNiF4B3m3LQYVWDov1" alt=""><figcaption></figcaption></figure>

It is possible for each of the analysis to add objects that you want to exclude from the calculation.

***

### 4. Run the Analysis

Under the LiDAR Analysis section, you have the main button `Calculate Rays` which will trigger the object to analysis its current position and all 3D mesh that is within the viewport.

<figure><img src="/files/Bn0BHh0OdXI4z9NHsHGq" alt=""><figcaption></figcaption></figure>

It will render the resolution of your LiDAR sensor and draw how each of the rays will land on the different surfaces.&#x20;

***

### 5. Adjusting the Display

#### Point Size

You can define the size of point which represent the landing location of each of the rays.

#### Gradient

You can also define the gradient that represent the distance between the sensor and where the ray is landing.&#x20;

This helps to visualize the relative distance of the surface to the LiDAR sensor which is useful to visualise the density of the points.

#### Beams

{% hint style="danger" %}
Turning this on will increase the rendering load on your system dramatically.

Only enable this setting when necessary.
{% endhint %}

Inside the `Display` tab of LiDAR Analysis object, there is an addition setting called `Show Beams`.&#x20;

<figure><img src="/files/oJwdQtynArCsEYxvrkIc" alt=""><figcaption></figcaption></figure>

This toggles the rendering of all individual beams of LiDAR coming from the LiDAR Analysis based on the resolution details defined in the object.

In some situation it might be helpful to see these beams.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stage-precision.gitbook.io/grid/lidar-analysis/lidar-analysis-object.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.