> ## 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.

> ## Agent Instructions
> Cognite Data Fusion (CDF) is an industrial DataOps platform. Prefer English docs unless the user asks for another locale.
> Follow /_llms/ index links recursively until you reach page URLs ending in .md. Fetch those Markdown twins instead of HTML.
> For REST APIs, default to calendar version 20230101 (stable). Use 20230101-beta or 20230101-alpha only if the user is on a preview API. Cite paths under /api-reference/concepts/<version>/ and the Cdf-Version header. Prefer the Python SDK (cognite-sdk) unless the user is in JavaScript/TypeScript.
> Start here by task: platform overview /cdf/index.md; data modeling /cdf/dm/index.md; data integration /cdf/integration/index.md; access /cdf/access/index.md; CDF Toolkit /cdf/deploy/cdf_toolkit/index.md; REST quickstart /dev/quickstart.md; Python SDK https://cognite-sdk-python.readthedocs-hosted.com/en/stable/; Atlas AI /cdf/atlas_ai/index.md; plan an Atlas AI agent /cdf/atlas_ai/concepts/atlas_ai_agent_planning.md; Flows apps /cdf/flows/index.md; MCP and IDE setup /dev/guides/ide_ai_integration.md.
> For implementation work, also load /skill.md.

# Contextualize 3D objects in a scene

> Map CAD nodes, point cloud objects, and areas in 360° images to assets from a scene.

You can contextualize 3D objects in a scene which contains CAD models, point clouds, or 360° images for a location. Contextualizing maps those objects to assets so you can find an asset from the 3D view and see the linked object when you work with the asset.

## Before you start

Before you contextualize objects, [create and configure a scene](https://docs.cognite.com/cdf/3d/guides/scene.md). Make sure the scene contains the 3D resources you want to contextualize, such as CAD models, point clouds, and 360° images.

## Map CAD nodes

To manually map a CAD node to an asset:

**1. Turn on contextualization**

In the top bar, toggle Contextualize.

**2. Select a CAD node**

In the tree view, select the CAD node you want to map. The node is highlighted, and the resource selector opens on the right panel.

**3. Link the node to an asset**

In the resource selector, search for the asset and select Link. A link icon appears next to the node in the tree view.

**4. Finish mapping**

Select Done.
To map another node, select it and repeat.

## Map point clouds

To manually map an object in a point cloud to an asset:

**1. Turn on contextualization**

In the top bar, toggle Contextualize.

**2. Select a point cloud**

In the tree view, select the point cloud you want to map. The point cloud is highlighted, and Add geometry appears at the bottom of the view.

**3. Add geometry**

Select Add geometry and place a box around the object in the 3D view. Adjust the box so it fits the object. The geometry is added to the tree view, and the resource selector opens on the right panel.

**4. Link the geometry to an asset**

In the resource selector, search for the asset and select Link. A link icon appears next to the geometry in the tree view.

**5. Finish mapping**

Select Done.
To map another object, select Add geometry and repeat.

## Map 360° images

To manually map an area in a 360° image to an asset:

**1. Turn on contextualization**

In the top bar, toggle Contextualize.

**2. Open a 360° image**

In the tree view, select the 360° image you want to map. The image opens, and Add annotation appears at the bottom of the view.

**3. Draw an annotation**

Select Add annotation, then place at least 3 points around the object. Press <kbd>Esc</kbd> to finish the polygon. The annotation is added to the tree view, and the resource selector opens on the right panel.

**4. Link the annotation to an asset**

In the resource selector, search for the asset and select Link. A link icon appears next to the annotation in the tree view.

**5. Finish mapping**

Select Done.
To map another area, select Add annotation and repeat.

## Further reading

* [Contextualize CAD models](https://docs.cognite.com/cdf/3d/guides/3dmodels_contextualize.md): map nodes in a single CAD model, then validate or delete the links.
* [Contextualize point clouds](https://docs.cognite.com/cdf/3d/guides/pointcloud_contextualize.md): run object detection and classification, then map objects that detection missed.
* [Contextualize 360° images](https://docs.cognite.com/cdf/3d/guides/360images_contextualize.md): draw bounding areas on a 360° image collection, and use text detection in data modeling projects.
