Skip to main content
Parse all assets and files from the same location or configure detection parameters to narrow down to a subset. Review and verify the automatic mappings as part of the parsing process.

​
Before you start

  • Make sure the files you want to parse are ingested into a data model.
  • Add access capabilities for parsing.
  • Configure a location for the engineering diagrams.
  • Set the mime_type to application/pdf, image/jpeg, image/png, or image/tiff in CogniteFile.

​
Parse a diagram

1

Navigate to Diagram parsing

Navigate to Data management > Contextualize > Diagram parsing.
2

Select location

Select the location containing the engineering diagrams.
3

Choose parsing method

Select the file to parse, and then select:
  • Run parsing: Select a symbol library for detecting symbols in the diagrams.
  • Run advanced parsing to configure detection parameters: Select library: Select a symbol library for detecting symbols in the diagrams. Configure filters: Select the assets or files tab and filter to find the items to parse. Configure text detection: Adjust the text detection settings to improve accuracy.
4

Review the parsed diagram

Select under Actions to review the parsed diagram.

​
Review parsed diagrams

The parsed diagram has four tabs to verify different aspects of the automatic mappings:
Verification tabWhat to verify
TagsMap asset and file tags to data that’s already in CDF.
SymbolsVerify that vectors are correctly detected and mapped to symbols. This tab is only available for vectorized files.
MergeMerge annotations with symbols. This tab is only available for vectorized files.
ConnectionsVerify that symbols are correctly connected. This tab is only available for vectorized files.
For vectorized files, only the first page of the file is parsed. For rasterized files, you only work with the Tag detection tab.
1

Tags: Map asset and file tags to CDF

  1. Verify that the relevant tags are detected and correctly linked. Select one or several tags to verify or reject links.
    Orange colors indicate a suggested link. Blue colors indicate a verified link.
  2. Select the plus icon on the toolbar to create a new tag and link it to an asset or file in CDF.
Select Resize and move annotations from the toolbar to adjust the position of one or several tags.
In the sidebar, page icons with a strikethrough indicate that the diagram hasn’t been parsed or was parsed with errors. Try rerunning the parsing to fix the errors.
2

Symbols: Verify vectors as symbols

To add symbols to the library, select a vector in the diagram and then select which Asset class and Asset type the vector represents. You can also add the vector as a geometry to an existing symbol.If a symbol maps to the wrong asset, select the symbol and then Detach from symbol. Only this instance in this file is detached from the symbol.
Symbol tab showing detected symbols in the diagram
3

Merge: Map tags and symbols

Tags and symbols that are merged are displayed in blue color. For unmerged entities, select the tag and symbol to bring up a modal for merging.
4

Connections: Verify connections

Verify that pipes are connected to all connected symbols. If a pipe isn’t detected or incorrect, open the Symbols tab to make corrections. Hover over a symbol to view the entire connection group and select a symbol to view or edit the closest connection.
5

Rerun parsing to apply changes

Rerun the parsing and verify that your changes have been recognized.
Select the Edit layer visibility icon and turn on Show background document* to show and hide the diagram’s background document details (SVG paths).

​
Manage parsed output

Use the API to retrieve your parsed output. For more information, see API documentation.