Setting Up the Emission Model


A model is a defined entity type that corresponds to specific organizational asset categories, such as construction sites, databases, IoT buildings, and office sites. By tagging entities with predefined models, you can classify and oversee your organization’s asset holdings based on asset types (transport, buildings, sites etc.), lines of business (supplier, business partner, subsidiaries etc.), or geographical regions.


Grouping entities with similar properties under the same model allows you to:

  • Configure data display for emission portfolio dashboards. This function requires preset Business entity model to be selected for all the bottom-most layered entities.

  • Aggregate data based on each specific model type, and examine emissions data within narrower scopes.

  • Export data report based on specific model types, such as data sheets of office sites, supplier-owned assets, transport fleets, or business partner emissions.

  • Configure and store properties information for different entity types, which includes country region, address, contact numbers, timezone, and mileage etc.


This section shows how to create and apply models to entities.

Prerequisites


Contact your system administrator if your account does not meet the below requirements:

  • Ensure that your account has a super admin or view admin role.

  • Ensure that you have created necessary entities under the current view.

Creating a Model


  1. Click on Data Management > Organization in the left navigation pane. In the view tab, click on the view you have created, then click Configuration in the toolbar to enter the editor dashboard.

  2. Select the model list button model_list_button and click on the mini arrow expand_sidebar in the left sidebar to expand the model list library sidebar menu.

  3. Select + New Model to add a new model.

  4. Enter the following details to create a model:

    • Model Name: Specify your model name.

    • Model ID: Specify your model ID.

    • Type: Select customization.

    • Icon: Select an icon to represent your model on the dashboard.

    Note

    The model type and model ID cannot be changed once the model is created.

  5. Select OK and the new model will be added to the model list library sidebar.


    ../../_images/model_list.png


Applying Model to Entities


  1. Ensure you are in Configuration mode, in the model list library sidebar, hover over the model you have created and click on configuration_button button to assign models to entities.

  2. In the Model Configuration window, there are two ways you can assign models:

    • Manual Selection: In the dashboard preview panel, click on entities and choose the range to assigned to the model.

    • Batch Selection: Click on the quick selection dropdown bar to select entities in batches based on layers. You can batch select the bottom-most layer by opting for the leaf note option.


      ../../_images/model_selection.gif


  3. After selecting the entities you want to associate with this model, click on Trigger to link the models to the entities.

  4. Click the Preview button in the toolbar to return to the preview dashboard. Your entities will be labeled with the corresponding model icons you assigned.


You can now choose models as the basis for aggregating emission data, allowing you to compute and analyze emission volumes across various entity categories.


../../_images/model_aggregation.gif


Defining Property Information for the Model


  1. Click Configuration in the toolbar to enter the editor dashboard.

  2. In the model list library sidebar, hover over the intended model you wish to configure and click on properties button to define property fields for the selected model and its associated entities.

  3. In the Property Configuration pop up window, under Property > Template, select a pre-defined property field template based on your entity asset type.

  4. Select checkboxes to enable relevant properties fields for the model and associated entities.

  5. Click OK to save and activate the above selection.


Now the above property fields will be enabled for all entities linked to the selected model type.


To update property information for each entity, switch back to Preview mode. Then select an entity card associated with a configured model. On the right side bar, navigate to the Settings tab. Here, you can input relevant values into the specified property fields and utilize the Temporal Data option to provide data sheet properties, such as monthly employee count.


../../_images/input_property.png


Batch Export Models


You can follow these steps:

  1. Click on Data Management > Organization in the left navigation pane. In the view tab, click on the view you have created, then click Configuration in the toolbar to enter the editor dashboard.

  2. Select the model list button model_list_button and click on the mini arrow expand_sidebar in the left sidebar to expand the model list library sidebar menu.

  3. Select the Export Model button in the top right corner, which will open the Export Model popup.

  4. Choose the export type:

    • Meta: Export the attribute data in JSON file format.

    • Value: Export the attribute data along with their corresponding values in an Excel file format.

  5. Select the desired model and the year (if exporting value data), then click Export to view and download the exported file.


Batch Import Models


You can follow these steps:

  1. Click on Data Management > Organization in the left navigation pane. In the view tab, click on the view you have created, then click Configuration in the toolbar to enter the editor dashboard.

  2. Select the model list button model_list_button and click on the mini arrow expand_sidebar in the left sidebar to expand the model list library sidebar menu.

  3. Select the Import Model button in the top right corner, which will open the Import Model popup.

  4. Choose the import type:

    • Meta: Import the attribute data in JSON file format.

    • Value: Import the attribute data along with their corresponding values in an Excel file format.

  5. Select the desired model and the year (if importing value data), then click Import.

  6. Under the Import Log section, you can check the status of the file upload.

    • Upload Success: The imported data will be saved under the relevant model.

    • Upload Failure: Click the Error Message button to see the number of failed entries and the reasons for the failure. Make the necessary changes and retry the upload.