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.
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
-
Navigate to Data management > Contextualize > Diagram parsing.
-
Select Create interactive diagrams.
-
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.
The supported interactive diagram file mime_types are application/pdf, image/jpeg, image/png, and image/tiff. For more information, see API documentation for engineering diagrams.
-
Select Next step to continue.
-
Optional. Select the diagrams you want to link your diagrams to and select Next step.
-
Select the assets you want to link your diagrams to and select Next step. This limits the matching to assets from the same plant or unit as the selected diagrams.
-
Select a contextualization 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.
-
Select Next step.
sfatActivate Save and skip settings if you always use the same model.
-
Select Run model.
-
Review the result of the model - newly detected tags on the interactive diagrams.
-
Select Approve all, Preview all, or select a diagram to review it individually.
Approve or reject detected tags
-
Select the bounding box around the detected tag in the diagram.
-
Select Approve tag or Reject tag.
-
Select Save.
You can also Approve or Reject tags like this:
- Select a diagram to review it individually.
- If it has tags, select Asset or Diagram on the right sidebar to review them.
- Select the pending tag - outlined in blue.
- Select the tag you want to review.
- Select Approve tag or Reject tag.
- Select Save.
Add new tags
- Select the pencil icon to open edit mode.
- Use the mouse pointer to draw a bounding box around the tag you want to add.
- Select Add manually and select the CDF resource in the list you want to link to.
- Select Save.
Review engineering diagrams pending approval
You can filter the diagrams that are pending approval by Name, Data set, or File type.
- Select the More options icon on the diagram.
- Select Recontextualize diagram, Approve pending tags, Reject pending tags, or Clear all tags on the diagram. If you select Recontextualize diagram, you restart the process.
Save diagrams as SVG
- Select More options icon or select Save as SVG button.
- You can save the files as SVG with the same names or specify a prefix.
- Select Save files.
For information about the new diagram parsing, an upgrade from asset-centric to a data-model approach, see Diagram parsing for data modeling.