cpylab Documentation

cpylab - Copies keyword labels from one file to another
The "cpylab" program will copy either the SPICE keywords, MATCH points,
BAND_BIN keywords, IMPSUB keywords (a subset of the IMP-specific
keywords), or the keywords that are LISTed in the
$ISISDATA/isis_keywords.sav file from the FROM file to the TO file.
For COPY options SPICE and MATCH, the program checks for matching image
numbers for the FROM and TO files.

For the COPY=LIST option, the program will copy all the keywords in the
BAND_BIN Group (if the number of input bands and the number of output
bands are the same), the IMAGE_MAP_PROJECTION Group, and the
ASTER_METADATA Group in addition to the keywords listed in the
$ISISDATA/isis_keywords.sav file.

The OPTION parameter determines how the keywords will be copied.  If
OPTION=REPLACE, the keywords chosen by the COPY parameter will be
removed from the TO file label and are replaced by the keyword values
from the FROM file. If OPTION=ADD, the keywords chosen by the COPY
parameter will be copied from the FROM file to the TO file.  Any
keywords that are not found on the FROM file label will not be removed
from the TO file label.  However for COPY=BAND_BIN, the program will use
the ADD option automatically.

The BESAFE option is used to override error checking when transferring
keywords.  When BESAFE=YES then the program will check to ensure the
image numbers of the FROM and TO cubes match and if they do not will
abort. This can be overridden by setting BESAFE=NO which is useful
when the two cubes have been co-registered and thus essentially have
the same SPICE information.  WARNING: those who use this option
must understand there are risks involved in transferring information
between cubes without the same image number.

PROGRAMMER: Jim Mathews, USGS, Flagstaff, Arizona

Input cube file name
  (default extension is .cub)

NONE

Output cube file name
  (default extension is .cub)

NONE

Keywords to copy
  (SPICE, LIST, MATCH, BANDBIN,
   IMPSUB)

"SPICE"

Copy options
  (REPLACE or ADD)

"REPLACE"

Copy labels with error
checking (YES or NO)

"YES"

ADDITIONAL NOTES:

Parm	Description
FROM	Input cube file name. If the file extension is omitted, then ".cub" will be assumed.
TO	Name of existing cube file whose label will be updated. If the file extension is omitted, then ".cub" will be assumed.
COPY	If SPICE is specified, only the SPICE keywords will be copied. The image numbers for the FROM and TO files must match. The keywords are: INSTRUMENT_DECLINATION INSTRUMENT_RIGHT_ASCENSION INSTRUMENT_TWIST PLANET_DECLINATION PLANET_RIGHT_ASCENSION PLANET_TWIST SPACECRAFT_VECTOR_X SPACECRAFT_VECTOR_Y SPACECRAFT_VECTOR_Z SUN_VECTOR_X SUN_VECTOR_Y SUN_VECTOR_Z RAW_TIE_POINTs CONTROL_POINTs MATCH_POINTs If LIST is specified, the keywords listed in the isis_keywords.sav file will be copied from the FROM file to the TO file. If BANDBIN is specified, the keywords in the BAND_BIN group will be copied from the FROM file to the TO file. OPTION = REPLACE will automatically be used. If MATCH is specified, the match points will be copied from the FROM file to the TO file. The image numbers for the two images must match. If IMPSUB is specified, the following subset of the IMP-specific keywords will be copied: SPACECRAFT_NAME TARGET_NAME PLANET_DECLINATION PLANET_RIGHT_ASCENSION PLANET_ROTATION CMD_AZIMUTH CMD_ELEVATION INSTRUMENT_TWIST LANDER_SURFACE_QUATERNION MLL_MFX_OFFSET_VECTOR IMP_LSC_POSITION_VECTOR OMEGA PHI KAPPA PSEUDO_HEADING PSEUDO_ROLL PSEUDO_PITCH
OPTION	Two options exist for copying the keywords from the input cube to the output cube. REPLACE will replace the output file label keywords with a copy of the input cube file label keywords. ADD will copy the keywords chosen by the COPY option from the input cube file label to the output cube file label. Any keywords that exist on the output cube file label but do not exist on the input cube file label will remain on the output cube label.
BESAFE	The BESAFE option is used to override error checking when transferring keywords. When BESAFE=YES then the program will check to ensure the image numbers of the FROM and TO cubes match and if they do not will abort. This can be overridden by setting BESAFE=NO which is useful when the two cubes have been co-registered and thus essentially have the same SPICE information. WARNING: those who use this option must understand there are risks involved in transferring information between cubes without the same image number.