> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure a scene

> Create and configure 3D scenes to view all related 3D data for a physical location in a unified view.

You can create a scene by adding all the 3D data available for a location into one space and aligning the different models to position them correctly in the physical space. Viewing the different 3D content in one scene will give the user a richer context and understanding of the physical conditions of their location.

You can also add a skybox and a ground plane to the scene. This will make it easier to read the depth and perceive the contrast of the scene.

## Before you start

Before creating a scene, make sure you have:

* Created and set up the scene data model (required the first time you create a scene for your project).
* Uploaded and processed all the 3D data you want to add to your scene. For more information, see [Upload 3D models](/cdf/3d/guides/3dmodels_upload).

<Note>
  To use 3D in [Search](/cdf/explore/search#search-in-3d-models), you need to configure a scene and link it to a location. A location is the global [location filter](/cdf/locations/) across Cognite Data Fusion (CDF).
</Note>

## Create a scene

<Steps>
  <Step title="Navigate to 3D management">
    Go to [<span class="ui-element">CDF</span>](https://fusion.cognite.com) > <span class="ui-element">Data fusion</span> > <span class="ui-element">Configure</span> > <span class="ui-element">3D</span>.
  </Step>

  <Step title="Create a new scene">
    Select <span class="ui-element">+ Create scene</span> and follow the wizard to create a scene.
  </Step>
</Steps>

## Configure a scene

<Steps>
  <Step title="Open the scene overview">
    Select the newly created scene to open its overview.

    <Frame>
      <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/3d/3d-scene-overview.png" alt="Scene overview interface" />
    </Frame>
  </Step>

  <Step title="Add 3D data to the scene">
    Select **+ Add 3D data** to open the dialog. You can add CAD, point cloud, or 360° images to your scene. Use the search box to find an existing 3D resource, then select **Add**.

    <Note>
      Added resources appear in the tree view on the left-hand side. Selecting an item from the tree view opens its settings in the right-hand side panel.
    </Note>
  </Step>

  <Step title="Adjust the model position">
    Select the added model from the tree view and adjust its position, rotation, and scale in the side panel.

    From the same panel, you can also [contextualize 3D objects](/cdf/3d/guides/scene#unified-3d-contextualization).

    <Tip>
      You can view the scene from different angles using the options in the top bar:

      * Use the <span class="ui-element">Orbit mode</span> to rotate around the objects to view all the sides.
      * Use the <span class="ui-element">Fly mode</span> to view the interior and exterior of any closed model.
      * Double-click anywhere in the scene to move instantly.
    </Tip>
  </Step>

  <Step title="Access control for custom scene images">
    Custom skybox, ground plane, thumbnail, and minimap uploads are stored as **files** in CDF. How access control applies depends on your [project type](/cdf/3d/guides/3dmodels_intro#3d-models-and-project-types):

    * **Data modeling** — Uses the scene's space automatically. You can't select a data set in the scene editor.
    * **Hybrid** — One **data set** per session applies to all custom scene image uploads, not per image. With no data set selected, files are accessible across all data sets.

    In **hybrid projects**, set the data set before you upload custom images:

    1. In the scene side panel, expand <span class="ui-element">Details</span> and select <span class="ui-element">Edit</span>.
    2. In <span class="ui-element">Advanced settings</span>, select a data set, or leave <span class="ui-element">No data set</span> selected.
    3. Select <span class="ui-element">Save</span>.

    <Warning>
      The data set selection is **not saved** when you publish the scene. It applies only for the current editing session. Set the data set again if you close the scene or start a new session.
    </Warning>

    <Tip>
      To create data sets or configure scoped access, see [Create data sets and add data](/cdf/data_governance/guides/datasets/create_data_sets).
    </Tip>
  </Step>

  <Step title="Configure the scene environment">
    In the tree view, select <span class="ui-element">Environment</span>. You can configure textures and skyboxes for the selected 3D resource in the side panel.

    <Note>
      To use custom images for textures, select <span class="ui-element">Add custom</span> and upload your images.
    </Note>
  </Step>

  <Step title="Configure the camera settings">
    Go to the default scene view, for example, by clicking the scene name in the top bar, and expand the <span class="ui-element">Camera</span> accordion in the side panel.

    Position the camera at the desired view and select **Set camera position**. The camera position is the view a user gets when they enter a scene.

    <Note>
      If the **Use default camera position for thumbnail** option is turned on, a scene thumbnail is automatically set.
    </Note>
  </Step>

  <Step title="Set thumbnail">
    In the <span class="ui-element">Camera</span> accordion, you can set the scene thumbnail in three ways:

    * Select the **Use default camera position for thumbnail** option.
    * Position the camera to your desired view and select **Set thumbnail**.
    * Upload a custom image by selecting **Upload custom thumbnail**.
  </Step>

  <Step title="Upload and configure a minimap">
    Expand the <span class="ui-element">Minimap</span> accordion in the side panel. The minimap is a customizable top-down view that helps you navigate in large scenes. It updates in real time based on the camera position.

    1. Select <span class="ui-element">Upload minimap</span> and upload a file that represents a top-down view of your scene, for example, a sitemap or aerial image.
    2. Once uploaded, configure the **position**, **rotation**, and **scale** of the minimap to align it with the scene.

    <Tip>
      Double-click a point on the map to jump to that location in the scene.
    </Tip>
  </Step>

  <Step title="Publish the scene">
    After configuring the minimap, **Publish** the scene to the project.

    <Check>
      You have published the scene.
    </Check>
  </Step>
</Steps>

## Edit a scene

You can modify an existing scene after it's been published, such as updating the scene name, description, geoposition, or linking it to a location.

<Steps>
  <Step title="Open scene details">
    Expand the <span class="ui-element">Details</span> accordion in the side panel of the scene overview.
  </Step>

  <Step title="Edit the scene">
    Select <span class="ui-element">Edit</span> and make the necessary changes.
  </Step>

  <Step title="Save changes">
    Select <span class="ui-element">Save</span> to publish the changes.
  </Step>
</Steps>

## Toolbar tips

* **Cropping tool** <Icon icon="crop" />: slice through the model to view cross-sections or create a crop box to define a custom 3D boundary.
* <span class="ui-element">Measurements</span> <Icon icon="ruler" />: measure point coordinates, point-to-point distances, areas (vertical, horizontal, and polygons), volumes, and circle diameters for pipes and tanks.
* <span class="ui-element">Settings</span> <Icon icon="settings" />: set the rendering quality, configure point cloud settings, and change the units.

<Note>
  **Default scene settings**

  You can save your preferred model visibility, rendering quality, point cloud settings, and camera position as defaults. These settings persist across sessions, so you don't need to manually adjust scene configurations each time.
</Note>

* <span class="ui-element">Ghost mode</span>: gray out areas that are out of focus to help you concentrate on specific parts of the model.
* <span class="ui-element">Help</span> <Icon icon="circle-question-mark" />: view instructions for navigating in a 3D model.

<a id="unified-3d-contextualization" />

## Contextualize 3D objects

You can contextualize 3D objects (CAD, point cloud, or 360° images) within a scene using the unified 3D contextualization editor.

To start contextualizing:

<Steps>
  <Step title="Select the 3D model to contextualize">
    In the scene tree view, select the **CAD** model, **point cloud**, or **360° image** collection you want to contextualize.
  </Step>

  <Step title="Start contextualization">
    In the right-hand panel, select <Icon icon="link" /> <span class="ui-element">Contextualize</span>.
  </Step>
</Steps>

<Frame>
  <img src="https://apps-cdn.cogniteapp.com/@cognite/docs-portal-images/1.0.0/images/cdf/3d/scene_contextualize_v2.png" alt="3D scene overview with contextualization options" />
</Frame>

For detailed steps on contextualizing each type of 3D model, see:

* [CAD](/cdf/3d/guides/3dmodels_contextualize)
* [Point cloud](/cdf/3d/guides/pointcloud_contextualize)
* [360° image](/cdf/3d/guides/360images_contextualize)
