EXTRACT(1)                CUSP COMMANDS                EXTRACT(1)



NAME
     extract - extract complete event and phase information  from
     phase file(s).

SYNOPSIS
     extract  [-p]  [-f  ncsn  |   ucb]   [-e   event_file]   [-n
     not_found_file] [-s] [-v] [-h] [phase_file]

DESCRIPTION
     The extract program will  extract  the  complete  event  and
     phase  information  for  the selected events from either the
     complete online NCSN phase files, the  complete  online  UCB
     phase  files,  or  from the specified user phase file.  NCSN
     phase files are in hypoinverse format, and UCB phase  phases
     are  in  UCB phase file format.  Shadow cards (if present in
     the NCSN phase files) can optionally  be  include  with  the
     complete event and phase information.

     You specify which events to  extract  by  providing  extract
     with  a list of event summary lines that were extracted from
     the appropriate NCSN or UCB catalog using the eqselect  pro-
     gram.

OPTIONS
     -p   specifies  that  the  online  phase  files  should   be
          searched  for  the specified events.  If this option is
          not used, you must specify a specific phase file to  be
          searched.

     -f ncsn | ucb
          specifies the format of the event summary lines and  of
          the  phase  files  to  be  searched.  The two supported
          options are ncsn and ucb. The default format is ncsn.

     -e _e_v_e_n_t__f_i_l_e
          specifies the file containing the events, one per line,
          for  which  complete event and phase information should
          be extracted.  If this option  is  not  specified,  the
          event  list  will be read from stdin.  NOTE: The events
          in the input list  must  be  in  ascending  time-sorted
          order.

     -n _n_o_t__f_o_u_n_d__f_i_l_e
          specifies that the event line for any event  not  found
          in the phase file(s) should be written to the specified
          file.  If this option is not specified, brief  informa-
          tion  about  any  event  not found in the phase file(s)
          will be listed in stderr output stream.

     -s   specifies that shadow cards should be included with the
          extracted event information if they were present in the
          phase  file.   extract  will  automatically   determine



UC Berkeley       Last change: 2 DECEMBER 1992                  1






EXTRACT(1)                CUSP COMMANDS                EXTRACT(1)



          whether shadow cards are present in the phase file(s).

     -v   specifies verbose  output.  extract  will  display  the
          names  of  input  files  as they are opened.  Since the
          online phase files are very large, this option can keep
          you informed of extract's progress.

     -h   prints out a summary help message with the command syn-
          tax.

EXAMPLES
     extract -p -v < mylist.catalog > mylist.events
          will read event summary lines from  mylist.catalog  and
          place  the  extracted  event  information  in  the file
          mylist.events.  Shadow cards will not be included  with
          the event information.

     extract -p -e mylist.catalog > mylist.events
          will read NCSN event summary lines from  mylist.catalog
          and  place  the extracted NCSN event information in the
          file mylist.events.  Shadow cards will not be  included
          with the event information.

     extract -p -f ucb -e mylist.catalog > mylist.events
          will read UCB event summary lines  from  mylist.catalog
          and  place  the  extracted UCB event information in the
          file mylist.events.

ENVIRONMENT
     The following variables must be  defined  in  the  shell  in
     which extract is invoked:

     CUSPPHASEDIR
          Pathname of the directory hierarchy containing  all  of
          the NCSN phase data.

     UCBPHASEDIR
          Pathname of the directory hierarchy containing  all  of
          the UCB phase data.

SEE ALSO
     eqselect    (1),    catalog(5),    ncsn(5)    ncsn.phase(5),
     ncsn.catalog(5), ucb(5), ucb.catalog(5), ucb.phase(5)

AUTHOR
     Please   report   bugs    and    address    questions    to:
     doug@perry.berkeley.edu








UC Berkeley       Last change: 2 DECEMBER 1992                  2