# Required Project Setup

Before running a Camera Coverage & Overlap Analysis, the required objects must be added to the **Project Tree**.

At minimum, the setup requires:

* A **Camera Analysis** object
* One or more **Camera** objects

Optional mesh objects can also be added when the analysis should include shadows, blocked visibility, or physical obstacles in the scene.

{% hint style="info" %}
To learn how to add objects to the Project Tree, see:\
[Adding Objects to a Project](/grid/grid-studio-fundamentals/fundamentals/interface/working-with-objects.md#creating-objects)
{% endhint %}

### Camera Analysis Object

The **Camera Analysis** object defines the area that will be analyzed.

This object represents the 3D volume in which Grid Studio calculates camera coverage, overlap, focus range, and visibility. Its position and size should match the tracking volume or area that is relevant for the setup.

All coverage results are generated inside this volume.

### Camera Objects

Camera objects define the virtual camera setup used for the analysis.

Each camera should be positioned and rotated to match the intended real-world camera position. The camera settings, such as field of view, focus point, and focus range, are used during the calculation to determine which parts of the analysis volume are visible and usable.

Only cameras assigned to the Camera Analysis object are included in the result.

### Optional Occlusion Meshes

Mesh objects can optionally be used as occlusion objects for the Camera Coverage & Overlap Analysis.

Occlusion meshes simulate physical objects that block the view of a camera, such as walls, pillars, stage structures, screens, set pieces, or other objects inside the tracking area. When assigned to the Camera Analysis object, these meshes are included in the voxel calculation and can create shadowed or blocked areas in the coverage result.

{% hint style="warning" %}
For occlusion to work correctly, the mesh geometry must be **imported** into the project. Referenced meshes can be displayed in the 3D viewport, but Grid Studio does not have access to their polygon data for analysis. Only imported meshes can be used by the Camera Analysis object because the polygon data exists inside the project.
{% endhint %}

{% hint style="info" %}
Use referenced mesh geometry for visual context, such as a detailed studio or stage model. Import only the low-poly meshes that are actually needed as occluders for the analysis.
{% endhint %}

{% hint style="danger" %}
Keep imported occlusion meshes as simple and low-poly as possible. High-detail meshes can unnecessarily increase the project size and make the voxel calculation slower.
{% endhint %}

A recommended workflow is to combine both approaches:

* Reference detailed mesh geometry to make the scene visually understandable.
* Import simplified low-poly versions of relevant objects as occluders.
* Assign only the imported occluder meshes to the Camera Analysis object.


---

# 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/required-project-setup.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.