Help for IBISUPDATE

IBISUPDATE is a VICAR program which copies corrected camera pointing data
from an IBIS SEDR file to a SPICE C-kernel.  IBISUPDATE is one of a suite
of programs used primarily for creating digital mosaics.  The program
currently works for Galileo SSI only.

EXECUTION:

  IBISUPDATE INP=ibisfile  TARGET=targetname  user-parameters...
where
  INP is the input IBIS SEDR file, and
  TARGET is the name of the planet, satellite, or asteroid in the image.

The IBIS SEDR file is originally created by IBISNAV, and later updated with
corrected pointing via OMCOR2.

OPERATION:

The data for each image is read from the IBIS SEDR file.  If the SCET parameter
is specified, the records matching the input SCETs are processed.  Otherwise,
all records in the IBIS SEDR file are processed.  Processing consists extracting
the camera pointing and storing it in the MIPS C-kernel MIPS_NEAR.CK.

To later access the updated navigation information with programs like
MAP2, the user should use the CKNAME parameter with a value of NEAR.

LOCAL AND REMOTE SPICE ACCESS:

Corrected camera pointing may be stored in local or remote (e.g. at JPL) SPICE
C-kernels.  Remote access is via a SPICE server.

SPICEMODE specifies whether local or remote SPICE access is to be used.
If defaulted, SPICEMODE is set to the value of the logical name (or
environmental variable) DEFAULTSPICE.

PARAMETERS FOR STORING THE IMPROVED CAMERA POINTING:

The following optional parameters are used to store provenance information along
with the improved (C-Smithed) camera pointing computed by the program.  This
provenance information is stored in the (C kernel) segment identifier for the
camera pointing data.  In cases where there are several versions of camera
pointing for an image in a given C kernel, this provenance information can
later be used to retrieve a specific instance of camera pointing from the
kernel.

PURPOSE identifies the purpose for creating the camera pointing.
REQNUM identifies the request number associated with the camera pointing.
CDATE specifies the date and time the camera pointing was created.
GROUPID identifies the group which created the camera pointing.
INSTITUTE identifies the facility which created the camera pointing.

See the level 2 help (via the TAE tutor mode) for further details.

Example:  'REMOTE INSTITUTE=DLR USERID=TYR stores the improved camera pointing
          via the SPICE server.  Provenance data regarding the facility (DLR)
          and user (Thomas Roatsch) who created the data is included.

GALILEO'S FULL FRAME MODE AND SUMMATION MODE

In conformance to new convention, the CAMERA s/n for GLL is now used to specify
Full Frame Mode (if s/n = 1) or Summation Mode (if s/n = 2).  If the CAMERA
is not specified the program defaults CAMERA to Full Frame Mode (s/n = 1).

EXAMPLES:

             IBISNAV out=IB.SDR  user-parameters...

                ( run OMCOR )

             IBISUPDATE IB.SDR  TARGET=JUPITER CAM=5 'UPDATE                       PROJECT=VGR-1
     -or-    IBISUPDATE IB.SDR  TARGET=JUPITER 'UPDATE                       PROJECT=GLL

             MAP2 image  SEDRSRC=NEAR parameters

PROGRAM HISTORY:

Original programmer: Jean Lorre
Cognizant programmer: Jean Lorre
Revisions:
  When         Who  What
  -----------  ---  -----------------------------------------------------------
  10 Jan 1997  SMC  Corrected .PDF documentation                      (FR89979)
  14 Nov 1996  SMC  Fixed so that SPKID from the new IBISNAV file format is 
                    recognized and passed to PUTSPICE95 to write to CK (FR89225)
  28 Aug 1996  SMC  Implemented support for GLL Summation Mode processing
                    Obtain Camera S/N from IBIS file, use CAMERA as override 
                    (DFR)
   6 Jun 1996  GMY  Implemented GETSPICE95/PUTSPICE95 interface
  20 Oct 1995  FFM  Ported to Unix
  24 Aug 1998  RRP  Made it Y2K compliant. Put check for scet (Y2K FRD<901>).
  04 Jan 1999  TXH  Corrected call to 'mvcl' from 'mvlc' in moving SPKID.
                    (AR-101223).
  14 Aug 2002  GMY  Linux compile changes:  cosd(angle) to cos(angle*dtr)

PARAMETERS: