Isis 2 Documentation
lev1plot - plot level1 ISIS images in level2 space. "lev1plot" will plot the footprint boundaries of a list of level 1 images into level 2 projections using the SPICE information in the kernels on the labels of the images. This program can plot Control points in a file, but does not plot Control points from the labels of the images. Match point file plotting is not implemented. The projections available are whatever projections are implemented in MAPPARS. "lev1plot" creates a PostScript file that can be printed on a black and white or color printer, can be plotted on a color plotter, or displayed using the system program 'ghostview'. Use your usual print command lines when sending your file to any PostScript translating plotter or printer, else you will have to get into the plotter/printer machine doc- umentation. For 'ghostview': bug{927}> ghostviewIf "lev1plot" is run with the default color file and then sent to a black and white printer, the footprints, limbs, etc., will be printed in various shades of gray. Use COLOR=$ISISDATA/blackAndWhite.txt for all black. In addition, a TOERR file can be generated which will contain a list of cubes which were unsuccessful. Note that the output from "lev1plot" is an ascii file which you could edit (if you know what you are doing). PROGRAMMER: K Teal Thompson
Parm | Description | Default |
---|---|---|
INC | Get Range Faster but Sparser | NONE |
CONTROL | Control Point File | NONE |
MATCH | Match Point File | NONE |
LONDIR | Direction of positive longitude | "WEST" |
LATSYS | Latitude system (default OGRAPHIC) | "OGRAPHIC" |
FROMLIST | List of input cube file names (No default extension) | NONE |
TO | Postscript file (overwrites existing) | NONE |
TOERR | File listing unsuccessful cubes | NONE |
MATFROM | File with matchpoints | |
MAPPARS | Map projection and parameters (e.g., MAPPARS="SINU:0" | NONE |
TARGDEF | Target or target definition | -- |
LATRANGE | Latitude range (default=total range of cubes) | NONE |
LONRANGE | Longitude range (default=total range of cubes) | NONE |
PAPER | Paper width & height in inches. (or) | NONE |
SCALE | fractional map scale, (i.e. for 1:1,000,000 scale=1.0) | NONE |
HEADER | User comment at top of page | NONE |
FONTSZ | Font/character size of plot title. | NONE |
LINESZ | Width of the plottin line [SMALL,MEDIUM,LARGE] | NONE |
COLOR | Text file with red, green, blue triples | NONE |
QUAD | Plot quad boundaries | NONE |
FOOT | Plot image footprints | NONE |
LABEL | Product ID, Image Number or Filename at image center | NONE |
LIMB | Plot the limb in each image | NONE |
TERM | Plot the terminator in each image | NONE |
LONSYS | Longitude system (default 0 to 360) |
ADDITIONAL NOTES:
Parm | Description |
---|---|
TOERR | A file which will contain the cubes in FROMLIST which were unsuccessful and therefore statistics could not be calculated. |
INC | Input an Increment and get a correspondinly sparser range calculation that will run faster. |
CONTROL | Control Point File: Lev1plot will overlay control point numbers on the output plot based on their latitude and longitude values. The control point i.d.'s and their associative lat/lon's are usually supplied by RAND's software in ascii column format: Example: latitude longitude radii control_pt_id This feature on the output plot is useful in determining which control point i.d.'s fall within the input image(s) boundaries that are plotted. |
MATCH | Match Point File |
LONDIR | Direction of positive longitude |
LATSYS | This parameter is used to define the latitude system computed by "lev1" programs. Valid values are either OGRAPHIC or OCENTRIC. The default is OGRAPHIC. Your selection is written to the labels of the cube or table file. This effects programs which output or use the latitude, for example, "qview", "lev1stats", "lev1tolev2". |
FROMLIST | A maximum of 128 characters is allowed for each file name. List one file per line. Up to 10000 cubes can be listed. |
INSTPARS | This parameter is used to specify instrument specific properties. For example, to define the location of a new set of SPICE kernels. **NOTE** For a detailed explanation of INSTPARS, tutor the instpars.pdf (i.e., TAE> tutor instpars). |
MAPPARS | See level.pdf Enter a target definition file, target name (which will be used to generate the default target definition file), or use the default (copy target information from the FROM file. Example: TARGDEF=mars The software will try to find files: $ISISDATA/targets/mars.def.1 $ISISDATA/targets/mars.def.2 $ISISDATA/targets/mars.def.3 etc. Or enter a user written target definition file path and name: TARGDEF=/work1/elee/mars.def.3 If you want radii different from the defaults in the system, you cannot enter the radii numbers here. Copy the system target definition file to your area and edit, putting the radii you want into the definition file. Then TARGDEF=your_ file. Note also that the target definition file name will be written to the cube labels, and you will help yourself if you use a version system as is being done in ISIS. Each time you make edits to your target definition file, rename it and keep the old versions lying around somewhere where you can find them. |
LATRANGE | Latitude range of the desired output plot. If the range is not entered then it will be automatically computed based upon the input images. If the range is entered then LONRANGE must be entered as well. |
LONRANGE | Longitude range of the desired output plot. If the range is not entered then it will be automatically computed based upon the input images. If the range is entered then LATRANGE must be entered as well. |
LONSYS | ? |
PAPER | Paper width and height in inches. If scale is input, the paper width necessary to print the plot will be reported. Else if paper height and width are input, the resulting scale will be reported. Notice what might appear to be contradictory outputs: For a sinusoidal projection & for LATRANGE = -90 to 90 and LONRANGE = -180 to 180 WIDTH = 4 HEIGHT = 6 program calculates: WIDTH scale (divided by million) = 210 HEIGHT scale (divided by million) = 70 chooses larger scale to make projection smaller to fit in both directions: SCALE (divided by million) = 210 user inputs SCALE = 210 back into program and gets: Paper size calculated from input scale: (in Inches): 4.000293 x 2.000147 This is because WIDTH = 4 determined scale; then user inputs scale, which with LONRANGE = -180 to 180 gives 4 inches for WIDTH. LATRANGE = -90 to 90 will obviously be about half as big in the sinusoidal giving 2 inches for HEIGHT. Also for a sinusoidal projection & for LATRANGE = -90 to 90 and LONRANGE = -180 to 180 WIDTH = 4 HEIGHT = 1 program calculates: WIDTH scale (divided by million) = 210 HEIGHT scale (divided by million) = 420 chooses larger scale to make projection smaller to fit in both directions: SCALE (divided by million) = 420 user inputs SCALE = 420 back into program and gets: Paper size calculated from input scale: (in Inches): 2.000147 x 1.000073 This is because HEIGHT = 1 determined scale; then user inputs scale, which with LATRANGE = -90 to 90 gives 1 inch for HEIGHT. LONRANGE = -180 to 180 will be about twice as big in the sinusoidal and using the same scale results in 2 inches for WIDTH. |
SCALE | The map scale is defined by the user or more commonly defined by a specific map series. Most map series have specific scales which vary throughout the series depending on the projection. For all projections except CYLI, SIMP and SINU, the map scale is expressed as the ratio or proportion between comparable measurements on the map to the surface represented by the map. This ratio is often called the Representative Fraction (RF). The RF is usually expressed as 1:5,000,000 or 1/5,000,000. At this scale, 1 cm on the map represents 5,000,000cm (50km) on the planet surface. Enter the second number of the RF divided by 1,000,000 for the SCALE. ( i.e. for 1:10,000,000 RF , SCALE = 10 for 1:18,261,561 RF , SCALE = 18.261561 for 1:502,000 RF , SCALE = .502 for 1:24,000 RF , SCALE = .024) For CYLI, SIMP, and SINU projections, the scale is related to kilometers per degree on the planet. To match a CYLI, SIMP or SINU to another projection (will match only at the equator), divide the desired RF scale by the number of kilometers in one degree of longitude on the equator of the planet. For example, to match a SINU to an existing 1:25,000,000 (SCALE=25) Mars map of another projection: Mars' equatorial radius is 3393.4 km. The circumference of Mars is 21,321.36 km (2 * PI * 3393.4). One degree of longitude is 59.226km (circumference/360). So the scale to use for the SINU is 25/59.226 or SCALE = .422112. See HELP PAPER for more info. See HELP * for more info. |
HEADER | A comment or plot label at the top of the plot. DEFAULT will automatically write the concatenation of instrument and map projection to the header. |
FONTSZ | Font/character size for both the plot title and the user's desired image ID for each image footprint. As you plot on increasing paper sizes, you may want to reduce font size. |
LINESZ | First element is width of the line for gridding. Second element is width of the ticks. SMALL = 0 thinnest line possible MEDIUM= 1 LARGE = 2 |
COLOR | A text file with Red, Green, Blue values. The default file in the system $ISISDATA/color.txt has 12 repeating values. A new color file can be produced by copying the default file and editing it, to add/subtract/change color values. Be ad- vised that the total number of triples (repeating or not) should be more than the number of images being plotted. The user will get gray levels when using the same value for each color in the triple. COLOR= 0.,0.,0. will draw black lines, COLOR=1.,1.,1. will draw white lines, and intermedi- ate values correspond to intermediate shades of gray. Color can only be printed on some printers. To get color, vary the values in relation to each other. COLOR = 1. 0. 0. = red COLOR = 0. 1. 0. = green COLOR = 0. 0. 1. = blue COLOR = 1. 1. 0. = yellow COLOR = 1. 0. 1. = magenta COLOR = 0. 1. 1. = cyan COLOR = 1. 1. 1. = white COLOR = .5 .5 .5 = gray In the color text file, just put 3 values separated by spaces on each line. |
QUAD | Plot the boundaries of the user's latitude/longitude range if input, or plot the defaulting latitude/longitude range. |
FOOT | Plot images' projected footprints. Note that for high reso- lution images, the defaults to plot QUAD & FOOT may be enough, but for low resolution images with limbs and term- inators, set limb=y & term=y as well. This is where the color file will be used to select a different color for each image footprint. The default system color.txt file has 12 colors that then begin repeating. |
LABEL | Does the user want Product ID, Image Number or filename plotted for each image at the center of the image footprint. Null value produces nothing at the center. Image labels are plotted in the color of the image's footprint. |
LIMB | Plot the projection of each image's limb. Valid data points on the image with emission angles between 85 degrees and 90 degrees are plotted with a "+" character in the same color as the image's footprint. |
TERM | Plot the projection of each image's terminator. Valid data points on the image with incidence angles between 87 degrees and 90 degrees are plotted with an "*" character in the same color as the image's footprint |
Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov