| Back to top |
| Back to top |
| Name | Caption |
|---|---|
| RGB Scene Folder | Input scene folder containing the left & right RGB images; or the stand alone nadir RGB images. |
| NIR Folder | Input scene folder containing the NIR images. |
| Output Folder | Output folder |
| Overwrite Results | Overwrite existing results |
| Send Email | Email notification settings |
| Combine Method | The method used to combine corresponding Phase One images. |
| Build Pyramids | Builds pyramids |
| Nadir/Left Camera Calibration File | File containing camera-calibration parameters |
| Right Camera Calibration File | File containing camera-calibration parameters |
| NIR Camera Calibration File | File containing camera-calibration parameters |
| Exterior Orientation File | File of exterior-orientation parameters |
| EO File Format | Format of the exterior-orientation file |
| EO Map Units | Exterior orientation file projection |
| EO Elevation Reference | Exterior orientation vertical datums |
| EO Angular Unit | Exterior orientation file angular unit |
| Rotate Kappa Angle | Kappa-value rotation angle |
| Back to top |
RGB Scene Folder
The name of the folder containing the RGB images of the Phase One scenes to ingest.
Alternatively, you can specify an MFILE as input. An MFILE is a text file with an .mfile file name extension. For more information on this type of file, see About the MFILE format.
If performing the combination method:
This parameter is mandatory.
NIR Folder
The name of the folder containing NIR images of the Phase One scenes to ingest.
Alternatively, you can specify an MFILE as input. An MFILE is a text file with an .mfile file name extension. For more information on this type of file, see About the MFILE format.
If performing the combination method:
This parameter is required when performing the Stack.
Output Folder
The path and name of the folder to which to write the output files in PCIDSK format.
The Phase One Ingest module creates PCIDSK files for each Phase One dataset (pair or triplet) imported from the input folders.
This parameter is mandatory.
Overwrite Results
Select this check box to overwrite the existing output files, if any exist. If this check box is left clear, and an output file exists in the relevant folder, the status of the job displays a message informing you of the existence and name of the output file. The message is also written to the event log of the job.
Send Email
If necessary, you can set up CATALYST Enterprise to send an email notification on job start and job completion.
With this check box selected, an email message is sent to each address specified in the Email Addresses box after the job starts and on completion.
You can specify one or more addresses, and each must be separated by a comma or a semi-colon. The email address of the user currently logged in displays by default.
Combine Method
Build Pyramids
This check box controls whether to build image pyramids (raster overviews) for the ingested scenes.
Building pyramids improves performance in some subsequent processing steps. They can use the pyramids instead of reading all the pixels. However, building pyramids can cause the ingest job to take longer to complete. If immediately after ingestion you intend only to create orthorectified images, you need not build pyramids.
When to turn on pyramids:
For more information on pyramids, see the Pyramid module.
Nadir/Left Camera Calibration File
The path and name of a file containing camera-calibration parameters for the nadir or left RGB input images, depending on the combination method.
If performing the combination method:
Phase One Ingest module only supports camera calibration files in the Australis format, as shipped with Phase One data.
Right Camera Calibration File
The name of a file containing camera-calibration parameters for right RGB images.
If performing the combination method:
Phase One Ingest module only supports camera calibration files in the Australis format, as shipped with Phase One data.
NIR Camera Calibration File
The path and name of a file containing camera-calibration parameters for NIR images.
If performing the Stack then this camera calibration file is required.
If performing the combination method:
Phase One Ingest module only supports camera calibration files in the Australis format, as shipped with Phase One data.
Exterior Orientation File
The path and name of the file containing the exterior-orientation (EO) parameters required for each scene.
The EO information must be in a format suitable for reading by PCI technology. Currently, EO files, shipped with Phase One IIQ datasets, are not directly supported by PCI technology. Thus, you must convert one of the Phase One EO files to something PCI technology supports. An easy way to convert is to open the EO file in a spread sheet application and reorder and delete the columns to match what PCI technology requires.
Carefully choose the Phase One EO file to convert. Pick the one that is for the calibrated or the nadir data. Check the contents of the EO file, the file names should end with _cal. If you choose the wrong EO file then the output files will not be correctly located.
It is assumed that the EO information was refined previously with a rigorous aerial triangulation and that the EO information is as accurate as required. Therefore, collection of neither ground control points (GCP) nor tie points (TP) is necessary.
The EO file (eo.txt) should contain, at a minimum, the ID, position (easting/longitude, northing/latitude, height), and orientation (omega, phi, kappa).
EO File Format
The encoding method of the exterior orientation (EO) information.
With the text format, ID represents the PhotoID; x, y, z represent the position (easting, northing, height); omega, phi, and kappa represent the orientation.
EO Map Units
The projection for the EO.
UTM: Universal Transverse Mercator
MAPUNITS (Output Projection) can specify the UTM grid-zone number and row, and Earth model, as follows:
UTM [mm] [r] [Ennn]
For example, if the value of the EO Map Unit parameter is specified as UTM, then with the EO Map Unit parameter, you can enter 10 U D000. This means the final map unit of the EO information is UTM 10 U D000.
SPCS: State Plane Coordinate System
The SPCS zone number and Earth model can be specified as follows:
SPCS [mmmm] [Ennn]
LONG/LAT: longitude and latitude
The Earth model can be specified for LONG/LAT (and other units except PIXEL), as follows:
LONG/LAT [Ennn]
If the Earth model is not specified, it is assumed to be E000 (Clarke 1866).
EPSG: European Petroleum Survey Group code
You can specify the projection by entering an EPSG code, as defined by the OGC at epsg.org and spatialreference.org.
You specify the EPSG code using the EPSG keyword followed by an integer and separated by a colon, as shown in the following example.
EPSG:4326
Most common EPSG codes are supported.
You can also specify the label of a user-defined projection, if the projection exists in the userproj.txt file.
EO Elevation Reference
The flying height of the airphoto camera (vertical data) at the time the image was taken.
If the vertical data of the digital elevation model (DEM) and the flying height of the camera differ, the EGM2008 geoid model is used for the conversions during the orthorectification process.
EO Angular Unit
The angular unit of the EO angles.
Rotate Kappa Angle
The angle of rotation to add to the input kappa values, in units specified by the EO Angular Unit parameter.
In some cases, the kappa values in the EO file must be rotated (for example, by 90, -90 or 180 degrees). You apply the correction by specifying the angle of rotation.
| Back to top |
Preprocessing requirements
Before running this module, the following requirements must be met to ensure the job processes successfully and produces accurate results:
Format of ingested data
Corresponding files
Corresponding files, for a Phase One scene, are determined based on their file names.
Phase One file triplet
Phase One file pair
Phase One file names are broken into 4 parts, the prefix, the scene ID, the suffix, and the extension. The scene Id starts at the first underscore '_' and continues until the period '.' or the 'L' or 'R' before the period. Those files with the same scene ID constitute the corresponding files in a scene. In the example file names above the scene Id is: 4ME_0446_0025_00000
Module details
The Phase One Ingest module imports Phase One IIQ data, by performing a combination method, then writing the result to an output PIX file. Any scene without an exterior orientation will cause an error after the combination is performed.
When performing the Stack or Both combination method, the Phase One Ingest module first scans the NIR Folder for all NIR images. It then scans the Scene Folder for corresponding RGB images. Once all files for a scene have been found, it spawns a child job for the set of corresponding scene files.
When performing the Stitch combination method, the Phase One Ingest module scans the Scene Folder for corresponding left & right RGB images.
You must run this module prior to running any other CATALYST Enterprise module, such as Orthorectification Airphoto module.
Job results
For each scene found in the Scene Folder and NIR Folder, the Phase One Ingest module creates a PCIDSK file in the output folder using a file name generated automatically. The output files follow a naming convention based on the prefix of the left or nadir RGB image and scene ID: {prefix}{scene Id}_cal.pix. Using the example files from above, the output file name is: ND_4ME_0446_0025_000008_cal.pix
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.