---
title: Create and Import Models
slug: bhdo/create-and-import-models
createdAt: 2022-09-08T19:10:53.000Z
---

:::hint{type="info"}
**Note**: The Digital Twins feature is available for Belden Horizon Data Operations version 3.5.2 and later.
:::

You can create Digital Twins models by navigating to **Digital Twins** > **Models**.&#x20;

# Step 1: Create Model

You have two options for creating the model. You can create a new model or import a model as a JSON file.&#x20;

## Create a  New Model

**To create a new model:**

1. Navigate to **Digital Twins**.&#x20;
   The *Models&#x20;*&#x70;ane appears.&#x20;
2. From the *Models&#x20;*&#x70;ane, click the **Create a model** tile.&#x20;
   The *Create a Model* dialog box appears

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ik59Hi2M29nng4UXfiBHx_create-a-model.png" size="80" width="938" height="534" caption="The Create a Model tile" position="center" showCaption="true"}
3. Click the **Type** drop-down list and select **Select model type**.
4. Enter the name of the model in the **Name** field.
5. (Optional) Enter a short description of the model in the **Description** field.
6. Click **Add.**
   A new model tile appears in the *Models&#x20;*&#x70;ane.

## Import an Existing Model

You can import a model as a JSON file.

To import an existing model, click th&#x65;**&#x20;Import Model** icon, select the `<model name>.json` file, and click **Open**.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/vLaWiF-y2CaNqXxozTOBl_image.png" size="80" width="938" height="534" caption="Import Model icon" position="center" showCaption="true"}

# Step 2: Configure Model

After creating the model, you can configure it appropriately for instances.&#x20;

Click the **Model tile** (grid view) or **Model name** (table view) to view the model details.&#x20;

## Model Image

Click th&#x65;**&#x20;Upload image** icon to select an image for the model. The image will display for the model tile on the *Models* pane.&#x20;



::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Lld4hMpGVhc1l6M2Rgbwo_image.png" size="80" width="1088" height="608" caption="Upload image icon" position="center" showCaption="true"}

## Static Attributes

Manage the metadata for the model from the *Static Attributes* tab.&#x20;

**To add static attributes:**

1. Click the **Model tile** (grid view) or **Model name** (table view) to open the model details.&#x20;
2. From the *Static Attributes* tab, click th&#x65;**&#x20;Add item** icon.&#x20;

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/wQJea1NBZARQ0r-Lp31m8_add-static-attribute.png" size="80" width="656" height="461" caption="Add Static attribute icon" position="center" showCaption="true"}
3. In the **Attribute Name** field, either select an item from the drop-down list or enter a custom attribute name.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/jERDrxRUhVr6ka_oM5fP6_static-attribute-name.png" size="80" width="1089" height="720" caption="Static Attribute drop-down list" position="center" showCaption="true"}
4. In the **Attribute Value** field, enter a value for the model.&#x20;
5. When done adding the attribute, click the **Save&#x20;**&#x69;con. Alternatively, you can add multiple attributes and click the **Save all&#x20;**&#x69;con.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/rpWnS9Hb5812LDQ_-e0py_image.png" size="80" width="1088" height="583" caption="Save icons" position="center" showCaption="true"}

## Transformations

Use the *Transformation&#x20;*&#x74;ab to transform the data collected in Instances by converting raw JSON data to a desired format by defining the JSON-based schema.&#x20;

You can define schema IDs, which can be used to manipulate the payload and define a structure for the payload as the model inherits data.&#x20;

**To a data transformation schema:**

1. Click the **Model tile** (grid view) or **Model name** (table view) to open the model details.&#x20;
2. Click the **Transformation&#x20;**&#x74;ab.&#x20;
3. Click the **Add a Schema** icon.&#x20;
   The *Add dialog* box appears.

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/g8bHbGf6ZIOUoXrpW0C31_add-a-schema.png" size="80" width="1088" height="546" caption="Add a Schema icon" position="center" showCaption="true"}
4. Enter a name for the schema.&#x20;
5. In the code window, copy and paste the JSON-based schema.&#x20;
6. Click **Add**.&#x20;

To edit or delete a schema, click the **Action menu** for the schema and select an option.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/U4tG6DcjO2oSU2yApuvET_image.png" size="80" width="1088" height="582" caption="Action menu for data transformation schema" position="center" showCaption="true"}

## Dynamic Attributes

Manage variable data in the model from the *Dynamic Attributes* tab. You have the option of adding a schema ID, which can be used to map dynamic attributes one-to-one for data transformation.&#x20;

**To add a dynamic attribute:**

1. Click th&#x65;**&#x20;Add item** icon.&#x20;

   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/8IKzUZAaOpcmFoeg_NZYa_add-dynamic-attribute.png" size="80" width="1088" height="486" caption="Add Dynamic attribute icon" position="center" showCaption="true"}
2. In the **Name&#x20;**&#x66;ield, enter a name for the attribute.&#x20;
3. (Optional) Enter values for **Unit&#x20;**&#x61;nd **DataType**.&#x20;
4. (Optional) If you've created data transformation schemas, select one from the **SchemaID&#x20;**&#x66;ield.&#x20;

## Hierarchy

Use the *Hierarchy&#x20;*&#x74;ab to create a custom data structure for the model.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/UOaRDld1N1B6-vUtEwagq_image.png" size="80" width="1089" height="780" caption="Hierarchy tab" position="center" showCaption="true"}

To create a category for the hierarchy, click the **Action menu** icon for *root&#x20;*&#x61;nd select **Add Node**.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/SoGn9QbqnF_16C7sQOKxR_image.png" size="80" width="1089" height="780" caption="Add Node icon" position="center" showCaption="true"}

To add attributes to the hierarchy, do one of the following:&#x20;

- Drag and drop attributes from the left-hand list to the canvas under the appropriate category.&#x20;
- Click the **Action menu** for a category and select **Add item to Node**. Then, select the attribute to add.&#x20;

When done configuring the hierarchy, click the **Save&#x20;**&#x69;con.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/eTzTATYNqf5XhpKT1DjDn_image.png" size="80" width="1089" height="780" caption="Add item to Node icon" position="center" showCaption="true"}

