Create chip images containing Digital Chart of the World line work
Rasterize vector data from the Digital Chart of the World (DCW), creating 64 line by 64 sample "chip" images centered at tie points.
- IN
- Input image. The image for which the image chips are to be generated. It must be a single band image if its pixels will be used as background in the image chips. Windowing is ignored. IN may be an AVHRR image with an associated ADDR file or a projected image with a valid DDR. The chip images created will be the same data type as IN.
- INTS
- Input tie point selection file. This file specifies tie points whose latitude and longitude coordinates become the center of each chip.
- OUTMT
- Output merged tie point file. The merged tie point file contains coordinates in the reference (chip) image and search (IN) image corresponding to each tie point, along with other information that is used in image correlation.
- CDPATH(/SGS4/DCW/DCW)
- CD drive location. If the DCW is stored on disk, this value should define the root directory of the DCW data.
- LIBRARY("NOAMER" COUNT=(1:4)
- DCW Library. The DCW library that lines will be extracted from. The DCW is divided into four libraries. Each library exists on a single CD, or in a single directory on disk. These libraries are:
= NOAMER: North America = EURNASIA: Europe and Northern Asia = SOAMAFR: South America and Africa = SASAUS: South Asia and Australia
- PO(--)
- Political boundaries and ocean features. The following fields may be selected for this feature.
= 1: International boundary, de jure = 2: International boundary, de facto = 3: International boundary, de jure & de facto = 4: Administrative boundary, primary = 5: Administrative boundary, major = 6: Treaty or occupancy = 7: Coastal closure line = 8: Ocean demarcation line = 9: Ice line = 10: Coastline = 11: Ice/water line = 12: Sea wall = 13: International Date Line
- DN(--)
- Drainage feature. The following fields may be selected for this feature.
= 1: Streams, rivers = 2: Inland shorelines = 3: Wet sand limits = 4: Canals, aqueducts = 5: Glacial limits = 6: Snow field, glacier = 7: Land/ice line
- RD(--)
- Road feature. The following fields may be selected for this feature.
= 1: Dual lane highways = 2: Primary or secondary roads = 3: Tracks, trails
- RR(--)
- Railroad feature. The following fields may be selected for this feature.
= 1: Single track railroad = 2: Multi-track railroad = 3: Light Railroad
- HY(--)
- Hypsography feature. The following fields may be selected for this feature.
= 1: Close land contour = 2: Depression contour = 3: Closed land, approximated = 4: Carrying contour = 5: Depression, approximated
- HS(--)
- Supplemental hypsography feature. The following fields may be selected for this feature.
= 1: Partial interim or auxiliary contour = 2: Partial depression contour = 3: Partial interim contour, approximated = 4: Carrying contour = 5: Cut or fill = 6: Unreliable = 7: Transition or mistake contour
- PIXVAL(255)
- Pixel value. The grey level value to be given to the rasterized vector lines.
- BACKGRND(0)
- Background value. The value given to the pixels of each chip image that are not assigned a value for the vector data. If BACKGRND is NULL, the background of the chip will be filled with the pixel values from the input image.
- PROJ(SAT)
- Projection code. The projection type of the input image.
= SAT: Satellite projection. The input image is in AVHRR satellite projection. = OTH: All other valid GCTP-supported projections. Projection information for the image is retrieved from the DDR.
All international boundaries and coastlines of North America will be drawn into chip images centered at points in namerica;tps. Merged tie point information will be written to na1;mtp.
Band two of INIMG will be used as the background for chips specified in camerica;tps. Line work of streams and rivers will be taken from the North America and South America/ Africa libraries. Lines will have a pixel value of 1023. Merged tie point information will be written to tmp1;mtp.
All international boundaries of South America/Africa will be drawn into chips specified by africa;tps. INIMG was reprojected, so the chips will be in the same projection. Merged tie point information will be written to af1;mtp.
Processing begins by opening INTS and OUTMT. Points are read from INTS until one is found that is located in IN. Once a valid point has been found, a 64x64 window from IN is calculated to surround the point. This window will become the chip image. The appropriate lines are read from DCW for the area covered by the chip window. The DCW lines are converted to line/sample coordinates based on the projection of IN, sorted, and stored in a temporary file. The chip image is then created, with either a solid background, or background pixels taken from the appropriate window in IN. The temporary file is used to insert line work of pixel value PIXVAL into the chip image. The coordinates of the tie point, elevation, name of the chip, chip size, and other information are written to OUTMT. When all points in INTS have been checked, INTS and OUTMT are closed.
An error occurred creating the specified chip image. The preceding message will explain why the chip could not be created. Processing will continue with the next chip.
After scanning all lines in the specified DCW files, no
segments were found to fall in the output image. The chip
will not be created, and processing will continue with the
next chip.
An error occurred while freeing dynamically allocated memory. It will be automatically freed when the program terminates.
An error occurred dynamically allocating memory, which was required for further processing. Contact the system administrator if the problem persists.
The value specified for BACKGRND was not within the valid range for the data type of IN. Retry, using a different value for BACKGRND.
A fatal error was encountered during processing. The preceding message explains the exact error.
No features from PO, DN, RD, RR, HY, or HS were selected, so no line work would be drawn. Retry, specifying the desired features.
An error occurred searching DATAPATH for room to sort the raster scan file. Verify that DATAPATH includes valid directories.
If BACKGRND is NULL, one band from IN must be specified from
which background pixel values will be taken. Retry,
specifying one band in IN.
An error occurred opening the specified file. Check to ensure that there is sufficient disk space and that you have write permission in the current working directory.
The value specified for PIXVAL was not within the valid range for the data type of IN. Retry, using a different value for PIXVAL.
An error occurred reading INTS. Ensure that it is a valid tie point selection file by running DSPTIE-TPS.
An error occurred while sorting the scan file of line segments. Check to ensure that there is sufficient disk space to write another file the same size as the scan file. If not, the user may set the DATAPATH environment variable to specify an alternate location for sorting the rasterized information.
An error occurred writing to OUTMT. Ensure that there is sufficient disk space.