NAME

     bdimage  - module to generate rasterfile for input to xsd

SYNOPSIS

     bdimage [ -Nntap ] [ -Iimage ] [ -Hheader  ]  [  -rsrs  ]  [
     -rere  ] [ -riri ] [ -nsns ] [ -nene ] [ -nini ] [ -ssss ] [
     -sese ] [ -sisi ] [ -Uuser ] [ -Mmachine ] [ -Ccomment  ]  [
     -Sscalar ]

DESCRIPTION

     bdimage is a rasterization routine that generates a standard
     sun  rasterfile  of  the  requested input data.  The routine
     deposits all rasterfile  data  in  a  directory  header.xsdI
     where  header  is defined by the -H command line option. The
     header file for these images is header.xsdH which  is  found
     in the current directory after execution.  bdimage gets both
     its data and its parameters from command line arguments.

  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 must include the fully qualified  path
          name  regardless  of which directory the routine is run
          from.  Example -N/b/vsp/dummy tells the program to look
          for file 'dummy' in directory '/b/vsp'.

     -I image
          Enter the name of the output  image  immediately  after
          typing  -I.   Do  not include the complete path name as
          that will be built within the routine.

     -H header
          Enter the name of the xsd header file immediately after
          typing  -H.   bdimage  will append .images to this name
          and create a directory called  header.images  in  which
          the rasterfile will be written.

     -rs rs   [default = 1]
          Enter the first record to be rasterized.

     -re re   [default = last record on dataset]
          Enter the last record to be rasterized.

     -ri ri   [default = 1]
          Enter the record increment to be used in the rasteriza-
          tion.

     -ns ns   [default = 1]
          Enter the start trace number.

     -ne ne   [default = number of traces per record]
          Enter the end trace number.

     -ni ni   [default = 1]
          Enter the trace increment.

     -ss ss   [default = 1]
          Enter start sample.

     -se se   [default = number of samples per trace]
          Enter end sample.

     -si si   [default = 1]
          Enter sample increment.

     -M machine   [default is =]
          Enter machine name on which routine is running.

     -U user   [no default]
          Enter userid in use.

     -S scalar   [default = 1.0]
          Enter the desired scalar for display of data.

     -V verbose
          Enter -V on the command line for  an  increase  in  the
          verbosity of  output.

DISCUSSION

     bdimage may be iterated keeping the header  file  name  con-
     stant  to  put  many images into the same subdirectory.  The
     header file is opened with an append option inside the  rou-
     tine.   This  is  great  if  you are intentionally directing
     mulitple images to a subdirectory.  It could be  the  source
     of  much  frustration  if  a  file  of the same name already
     exists on disk.

     The rasterization routine outputs messages about the  server
     and data being rasterized on both std out and std error.  To
     direct all of this to an output file use the form bdimage >&
     msg0  where  msg0  will contain all output messages from the
     routine.

BUGS

     Phylum unknown.

AUTHOR

     Paul G.A. Garossino: TRC, with plagerism from D. Horn : MSC

COPYRIGHT

     copyright 2001, Amoco Production Company
               All Rights Reserved

          an affiliate of BP America Inc.