DESCRIPTION

       Segydump provide Unix ls or DOS dir like functionality for SEGY seismic
       data files.  It is possible to list the file header,  trace  header(s),
       and write out actual trace data to a data file suitable for Gnuplot.

       If  your  file  is not fully SEGY Rev 1 compliant, you must specify the
       appropriate driver for vender modifications.

       Specify as many SEGY files on the command line as you would like.

       usage: segydump.py [options] segyfile1 segyfile2 ... segyfileN

   options:
       --version
              show program's version number and exit

       -h, --help
              show this help message and exit

       -d DRV, --driver=DRV
              specify  which   driver   to   parse   data   file.    [default:
              segy_drv_rev1]

       -H, --with-filename
              print the filename for each entry

       -n, --no-file-header
              do not show the file header fields

       -N, --get-num-traces
              print out the number of traces in a file

       -s, --short-list
              restrict the fields to the drivers short list

       -t TRACEHEADERNUMBER, --trace-header=TRACEHEADERNUMBER
              set  this  to view values for a trace header.  0 for all.  Nega-
              tive values go from the back of the file.  [default: none]

       -T, --with-trace-num
              print the trace number before each trace entry

       -w, --write-trace
              use this flag to write the trace files to disk

       -v, --verbose
              how  much  information  to  give.   Specify  multiple  times  to
              increase verbosity

       --verbosity=VERBOSITY
              Specify verbosity.  Should be in the range of 0...4 (None...Bom-
              bastic)

       Prepend the filename in front of each line written:

          segydump.py --with-filename *.sgy

       Ask  for  the number of traces in the file and only show the short list
       of header fields:

          segydump.py --get-num-traces --short-list file.segy

       Show the first trace header:

          segydump.py --trace-header=1 file.segy

       Show the last trace header in the file:

          segydump.py --trace-header=-1 file.segy

       Show all the traces in a file and include the trace number before  each
       field:

          segydump.py --with-trace-num --trace-header=0 file.segy

       Write out trace 2 to disk and plot it with gnuplot:

          segydump.py --write-trace -t 2 file.segy
          gnuplot
          plot 'file.segy-00002.dat' with lp

DIAGNOSTICS

       If  you pass in a SEGY file that is malformed, specify a bad driver, or
       give a trace number that is too large, the program will throw an excep-
       tion  and leave you with a python stack trace.  You may have to look at
       the code to figure out what it is wrong.

ENVIRONMENT

       PYTHONPATH  Add additional drivers in you python path to make them
                   available

SEE ALSO

       segysql(1), segy-py, grep

       The homepage for the segy-py package can be found here on the web:

         http://schwehr.org/software/segy-py/



Schwehr                          October 2005                   SEGYDUMP.PY(1)