ahmilb@houu64$bhpread

 BHPREAD - Read bhpio dataset

 bhpread filename=      [optional parameters]

 Required Parameters:                                            

  filename=             File name which was used by BHPWRITE to create

                        the dataset.

 Optional Parameters:                                            

  pathlist=             ASCII file containing the same list of paths

  'filename'.dat        which were used with BHPWRITE to create the

                        dataset

  keys=fldr,offset      Up to 5 header keys which were used to

                        create the dataset.

  keylist=p1,p2:s1-s2   List of trace header values to read for each

                        key. Use a colon to delimit the list for each key.

                        Valid syntax includes:               

                        k1,k2,...  List of specific keys     

                        k1-k2      Range                     

                        k1-k2[k3]  Range, with increment     

                        p1,s1^p2,s2 Project arbitrary traverse

                                   from p1,s1 to p2,s2, and  

                                   read traces along the line

                                   By default, traces are formed

                                   by bilinear interpolation.

                                   To get nearest traces along

                                   arbitrary line, use interpolation=nearest

                        *          Read all                   

  BHPREAD passes traces in the order specified by keylist.    

  If keylist is specified, it must contain an entry for each  

  key in the keys parameter. If keys are not specified, BHPREAD passes

  traces in the order they were written by BHPWRITE.

  rule=near             Trace selection rule: near, match, all, or stack

                        rule=near - select trace nearest requested one

                        rule=match - select a trace only if 

                                     it matches the request 

                        rule=all - select all traces in the bin

                        rule=stack - stack all traces in the bin

                        Stack is normalized by the fold count of each

                        sample, and header nhs has number of summed traces.

  maxtraces=0           Maximum number of traces to read.     

                        Zero means read all requested data.

                        If maxtraces is specified, and the    

                        specified keylist results in more 

                        than maxtraces, output will be truncated.

  request=data          Default action is to pass traces out. 

                        request=summary will pass information 

                        about the requested data instead.    

                        For request=summary, the following

                        information will be written to stdout:

                        min, max, mean, and rms values of the

                        requested data, samples-per-trace,

                        number of traces, sample units(0=milliseconds,1=feet,2=meters)

                        time/depth interval, start and end time/depth

                        request=fold is used to write fold traces to stdout.

                        Fold traces consist of a single sample containing the

                        fold value for the keys in the keys= specification,

                        and can be piped into bhpwritecube, bhptranspose, and

                        bhpwritecube to create a viewable fold map.

  foldfile=             Specify a filename to produce an ASCII fold count file.

                        Each ASCII record will contain

                        key-value key-value... fold count

                        NOTE: If both foldfile='file' and request=fold are specified,

                        both types of fold data will be written.

  properties=...        List of properties to read.

                        If the input data were created by     

                        bhproffread, properties should be a   

                        comma-separated list of the model

                        properties which are requested

  horizons=...          List of horizons.                      

                        If the input data were created by     

                        bhphorizon, horizons should be a      

                        list of the horizons which            

                        are requested                          

  endian=my_endian      Omit endian parameter to write native format.

                        Specify endian=1 to force BIG_ENDIAN  

                        Specify endian=0 to force LITTLE_ENDIAN

  timeslice=st,end,inc  Timeslice start time, end time, incr  

  display=yes           Display time slices; no=don't display 

  interpolate=bilinear  Spatial interpolation option          

                        Requires primary and secondary keys   

                        Use interpolate=nearest to get nearest

                        trace instead of interpolating        

  verbose=0             For debug print, use verbose=1

  C SHELL ALERT:  If you use C shell, you will get the error message 'No match'

                  if you use a key increment, e.g. keylist=1-10[2]    

                  To avoid the error, use a different shell or protect the square

                  brackets with backslashes, e.g. keylist=1-10\[2\] 

  Trace Header Usage:                    

    wevel=[0,1]        wevel=1 is used to flag last trace in ensemble

    tracr contains a sequentional ensemble number