GRHISTORY (Jan93)                 grasp                GRHISTORY (Jan93)



NAME
    GRHISTORY -- Put GRASP processing history into an image header.
    
    
USAGE
    grhistory input taskname plist
    
    
PARAMETERS
    
    input
        List of images to have headers modified.
    
    taskname
        Name of the task which produced the input images.
    
    plist
        Task parameter list to be added to the image history.
    
    
DESCRIPTION
    
    GRHISTORY  is  used  when  the  DMAC  operator  (or some other user)
    operates on a GONG image with a non-GRASP or foreign task and  needs
    to record the processing history in the header.
    
    GRHISTORY  will  append  to  the GRASP history keywords of the input
    image, adding the task name, the date and time the  task  completed,
    the  GRASP  version  number, and the full task parameter list (i.e.,
    both queried and hidden) as provided by the user via plist.
    
    
    
EXAMPLES
    
    1.  Modify the image history of the output of  IMCOPY  after  it  is
    used  to  split the VMI data cube into separate velocity, modulation
    and intensity images.
    
      gr> imcopy vmi*.imh[*,*,1] %vmi%V%*.imh
      gr> grhistory V*.imh imcopy "input=vmi*[*,*,1]"
    
    
    2.  Modify the image history of the output of IMARITH  after  it  is
    used to     subtract the dark image from the raw data.
    
      gr> imarith tcraw921225t*.imh - darktc921225 ds//tcraw921225t*.imh
      gr> grhistory dstcraw*.imh imarith "operand1=tcraw921225t*.imh,op=-,o
      perand2=darktc921225,title="""",divzero=0.,hparams="""",pixtype="""",
      calctype="""",verbose=no,noact=no"
    
    Note  the  use  of  double  double-quotes in order to print a double
    quote in the history.
    
    
    3. Do the above, but put in the individual input names, rather  than
    the template.
    
      gr> files tcraw921225t*.imh > inlist
      gr> s1 = ",op=-,operand2=darktc921225,title="""",divzero=0.,hparams="
      """,pixtype="""",calctype="""",verbose=no,noact=no"
      gr> list = "inlist"
      gr> while (fscan(list,s2) != EOF)
      >>>     grhistory ("ds"//s2, "imarith", "operand1="//s2//s1)
    
    
    
TIME REQUIREMENTS
    
    
BUGS
    
    When  processing  a  list  of  images, it is not possible to put the
    unique input file name in the plist.   If  this  is  required,  then
    GRHISTORY  must be executed separately for each image with the plist
    parameter being appropriately modified for  each  execution.    This
    can be easily done with a simple script as shown in example 3 above.
    
    
SEE ALSO