NAME

     nanfix - identify and replace  NaN's  or  kill  traces  with
     NaN's

SYNOPSIS

     nanfix [ -Nntap ] [ -Ootap ] [ -sist ] [ -eiend ] [  -nsnstr
     ] [ -nenetr ] [ -rsnrst ] [ -renred ] [ [ -nannum ] [ -Fftap
     ] ] [ -reprnum ] [ -inf ] [ -debug ] [ -K ] [ -iinc ] [ -V ]
     [ -? ]

DESCRIPTION

     nanfix may be run in one of several modes  governed  by  the
     -nan, -debug and -K parameters.  If -debug is present on the
     command line  nanfix  will open the input data and print  to
     stdout  the integer representation of your input time series
     for the traces and samples specified. If  a  -nan  value  is
     specified  on  the command line, nanfix will only operate on
     traces for which this amplitude is found. Otherwise,  nanfix
     will  automatically detect apparent NaN values. Positive and
     negative infinity values can  additionally  be  detected  by
     specifying  the  -inf  flag.  The  location  of the detected
     values will be written to the printout file if -V is  speci-
     fied.  The action to be taken on the data upon location of a
     NaN or infinity value is determined by the presence  of  the
     -K  flag. If present, the entire trace in which the value is
     found will be zeroed out and marked as dead. If  -K  is  not
     specified,  the  program  will  replace the detected samples
     with the amplitude specified by -rep.  The default  replace-
     ment amplitude is 0.

     nanfix gets both its data and its  parameters  from  command
     line  arguments.  These arguments specify the input, output,
     the start and end traces, the start  and  end  samples,  the
     mode,  the NaN amplitude, the replacement amplitude and ver-
     bose printout, if desired.

  Command line arguments
     -N ntap
          Enter the input data set name or file immediately after
          typing -N unless the input is from a pipe in which case
          the -N entry must be omitted.  This input  file  should
          include the complete path name if the file resides in a
          different directory.  Example -N/b/vsp/dummy tells  the
          program to look for file 'dummy' in directory '/b/vsp'.

     -O otap
          Enter the output data  set  name  or  file  immediately
          after typing -O.  This output file is not required when
          piping the output to another process. The  output  data
          set also requires the full path name (see above).


     -s ist
          Enter the start time of the design window.  The default
          is  the  beginning  of  the  trace.  The filter will be
          applied to the whole trace, regardless of the -s and -e
          entries.

     -e iend
          Enter the end time of the design window.   The  default
          is the end of the trace.

     -ns nstr
          Enter the start trace number.  The default is the first
          trace of the record.

     -ne netr
          Enter the end trace number. The  default  is  the  last
          trace of the record.

     -rs nrst
          Enter start record number.  Default value is the  first
          record.

     -re nred
          Enter end record number.  Default value is last record.

     -nan num
          Enter the integer representation of the NaN  entry  for
          this  dataset.  This may be found by first scaning your
          input data with the  USP  program  scan -np  and watch-
          ing  for  the  trace where the NaN's first appear.  Now
          run  nanfix -debug  starting at this  location  in  the
          input  dataset and determine the integer representation
          of the NaN sample.  Once determined the integer may  be
          entered  here  for  a  replacement  run.  Default is to
          auto-detect NaN values.

     -F ftap
          Optional NaN entry: enter the file name containing  the
          integer  representation  of  the  NaN  entry  for  this
          dataset. This method of NaN entry is  sometimes  neces-
          sary  (on  Crays  in  particular) on machines where the
          integer representation is very long. This entry  super-
          cedes -nan[] entry

     -rep num
          Enter the amplitude desired to replace all NaN  entries
          in the input dataset.  The default value is  0.0 .

     -inf Enter the command line argument '-inf' to cause  nanfix
          to  detect +/- infinity values in addition to NaNs when
          running in auto-detection mode. (ie. -nan is not expli-
          citly specified).'

     -debug
          Enter the command line argument '-debug' to cause  nan-
          fix to report to  stdout  the integer representation of
          all time series entries in the defined dataset.'

     -K   Enter the command line argument '-K' to  zero  out  and
          mark  as  dead  traces  having  one or more NaNs. These
          traces will be reported if -V is flagged below.

     -i inc
          For -K mode: enter the sample increment used to  detect
          NaNs.  Increasing  this increases the speed of the pro-
          gram but also decreases  the  likelihood  of  detecting
          NaNs. Default is  1 .

     -V   Enter the command line argument '-V' to get  additional
          printout.

     -?   Enter the command line  argument  '-?'  to  get  online
          help.   The program terminates after the help screen is
          printed.

BUGS

     unknown

SEE ALSO

     clean

AUTHOR

     Paul Garossino, Paul Gutowski, & Joe M. Wade

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved
          an affiliate of BP America Inc.