# Configure the Camera Analysis Object

The **Camera Analysis** object defines the 3D area that should be analyzed.

Only the space inside this volume is used for the Camera Coverage & Overlap Analysis. Make sure the volume covers the complete tracking area that is relevant for the project.

### Position and Rotation

Select the **Camera Analysis** object and open the **Coordinates** tab in the **Inspector**.

Use the **Position** and **Rotation** parameters to place and align the analysis volume in the 3D scene.

<div align="left"><figure><img src="/files/CudIDnO5YwiRx24X9vIR" alt="" width="493"><figcaption></figcaption></figure></div>

The position and rotation should match the area where camera coverage needs to be evaluated. Areas outside the Camera Analysis volume are ignored during the calculation.

***

### Size

Open the **Camera Analysis** tab in the **Inspector**.

Use the **Size** parameter to define the dimensions of the analysis volume.

<div align="left"><figure><img src="/files/pY7iMOsVM1P0hiNbo4VJ" alt="" width="489"><figcaption></figcaption></figure></div>

The size should cover the full tracking area that needs to be analyzed, including the height, width, and depth of the usable tracking space.

***

### Assign Cameras

The Camera Analysis object only uses cameras that are assigned to it.

Select the **Camera Analysis** object and open the **Camera Analysis** tab in the **Inspector**.

In the **Camera** section, click the **+** button to add a new camera slot. Each slot contains a **Target** field.

Click **\[Select an Object]** in the Target field and select the camera that should be included in the analysis.

Repeat this process for every camera that should contribute to the coverage calculation.

<div align="left"><figure><img src="/files/qzJ5U5XCl9lsWQxsl46y" alt="" width="491"><figcaption></figcaption></figure></div>

Assigned cameras are displayed as object paths in the Target fields.

To remove a camera from the analysis, click the **X** button on the corresponding camera slot.

{% hint style="info" %}
Only cameras assigned in the Camera section are used by the Camera Analysis object. Cameras that exist in the Project Tree but are not assigned here are ignored during the calculation.
{% endhint %}

***

### Assign Occlusion Objects

Optional occlusion objects can be assigned in the **Shadow Objects** section of the Camera Analysis object.

Select the **Camera Analysis** object and open the **Camera Analysis** tab in the **Inspector**.

In the **Shadow Objects** section, click the **+** button to add a new occlusion object slot. Each slot contains a **Target** field.

Click **\[Select an Object]** in the Target field and select the imported mesh object that should be used as an occluder.

Repeat this process for every mesh object that should block camera visibility during the calculation.

Assigned occlusion objects are displayed as object paths in the Target fields.

<div align="left"><figure><img src="/files/WC57WtYh56C8miDt9jZi" alt="" width="489"><figcaption></figcaption></figure></div>

To remove an occlusion object from the analysis, click the **X** button on the corresponding slot.

{% hint style="warning" %}
Only imported mesh objects can be used for occlusion calculations. Referenced meshes may be visible in the viewport, but they do not provide polygon data to the Camera Analysis object.
{% endhint %}

{% hint style="info" %}
Use simple low-poly meshes as occluders whenever possible. High-detail geometry can increase project size and slow down the voxel calculation.
{% endhint %}

***

### Tip: Hide the Analysis Volume Wireframe

The Camera Analysis object displays a wireframe cube in the 3D viewport. This wireframe shows the position and size of the analysis volume.

If you want to hide the wireframe while keeping the generated voxels visible, reduce the alpha value of the object color.

This can be done in two ways:

* Use the small color field in the Inspector header.
* Open the **Display** tab and adjust the **Item Color** parameter.

Reducing the alpha value hides the wireframe lines of the analysis volume, but the voxel result remains visible in the viewport.

***

### Analysis Volume Checklist

Before continuing, make sure that:

* The Camera Analysis object is placed correctly using the **Position** parameters in the **Coordinates** tab.
* The Camera Analysis object is aligned correctly using the **Rotation** parameters in the **Coordinates** tab.
* The **Size** parameter in the **Camera Analysis** tab covers the relevant tracking volume.
* All cameras that should be included are assigned to the Camera Analysis object.
* Optional occlusion meshes are imported and assigned if blocked visibility should be calculated.


---

# 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/camera-analysis/using-camera-analysis/configure-the-camera-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.
