NAME

     mkusp - create a usp file of several different types

SYNOPSIS

     mkusp -Ootap -nsmpnsmp -ntrcntrc -nrecnrec

     [ -COS [-ttime] ] |

     [ -INT [-ttime] [-offoff] [-radrad] ] |

     [ -SIG [-Fffile]  [-nsinsi]  [-nxshiftnxshift]  [-nyshiftny-
     shift] [-C] ] |

     [ -RAN [-ttime] [-lbndlbnd] [-ubndubnd] [-seedseed] ]

     [-h -? ] [-V]

DESCRIPTION

     mkusp can create a synthetic USP data  file of several  dif-
     ferent types:

          -COS (cosine signal)
          -INT (integer pattern)
          -SIG (shifted signal generator)
          -RAN (random numbers)

     mkusp does only a minimal job of constructing line and trace
     headers,  putting in only the essential fields.  This may be
     enhanced in a future version.


  Command line arguments
     -Ootap
          Enter the output data set name immediately after typing
          -O.   This  output  file should include the complete or
          relative path name if the file is to be  created  in  a
          directory  other  than  the  current  one. If no output
          filename is given, the output USP data set will go to a
          pipe.


     -nrecnrec
          Enter  the  number  of  output  records  desired.   (No
          default)


     -ntrcntrc
          Enter the number of output traces desired. (No default)


     -nsmpnsmp
          Enter  the  number  of  output  samples  desired.   (No
          default)


     -COS If this option is given a cosine signal  is  generated.
          The following suboptions apply in this case:

             -ttime
                  Enter the time per trace (in seconds).  Default
                  is 1.0.

             mkusp
                  will generate a  USP  data  file  specified  by
                  val(it,ix)  =  cos(w*t)  where  w=2*pi*ix,  t =
                  dt*(it-itbias) and itbias  is  the  shift  from
                  record to record.


     -INT If this option is given, an  integer  pattern  is  gen-
          erated.  The following suboptions apply in this case:

             -ttime
                  Enter the time per trace (in seconds).  Default
                  is 1.0.

             -offoff
                  Enter the offset. Default is 0.

             -radrad
                  Enter the radix.  Default is 512 .

             mkusp
                  will generate a  USP  data  file  specified  by
                  val(it,ix,iy)= off + mod(it,rad) + rad


     -SIG If this option is given, an  integer  pattern  is  gen-
          erated.  The following suboptions apply in this case:

             -Fffile
                  Enter the name of the frequency file.

             -nsinsi
                  Enter  the  sample  interval  in  milliseconds.
                  (Default = 1)

             -nxshiftnxshift
                  Enter the sample  shift  in  the  x  direction.
                  (Default = 2)

             -nyshiftnyshift
                  Enter the sample  shift  in  the  y  direction.
                  (Default = 3)

             -C   If included, complex samples are produced.  The
                  full number of samples is thus 2*nsmp.

             mkusp
                  will generate a  USP  data  file  specified  by
                  val(it,ix,iy)  = signal( index ), where index =
                  mod( (ix-1)*nxshft  +(iy-1)*nyshft  +  and  the
                  signal  amplitudes  are generated from the fre-
                  quency file specified by ffile.  This file must
                  contain:

                  nfreq

                  frequency amplitude phase ( nfreq entries



     -h -?
          Enter either of these keys for online help.   The  pro-
          gram will terminate after printing this.


     -V   Enter this option for more verbose output.

EXAMPLES

     The command:

          mkusp -Ofile0.usp -nrec10 -nsmp10 -ntrc10 -lbnd0.0 -ubnd100.0 -V

     will create file file0.usp with 10 records, 10 samples,  and
     10  traces, with the samples being filled with random values
     ranging from 0.0 to 100.0.

DIAGNOSTICS

BUGS

     None known.

AUTHOR

     J. Cooperstein, Axian Inc.

COPYRIGHT

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