Use this procedure to extract embedded geolocation points from a processed RADARSAT file. The points are then used to georeference the RADARSAT data to a specific map projection.
Not all RADARSAT files contain embedded geolocation points. If the RADARSAT input data does not have geolocation points, ENVI_RADARSAT_GEOREF_DOIT cannot georegister the file.
Syntax
ENVI_DOIT, 'ENVI_RADARSAT_GEOREF_DOIT' [, BACKGROUND=value] [, DEGREE=value] [, DIMS=array], FID=file ID [, GCP_NAME=string], /IN_MEMORY [, METHOD={0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8}], OUT_FNAME=string [, PIXEL_SIZE=array] [, PROJ=structure] [, R_FID=variable] [, SKIP_LINES=value]
Keywords
BACKGROUND (optional)
Use this keyword to specify the value for all background pixels. The default is 0.
DEGREE (optional)
Use this keyword to specify the degree of the polynomial warp when METHOD=3, 4, or 5. The default is DEGREE=1.
DIMS (optional)
The “dimensions” keyword is a five-element array of long integers that defines the spatial subset (of a file or array) to use for processing. Nearly every time you specify the keyword FID, you must also specify the spatial subset of the corresponding file (even if the entire file, with no spatial subsetting, is to be processed).
- DIMS[0]: A pointer to an open ROI; use only in cases where ROIs define the spatial subset. Otherwise, set to -1L.
- DIMS[1]: The starting sample number. The first x pixel is 0.
- DIMS[2]: The ending sample number
- DIMS[3]: The starting line number. The first y pixel is 0.
- DIMS[4]: The ending line number
To process an entire file (with no spatial subsetting), define DIMS as shown in the following code example. This example assumes you have already opened a file using ENVI_SELECT or ENVI_PICKFILE:
envi_file_query, fid, dims=dims
FID
The file ID (FID) is a long-integer scalar with a value greater than 0. An invalid FID has a value of -1. The FID is provided as a named variable by any routine used to open or select a file. Often, the FID is returned from the keyword R_FID in the ENVIRasterToFID routine. Files are processed by referring to their FIDs. If you work directly with the file in IDL, the FID is not equivalent to a logical unit number (LUN).
GCP_NAME (optional)
Use this keyword to specify the name of the output file to contain the extracted ground control points (GCPs). If you do not set this keyword, the points are not saved to disk.
IN_MEMORY
Set this keyword to specify that output should be stored in memory. If you do not set IN_MEMORY, output will be stored on disk and you must specify OUT_NAME (see below).
METHOD (optional)
Set this keyword to one of the following values to specify the warping method to use.
- 0: RST with nearest neighbor
- 1: RST with bilinear
- 2: RST with cubic convolution
- 3: Polynomial with nearest neighbor (default)
- 4: Polynomial with bilinear
- 5: Polynomial with cubic convolution
- 6: Triangulation with nearest neighbor
- 7: Triangulation with bilinear
- 8: Triangulation with cubic convolution
OUT_FNAME (optional)
Use this keyword to specify an output filename for the resulting data. If you do not set OUT_FNAME, the default output is to memory. If you set the keyword IN_MEMORY, you do not need this keyword.
PIXEL_SIZE (optional)
Use this keyword to specify a two-element array for the output pixel size [x, y]. If you do not specify a value for PIXEL_SIZE, the default is [12.5, 12.5] in meters.
PROJ (optional)
Use this keyword to specify the projection of the resulting data. You cannot set PROJ to the Arbitrary projection. PROJ is a projection structure returned from ENVI_PROJ_CREATE or ENVI_GET_PROJECTION. The default projection is UTM.
R_FID (optional)
ENVI Classic library routines that result in new images also have an R_FID, or “returned FID.” This is simply a named variable containing the file ID to access the processed data. Specifying this keyword saves you the step of opening the new file from disk.
SKIP_LINES (optional)
Use this keyword to specify the number of lines to skip when extracting the GCPs. The default value is 100.
API Version
4.2