Input image file name. The input must have a standard VICAR map label. Any projection which is supported by the map-projection program MAP3 is also supported by OVERLAY.
Output image file name. The output image will be the same data format as the input image.
SIZE=(sl,ss,nl,ns) Specifies the VICAR size field: starting line, starting sample, number of lines, and number of samples. The output image will be nl x ns, where pixel (1,1) corresponds to pixel (sl,ss) of the input.
Starting line in input
Starting sample in input
Number of lines
Number of samples
Specifies the mission if the input is not a standard label or if there is no input image. Defaults to input label mission type. Valid are: MAR-9 MAR10 VIKOR VGR-1 VGR-2 GLL NOPRO (for no project)
REAL--OPTIONAL LIMITS=(r1,r2,r3,r4) specifies the minumum latitude, maximum latitude, minimum longitude, and maximum longitude boundaries of the grid overlay. This parameter is primarily used to speed up execution by limiting the grid calculation to the planet area within the field-of-view of the picture.
KEYWORD--OPTIONAL The keyword AUTO causes OVERLAY to automatically determine the latitude- longitude boundaries of the image (see LIMITS parameter).
SUPP=r specifies the latitude above which DLO2 and DLA2 values are used (instead of DLO1 and DLA1). See DLA1, DLO1, DLA2, DLO2 parameters.
REAL--OPTIONAL DLA1=r specifies the spacing of latitude lines (in deg) equatorward of SUPPRESS.
REAL--OPTIONAL DLA2=r specifies the spacing of latitude lines (in deg) poleward of SUPPRESS. The spacing of latitude lines poleward of SUPPRESS
REAL--OPTIONAL DLO1=r specifies the spacing of longitude lines (in deg) equatorward of SUPPRESS.
REAL--OPTIONAL DLO2=r specifies the spacing of longitude lines (in deg) poleward of SUPPRESS.
REAL--OPTIONAL GLATIDU=(r1,r2,r3,...) specifies that lines of constant latitude are to be drawn at latitudes r1, r2, r3, etc. Up to 181 latitudes may be specified. This turns off the default grid.
REAL--OPTIONAL GLONGITU=(r1,r2,r3,...) specifies that lines of constant longitude are to be drawn at longitudes r1, r2, r3, etc. Up to 360 longitudes may be specified. This turns off the default grid.
KEYWORD--OPTIONAL Causes the program to print out the following information at each grid intersection of the image: TBD
INTEGER--OPTIONAL MAXD=I3 where I3 is an integer specifying the maximum DN value of a grid line. The default is 255 for byte images and 32767 for halfword images.
KEYWORD--OPTIONAL Valid values are BLACK and WHITE, where WHITE causes white grid lines to be drawn (DN=MAXDN), and BLACK causes black grid lines to be drawn (DN=0). The default is WHITE.
Dn values of grid points are alternated between black and white. This is not always successful, leading to less than pleasing results.
KEYWORD--OPTIONAL Adds kilometer per pixel scale bar to output file; value taken from DATA(7) of MAP label of input image file.
KEYWORD--OPTIONAL Suppresses latitude-longitude annotation of grid.
INTEGER--OPTIONAL DLAT=n annotates every nth grid intersection along latitude lines.
DLON=n annotates every nth grid intersection along longitude lines.
INTEGER--OPTIONAL EXPAND=n causes the latitude-longitude annotation to be magnified by a factor of n.
KEYWORD--OPTIONAL Causes the grid to be annotated using east-longitudes.
START=I6 where I6 is an integer specifying the first byte in the GEOMA dataset which starts the tiepoints. This is the first word after the TIEPTS keyword. The default is for the program to look for tiepoints in the dataset or if the input picture is from a standard project, a value is set.
If this keyword is specified, the latitude/longitude grid is not drawn. In this case, the user must specify either LIMB or TERMINAT (q.v.) (or both), else the program will have nothing to do and quits.
This keyword specifies that the planet limb should be drawn in the image. This option is only available in perspective map projection.
This specifies the approximate spacing of limb points (in pixels). Setting it much below 1 should guarantee a solid limb. Setting it to a value greater than 1 should cause a dotted limb to be generated, although this cannot be guaranteed to be regular. Increasing the spacing will also reduce the number of limb points needed, in case this proves to be a limiting factor.
This specifies the approximate spacing of terminator points. If TSPACE=1, then the spacing will be the same as that of the limb points (see parameter LSPACE). A larger value of TSPACE increase the spacing by a corresponding factor, .e.g., TSPACE=3 means that every third point will be used. (It is not possible to reduce the spacing to less than that of LSPACE.)
This specifies the DN to be used for limb points if 'LIMB has been specified. The default value in the PDF is 128, which is suitable for Byte images. If the image is Halfword, then a value in the range (0,32767) should be supplied.
This keyword specifies that the terminator (dividing line between the illuninated and shadow regions) should be drawn in the image. This option is only available in perspective map projection. Also, this option requires that LIMB also be specified. The default value in the PDF is 64, which is suitable for Byte images. If the image is Halfword, then a value in the range (0,32767) should be supplied.
This specifies the DN to be used for terminator points if 'TERMINAT has been specified.
SUBSOL = (latitude, longitude) This parameter specifies the subsolar latitude & longitude to be used in the computation of the Terminator (if the TERMINAT keyword has been selected). It is needed only for images for which no navigation data are available in the label.
For planets that are not modelled as perfect spheres, this keyword controls the type of latitudes output by the program: LAT_TYPE = PCENTRIC specifes that latitudes are planetocentric, i.e., determined by the vector from the planet center. LAT_TYPE = PGRAPHIC or PDETIC specify planetographic latitudes, which are measured with reference to the surface normal. The default is PCENTRIC, since this is the VICAR standard.
Ex: TARGET=GANYMEDE specifies that GANYMEDE is the target in the input image. The TARGET may be a planet, satellite, or asteroid. If defaulted, the target name is extracted from the VICAR label or determined by other TBD means. A complete list of valid target names is located in the ASCII file assigned the logical name (or environmental variable) BODY_IDS.
SPICEMODE=LOCAL specifies that SPICE data is to be retrieved from local SPICE kernels. SPICEMODE=REMOTE specifies that SPICE data is to be retrieved via the SPICE server. If SPICEMODE is defaulted, the logical name (or environmental variable) DEFAULTSPICE is used to determine whether LOCAL or REMOTE is used. Note that if SPICE data is not found in LOCAL or REMOTE mode, the other mode is attempted.
CKNAME is a four character string specifying the C-kernel to be used: CKNAME C KERNEL -------- ------------- DAVI MIPS_DAVI.CK NAV MIPS_NAV.CK FARE MIPS_FARENC.CK NAV2 MIPS_NAV2.CK NEAR MIPS_NEAR.CK AMOS MIPS_AMOS.CK NAIF the best NAIF kernel is used If defaulted, the kernels are searched in the above order.
CKID is an alternative way to specify the prefered C-kernel (see CKNAME
parameter):
CKID CKNAME C KERNEL
---- -------- -------------
M906 DAVI MIPS_DAVI.CK
M905 NAV MIPS_NAV.CK
M904 FARE MIPS_FARENC.CK
M903 NAV2 MIPS_NAV2.CK
M902 NEAR MIPS_NEAR.CK
M901 AMOS MIPS_AMOS.CK
varies NAIF there are a large number of these files
Ex: CKID=M901 specifies the four character ID which uniquely identifies the
C-kernel MIPS_AMOS.CK.
A complete list of the C-kernel IDs is located in the ASCII file assigned the
logical name (or environmental variable) KERNELDB.
If specified, CKID overrides the CKNAME parameter.
USERID is a three character string which identifies the user who created the
camera pointing.
Ex: USERID=HBM identifies Helen Mortensen as the creator of the camera
pointing.
GROUPID is a three character string which identifies the group which created the camera pointing. Ex: GROUPID=040 identifies group 040 as the creator of the camera pointing.
INSTITUTE is a four character string identifying the facility which created the camera pointing. Ex: INSTITUTE=MIPS specifies that MIPS created the camera pointing.
PURPOSE is a four character string identifying the purpose of the observation or the purpose of processing. For example, PURPOSE=MOSA identifies the image as part of a mosaic sequence PURPOSE=COLO identifies the image as part of a color sequence
PROGRAM is the first six characters of the program creating the camera pointing. Ex: PROGRAM=FARENC specifies that FARENC created the camera pointing.
SPKID specifies the four character ID which uniquely identifies the SP kernel used to create the camera pointing. The SP-kernel IDs are located in the ASCII file assigned the logical name (or environmental variable) KERNELDB. Ex: SPKID=N015 specifies the SP kernel GLL_LONG_2.BSP
REQUNUM is a four character string identifying the IPL request number for which the camera pointing was created. Ex: REQNUM=3456 identifies (somewhat) request number R123456
Date and time the camera pointing was created in the form 'YEARMMDDHHMM'.
Ex: CDATE=199602291200 specifies that the pointing was created at noon
on February 29, 1996.