| Environments | PYTHON :: EASI :: MODELER |
| Quick links | Description :: Parameters :: Parameter descriptions :: Return Value :: Details :: Example :: Related |
| Back to top |
| Back to top |
subproj(oeproj, tfile, subprj, ulx, uly, lrx, lry)
| Name | Type | Caption | Length | Value range |
|---|---|---|---|---|
| OEPROJ * | str | OrthoEngine project file name | 1 - | |
| TFILE | str | Text file with image list | 0 - | |
| SUBPRJ * | str | Output subset project file name | 1 - | |
| ULX | str | Upper-left X coordinate | 0 - 32 | |
| ULY | str | Upper-left Y coordinate | 0 - 32 | |
| LRX | str | Lower-right X coordinate | 0 - 32 | |
| LRY | str | Lower-right Y coordinate | 0 - 32 |
| Back to top |
OEPROJ
Specifies the name of OrthoEngine project file to subset.
If this is specified as a PCIDSK file, the project information stored in text segments will be used.
TFILE
Specifies a text file that lists the image file names to use for the new OrthoEngine project. SUBPROJ creates the subset project using the selected images. If no text file is specified, all images are selected.
If this parameter is specified, the text file must contain a list of image IDs that are found in the OrthoEngine project file. This list can describe the image ID, the image file name, or the entire path and file name. If no path is specified, the working folder is used.
You can use the algorithm OESELIMG to help generate a TFILE.
SUBPRJ
Specifies the name of the subset output OrthoEngine project file (.prj extension).
If this is specified as a PCIDSK file, a text segment will be created to hold the project content.
ULX
Specifies the X or horizontal coordinate for the upper-left image corner.
easting: used when LLBOUND is "N"
For example: 428720 represents a valid easting value
longitude: used when LLBOUND is "Y"
For example: 117d46'10.50W represents a valid longitude value
ULY
Specifies the Y or vertical coordinate for the upper-left image corner.
northing: used when LLBOUND is "N"
For example: 37374400 represents a valid northing value
latitude: used when LLBOUND is "Y"
For example: 33d44'56.45N represents a valid latitude value
LRX
Specifies the X or horizontal coordinate for the lower-right image corner.
easting: used when LLBOUND is "N"
For example: 428720 represents a valid easting value
longitude: used when LLBOUND is "Y"
For example: 117d46'10.50W represents a valid longitude value
LRY
Specifies the Y or vertical coordinate for the upper-right image corner.
northing: used when LLBOUND is "N"
For example: 37374400 represents a valid northing value
latitude: used when LLBOUND is "Y"
For example: 33d44'56.45N represents a valid latitude value
| Back to top |
Returns: execution status
Type: PCI_INT
| Back to top |
SUBPROJ creates a subset of an existing OrthoEngine project file, based on either a list of specified images, a bounding box, or both.
After creating the subset, SUBPROJ checks for unique Tie Points (TPs that occur for a single image). These are deleted because tie points are meaningful only when they occur in two or more images; single observations cause the bundle adjustment to fail.
The ULX, ULY, LRX and LRY parameters specify the ground coordinates bounding the area of interest for the subset project file. All images with bounds within or intersecting this area are included in the subset project file. Coordinates are given in the projection and mapunits of the OE project file. If both TextFile and ULX,ULY, LRX and LRY are specified, only the images within TextFile which are within or intersecting the specified bounds are included in the subset project file.
| Back to top |
Generate satellite model for a given PCISDK file.
from pci.subproj import subproj oeproj = "airphoto_model.prj" tfile = "" subprj = "SubProj.prj" ulx = "627534.5645" uly = "4858032" lrx = "630002" lry = "4855568.67543" subproj (oeproj, tfile, subprj, ulx,uly, lrx,lry)
© PCI Geomatics Enterprises, Inc.®, 2026. All rights reserved.