REPROJ

Reproject image and vector data


EnvironmentsPYTHON :: EASI :: MODELER
Batch ModeYes
Quick linksDescription :: Parameters :: Parameter descriptions :: Details

Back to top

Description


REPROJ reprojects both raster and vector data from a valid projection that is in a supported Generic Database (GDB) format and from known datums. A datum is a mathematical surface used to make geographic computations. This program can also be used to resample pixel resolution.
Back to top

Parameters


Name Type Length Value range
Input: Input layer(s) Mixed port 0 - 1024 1 -
Output: Output layer* Mixed port 1 -    
Reprojection geoEdit - 1024 Any supported projection
Default: Pixel
Resample Method String 0 - 1 NEAR | BILIN | CUBIC
Default: NEAR
Processing Algorithm String 0 -  
Tile positioning transformation String 0 -    

* Required parameter
Back to top

Parameter descriptions

Input: Input layer(s)

Specifies the GDB-supported input layers to be reprojected. This 'Mixed" port allows you to select layers of different data types (for example, raster, vectors, and LUTS), allowing you to reproject only selected layers, or all layers in the file.

Output: Output layer

Specifies the output layer that will contain the reprojected and copied data.

This 'Mixed' port accepts reprojected layers of different data types and allows for the transfer of auxiliary segments.

Reprojection

Specifies the output projection and extents. This parameter is initially populated based on the projection information of the vector or raster layer if they are selected on the Input tab. If you have both raster and vector input, the raster information takes precedence.

The Projection module contains several sections, described below.

Method

The Method selected in the drop-down list determines the required input for the parameters listed in the sub-sections.

Size

Specifies the size, in pixels and lines, of the database image.

Pixel Size

Specifies the output horizontal (X) and vertical (Y) size (resolution) of one pixel.

Projection

This is a standard projection setup consisting of the projection selection drop-down list, the Earth Model button, a georeferencing string text box, and the More button. Together, these elements define the output projection.

Valid projections include:

For information about all the projections available, see "Projections and earth models" in the Technical Reference section of the CATALYST Professional Online Help.

Bounds

Sets the coordinate type for the Upper Left/Lower Right coordinates.

Values include:

Extents

Extents are defined by the Upper Left and Lower Right coordinates. The extents can be entered in either geocoded (X,Y) or geographic (Long/Lat) units, as specified by Bounds; for example, UTM (or most projections) would be Eastings and Northings in meters.

Long/Lat coordinates may be specified in Degrees, Minutes, Seconds (for example, 152d30'00.00" W), or in decimal degrees (for example, -152.5).

Use Maximum Bounds

When the Use Maximum Bounds option is selected, the system calculates the Upper Left/Lower Right coordinates using the input file; the coordinates parameters are therefore disabled.

Note: The extents will be adjusted by Tile positioning transformation, if specified, to make the upper-left-corner coordinate fall on a specific raster grid.

Resample Method

Specifies the resampling method to use for image data.

Supported resampling methods are:

Processing Algorithm

Controls the amount of memory (in megabytes) used by the algorithm.

If the host memory limit is not specified, the function uses a default of 1 GB or half the available physical memory, whichever is smaller.

Tile positioning transformation

An adjustment of the upper-left-corner coordinate for the reprojected image.

By specifying an adjustment you can reproject images so that they fall on a specific raster grid. You do so by providing a keyword and either two or four values.

The keyword indicates the relative positioning of the values, as follows:
After you enter the keyword, you can enter up to four values, as follows:

The values define the position of the corner or center in relation to the raster grid.

Of the four values, only Stride_X is required. If not specified, Stride_Y defaults to the value of Stride_X, and Ref_X, Ref_Y default to zero.

For example, to specify that the upper-left corner of the upper-left pixel of the image will be an even 20-unit multiple from the reference point (432345.000, 5438882.000), enter the following:

Depending on the distance of the tile from that point, its upper-left x-coordinate can be 432345.000, 432365.000, or any other multiple, but never 432346.000 or 432355.000.

If you specify values for this parameter, the effect applies in all scenarios, regardless of whether the image-corner coordinates come from the input file, upper-left x or y coordinate, or as a result of automatic computation.

This parameter is optional.

Back to top

Details

REPROJ reprojects both raster and vector data from a valid projection that is in a supported generic database (GDB) format and from known datums. A datum is a mathematical surface used to make geographic computations. Auxiliary segments, such as lookup tables (LUTs), pseudocolor tables (PCTs), and so on, are allowed input and are transferred to the output file.

An ellipsoid defines the dimensions of the Earth. The datum includes the ellipsoid and its position relative to the center of the Earth.

Each datum references one ellipsoid; however, an ellipsoid can be referenced by one or more datums. If you compare the position of a point calculated using one datum and then calculate the same position using a different datum, the coordinates of the point are different, even if the datums refer to the same ellipsoid.

Because a datum is a mathematical surface used to make geographic computations, it is possible to convert from one datum to another; however, reprojecting a file from one ellipsoid to another does not provide the correct results because the critical information contained in a datum is not defined in the ellipsoid.

The following reprojections are possible:

For more information about transformations between different Earth models, see Earth models in the Technical Reference section of the CATALYST Professional Online Help.

User-defined projections used by MAPUNITS must be defined in the 'userproj.txt' file, located in the PCI/etc/ directory.

The specified reprojection method (REPMETH/Method) defines the reprojection bounds. Two parameters for each method are required; the third parameter values are then calculated by the program.

Available reprojection methods include:

The maximum bounds are derived by projecting the upper-left and lower-right corners. The maximum bounds function can also project 441 points or 21 pixel positions by 21 scan line positions, distributed over the entire input image.

When the reprojection method is PLB (Use pixels/lines and bounds), if the Maximum Bounds are not used, all four coordinates are required. If Maximum Bounds are used, REPROJ calculates the coordinates from the input file.

If the reprojection method is PLR (Use pixels/lines and resolution) and the Maximum Bounds are not used, only the upper-left coordinates are required. If the upper-left coordinates are not defined, the upper-left coordinates from the maximum bounds of the input file (reprojected to the projection string) are used. REPROJ calculates the lower-right bounds.

If the reprojection method is BR (Use bounds and resolution) and the Maximum Bounds are not used, you must specify all four coordinates. If Maximum Bounds are used, REPROJ calculates the coordinates from the input file.

The resampling method affects image reprojection only. You can change the resampling method by selecting the nearest-neighbor, bilinear interpolation, or cubic convolution method. Bitmaps are automatically resampled using the nearest-neighbor method.

If TIPOSTRN (Tile positioning transformation) parameter is specified the upper-left coordinate will always be adjusted, and the lower-right corner, dimensions or resolution will be computed based on reprojection method.

When the reprojection method is PLB (Use pixels/lines and bounds), user-specified output dimensions are preserved and resolution is computed to fit reprojected image into adjusted bounds.

If the reprojection method is PLR (Use pixels/lines and resolution), user-specified output dimensions and resolution are preserved and lower-right coordinate is computed.

If the reprojection method is BR (Use bounds and resolution), user-specified resolution is preserved and dimensions are computed to fit reprojected image into adjusted bounds.

© PCI Geomatics Enterprises, Inc.®, 2024. All rights reserved.