Skip to main content
This procedure is for data engineers who need to parse engineering diagrams and map assets and files in Cognite Data Fusion (CDF). You can parse all assets and files from a location or configure detection parameters to narrow the subset. Review and verify the automatic mappings as part of the 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.
  • To test new beta features, select > Enable beta features from the overview page.

​
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.
Detect and link tags to assets and files in CDF. Use for vector or raster files; supports multi-page files (up to 50 pages per run).
4

Configure the parsing

Configure asset filters: Use the Assets tab to filter which assets are included in the parsing.Configure file filters: Use the Files tab to filter which files are parsed.Configure text recognition: Adjust the text detection settings to improve accuracy.
5

Run the parsing

Select Run parsing to process the diagram with your chosen settings.
For Full diagram parsing, select Run advanced parsing instead of Run parsing. The advanced option lets you adjust additional configuration settings before running.
The parsing starts and processes your diagram. The time required depends on the file size and complexity.
6

Review the parsed diagram

Select under Actions to review the parsed diagram.
The diagram opens in the review interface with tabs for verifying different aspects of the parsing results.

​
Review parsed diagrams

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

Tag detection: Map asset and file tags to CDF

  1. Verify the detected tags and their links. Select one or several tags to verify or reject links.
    Orange indicates a suggested link. Blue indicates 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 parsing did not run or returned errors. Rerun the parsing to fix the errors.
All relevant tags are verified (shown in blue) and correctly linked to assets or files in CDF.
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
All vectors are correctly identified and mapped to the appropriate symbols in your library.
3

Merge: Map tags and symbols

Merged tags and symbols appear in blue. For unmerged entities, select the tag and symbol to merge.
Tags and symbols that represent the same entity are merged and displayed in blue.
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.
All pipes and connections between symbols are correctly identified and verified.
5

Rerun parsing to apply changes

Rerun the parsing and verify that the system recognized your changes.
Select the Edit layer visibility icon and turn on Show background document to show or hide the diagram’s background document details (SVG paths).
The parsing completes successfully with all your corrections applied. Review the updated results to confirm accuracy.

​
Manage parsed output

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

​
Further reading

Last modified on February 17, 2026