Extract PCF
- Last UpdatedAug 26, 2024
- 5 minute read
The Gateway can extract data from XGL, ZGL and PCF input file sources. Click Extract to populate the two subsections: Input Source XGL/ZGL and Input Source PCF.
Notes:
-
XGL (XML-based Graphics Language) is an XML-based file format used to represent 2D vector graphics. XGL files store graphical elements like shapes, paths, colors, and transformations in a structured XML format, making them easily readable and editable.
-
ZGL (Z-Buffer Graphics Library): ZGL files store 3D models and their associated data. This includes geometry, texture information, material settings, and other attributes. XGL file means graphics with XML format or ZGL file means compressed XGL format.
-
PCF (Piping Component File) are used specifically in the context of piping and process plant design. They contain information related to piping components, such as valves, fittings, and pipes. PCF files serve as an intermediate format for exchanging piping data between different software applications. PCF files are not XML-based, but have a simpler structure.
To Extract XGL and ZGL Source file
To specify how to extract the data from XGL and ZGL input files:
-
Select Input Source XGL/ZGL section under Extract to open the XGL setting window.
-
Select the type of Input Source from the drop-down box. You can select FileSystem, S3 or None to extract data from the input sources.
Note: Selecting None means the extractor does not extract any data. As a result, there will be no complete data model.

When Input Source: FileSystem
To specify how to extract data from the File System as input source:
-
From the File System section, type the location of the input XGL files in the Input Path box. Alternatively, you can use the Browse 3D Model File icon
to enter XGL/ZGL input files. You can use the Browse Path
option to enter the input file location.
Note: The details of the particular input source to be read by the project are defined in the extract configuration in the <input> element, via the source parameter, for example, <Input Source="FileSystem">. This Extract component can read the data from File System or S3 sources.
-
Select the Data Name field to set the user name for the processed data. For more information about Data Name field, see the Data Name section.
When Input Source: S3
To specify how to extract data from the S3 as input source:
-
Select the type of Input Source from the drop-down box.
-
Define the respective fields in S3 section. For more information about these fields, see Accessing an AWS S3 Bucket.
-
If you want to test connection to S3 Bucket, click Test Connection. The result of the test is displayed in the bottom left status bar.

-
Select the Data Name field to set user name for the processed data. For more information about Data Name field, see the Data Name section.
-
Click Save Settings to save the settings.
Notes:
-
You can set tracking of changes on Extraction of data using annotations feature. For information about annotations, see Appendix C: Tracking Changes in Data.
-
The Gateway does not extract any OVERLAID XREF files in models.
-
The Gateway can identify some key attributes, for example, ObjectID, ObjectName, Revision and so on will be exported into EIWM file even without mapping in configuration.
-
To Extract PCF Source file
To specify how to extract the data from PCF Input files:
-
Select Input Source PCF section under Extract to open the XGL setting window.
-
Select the type of Input Source from the drop-down box. You can select FileSystem, S3 or None to extract data from the input sources.

When Input Source: FileSystem
To specify how to extract data from the File System as input source:
-
From the File System section, type the location of the input PCF files in the Input Path box. Alternatively, you can use the Browse 3D Model File
icon to enter PCF input files. You can use the Browse Path
option to enter the input file location.
Note: The details of the particular input source to be read by the project are defined in the extract configuration in the <input> element, via the source parameter, for example, <Input Source="FileSystem">. This Extract component can read the data from File System or S3 Bucket sources.
-
Select the Data Name field to set user name for the processed data. For more information about Data Name field, see Data Name section.
-
Click Save Settings to save the settings.
For S3 Input Source:
-
Select the type of Input Source from the drop-down box.
-
Define the respective fields under S3 section. For more information about these fields, see Accessing an AWS S3 Bucket.
-
If you want to test connection to S3 Bucket, click Test Connection. The result of the test is displayed in the bottom left status bar.

-
Select the Data Name field to set user name for the processed data. For more information about Data Name field, see Data Name section.
-
Click Save Settings to save the settings.
Data Name
To define the base name for the LOG, XGL, EIWM and CSV Report files, a DataName parameter is used to define the base name, independent of the input file names. When the Input Path is a folder only, the data name is required. When the full file path is defined, data name is optional. If the Data Name is not defined, then the Log file name and CSV Reports name are derived from the PCF Extractor name. The following table lists the base names for all input file combinations:
|
PCF Input |
XGL Input |
EIWM |
XGL Output |
Log and CSV File |
Comment |
|
PCF-ABC.pcf |
XGL-XYZ.xgl |
PCF-ABC_avngate.xml / <PCF Data Name>_avngate.xml |
XGL-XYZ.xgl / <XGL Data Name>.xgl |
Takes name from EIWM |
|
|
PCF-ABC.pcf |
Folder path |
<XGL Data Name>.xgl |
Extractor merges XGL files |
||
|
PCF-ABC.pcf |
- |
- |
|||
|
Folder path |
XGL-XYZ.xgl |
<PCF Data Name>_avngate.xml |
XGL-XYZ.xgl / <XGL Data Name>.xgl |
Extractor merges PCF files |
|
|
Folder path |
Folder path |
<XGL Data Name>.xgl |
Extractor merges PCF and XGL files |
||
|
Folder path |
- |
- |
Extractor merges PCF files |
||
|
- |
XGL-XYZ.xgl |
Takes name from XGL output |
XGL-XYZ.xgl / <XGL Data Name>.xgl |
||
|
- |
Folder path |
<XGL Data Name>.xgl |
Extractor merges XGL files |