Saltar al contenido principal

About diagram parsing

Extract information from static engineering diagrams, typically P&IDs (Piping and Instrumentation Diagrams), to create interactive diagrams that you can explore on any device.

Use this contextualization tool to find, extract, and match tags on engineering diagrams and link them to an asset hierarchy or other resource types, such as files. You can approve or reject the results at any time.

An engineering diagram with new tags has the status Pending approval. This status means that there are detected tags that need to be either approved or rejected to ensure that the interactive diagrams are accurate. When all the new tags have been either approved or rejected, the diagram status changes to Approved, and the diagram can be used in Cognite Data Fusion (CDF).

For each engineering diagram, CDF shows the tag types it has detected:

  • Tag type Diagrams: Tags to other engineering diagrams.
  • Tag type Assets: Tags to other assets in CDF.
  • Tag type Unlinked: Tags that are already manually linked to other resources.

Create interactive diagrams

  1. Navigate to Data management > Contextualize > Diagram parsing.

  2. Click Create interactive diagrams.

  3. Select the diagrams that you want to make interactive.

    You can filter the diagrams by Name, Data set, Label, or File type, such as PDF. For assets, you can also filter by Root asset.

  4. Click Next step to continue.

  5. Select the diagrams you want to link your diagrams to and click Next step.

  6. Select the assets you want to link your diagrams to and click Next step.

  7. Select a contextualization model:

    Select model
    • The Standard model is selected by default as this model is recommended for most engineering diagrams.
    • The Advanced model lets you configure options such as the number of tokens matched for an entity, partial matches, and field matching.
  8. Click Next step.


    Activate Save and skip settings if you always use the same model.

  9. Click Run model.

  10. Review the result of the model - newly detected tags on the interactive diagrams.

  11. Select Approve all, Preview all, or click a diagram to review it individually.

    Interactive view

Approve or reject detected tags

  1. Click the bounding box around the detected tag in the diagram. Bounding box
  2. Select Approve tag or Reject tag.
  3. Click Save.

You can also Approve or Reject tags like this:

  1. Click a diagram to review it individually.
  2. If it has tags, click Asset or Diagram on the right sidebar to review them.
  3. Click on the pending tag - outlined in blue.
  4. Click the tag you want to review.
  5. Select Approve tag or Reject tag.
  6. Click Save.

Add new tags

  1. Click the pencil icon to open edit mode. Yellow box
  2. Use the mouse pointer to draw a bounding box around the tag you want to add.
  3. Click Add manually and choose the CDF resource in the list you want to link to.
  4. Click Save.

Review engineering diagrams pending approval

You can filter the diagrams that are pending approval by Name, Data set, or File type.

  1. Click More options icon on the diagram.
  2. Select Recontextualize diagram, Approve pending tags, Reject pending tags, or Clear all tags on the diagram. If you choose Recontextualize diagram, you start the process again.

Save diagrams as SVG

  1. Click More options icon or click Save as SVG button.
  2. You can save the files as SVG with the same names or specify a prefix.
  3. Click Save files.