# ------------------------------------------------------------------------------------------------------------------
#             Project File -- This file contains information about the setup of the experiment. 
# ------------------------------------------------------------------------------------------------------------------
# General syntax rules:
#
# - Everything after a '#' character is considered to be a comment (and is ignored).
# - All empty lines are ignored.
# - Any space character or tab-stop in a line containing (any) text will be interpreted as column separator! The
#   use of spaces in strings is not supported. Because of this you must use '_' or the letter 'T' to combine date
#   and time information to one single string.
# ------------------------------------------------------------------------------------------------------------------


# ------------------------------------------------------------------------------------------------------------------
# >>> SOURCE POINTS <<<                                                                                               
# ------------------------------------------------------------------------------------------------------------------
# This section describes the location and trigger time of the seismic sources.
# ------------------------------------------------------------------------------------------------------------------
# Syntax:
#
# - Every source point line MUST start with the character 'S' in the first column. (The software uses this as 
#   indicator to identify "source point" lines.)
#
# - The second 'name' column is an arbitrary text string that makes it easier for humans to work with this file.
#   You can place a description of the source point here ("at_yellow_house"), a stake number or anything else you
#   thing might be helpful. 
#   As this column is not interpreted by the GIPPtools software you can also just use the same string for each
#   source point line. (However, the column must exist! Otherwise the software will get out of sync and interpret
#   longitude as latitude, etc.)
#
# - The next three columns define the location of the source point (latitude, longitude and elevation). Latitude
#   and longitude should be given in decimal degrees. Latitudes south of the equator are negative as well as 
#   longitudes west of Greenwich. Elevation should be given in meters. If you don't have the coordinates of your
#   source points (yet) use some dummy values (like '0.0').
#   The coordinates given here are entered into the SEG-Y trace header and will be used to calculate the absolute
#   (i.e. non-negative) distance between source and receiver.
#
# - The sixth column is the Field File Identification (FFID). Every source point must have a unique (positive
#   integer) FFID assigned to it.
#   The FFID will be entered into the resulting SEG-Y trace header. Usually seismic processing software uses this
#   number to identify the recorded traces.
#
# - The trigger time of the seismic source goes into the seventh column. It consists of date and time information.
#   given in ISO 8601 format (example: "2005-11-17T16:05:01.170"). All programs of the GIPPtools package resolve
#   time down to 10e-6 seconds.
#   (Important: Use 'T' or '_' to con-cat date and time. If you use a space character instead, the time information
#   will be interpreted as the next (optional) column.
#   
# - The date/time information is followed by a variable number of optional columns. As the name already says,
#   columns are optional and unlike the previous columns no placeholder/dummy value is needed!
#   The intended use for these columns is to transport arbitrary additional information that may be required
#   by further processing steps into the resulting SEG-Y file (e.g. "amount of explosives used" or "water depth").
#   If optional columns are used, the value given is always interpreted as a 4 byte floating point number. The
#   value of the first optional column is entered into the SEG-Y trace header at it's end (bytes #237-#240). A
#   following second optional value is placed right before the value of the first column (bytes #232-#236). The
#   third optional again is placed before the second (at #228-#231) and so on.
#   Warning! If you use to many optional values (there is no hard limit build into the software) you will begin
#   to overwrite important fields in the SEG-Y trace header. 
#
# ------------------------------------------------------------------------------------------------------------------
#  Name    Latitude      Longitude  Elevation  FFID          Shot-Time       Optional-1  Optional-2  Optional-3 ... 
# ------------------------------------------------------------------------------------------------------------------

S   s21    -33.19686459  22.06957459  579.27      1   2005-11-17T06:05:01.170   7.0
S   s32    -33.18820584  22.06444784  566.29      2   2005-11-17T06:36:29.593   
S   s41    -33.17675364  22.05925192  540.64      3   2005-11-17T07:12:36.225   7.0


# ------------------------------------------------------------------------------------------------------------------
# >>> RECEIVER POINTS <<<                                                                                           
# ------------------------------------------------------------------------------------------------------------------
# This section describes which EDL recorder were used during the measurement, when they were recording data and
# where they were located while doing so.
# ------------------------------------------------------------------------------------------------------------------
# Syntax:
#
# - Every receiver point line MUST start with the character 'R' in the first column. (The software uses this as 
#   indicator to identify "receiver point" lines.)
#
# - The second 'name' column is an arbitrary text string that makes it easier for humans to work with this file.
#   You can place a description of the receiver point here ("close_to_big_tree"), a stake number or anything else
#   you thing might be helpful. 
#   As this column is not used by the GIPPtools software you can also just use the same string for each receiver
#   point line. (However, the column must exist! Otherwise the parsing software will get out of sync and interpret
#   longitude as latitude, etc.)
#
# - The next three columns define the location of the receiver point (latitude, longitude and elevation). Latitude
#   and longitude should be given in decimal degrees. Latitudes south of the equator are negative as well as 
#   longitudes west of Greenwich. Elevation should be given in meters. If you don't have the coordinates of your
#   receiver points (yet) use some dummy values (like '0.0').
#   The coordinates given here are entered into the SEG-Y trace header and will be used to calculate the absolute
#   (i.e. non-negative) distance between source and receiver.
#
# - The sixth column is the 'Channel' number. Each receiver point must have an unique positive integer channel
#   number assigned to it.
#   The channel number will be entered into the resulting SEG-Y trace header. Usually seismic processing software
#   uses this number to identify the recorded traces.
#
# - The next four columns are needed to locate the data in recorded files. Column seven contains the EDL unit
#   name used to record the data at this location. (At the GIPP this is something like 'e3456' or 'e6789'.)
#
# - Column eight is used to indicate the recording channel of the EDL unit. Possible values are 'p0' to 'p5' for
#   the primary EDL recording channels and 's0' to 's5' for the secondary channels. (If you used a 3 channel unit
#   in the file obviously only values from 'p0' to 'p2' make sense.)
#
# - The last two columns describe the begin and end of the recording. They consist of date and time information.
#   given in ISO 8601 format (example: "2005-11-17T16:05:01.170"). Depending on your experiment setup it may be
#   enough to give just date information. This is OK. But if you enter also time of day information here, you
#   should at least specify hour and minutes. 
#   (Important: Use 'T' or '_' to con-cat date and time. If you use a space character instead, the time information
#   will be interpreted as the next (optional) column.
#   
# ------------------------------------------------------------------------------------------------------------------
#  Name    Latitude      Longitude  Elevation  Channel  EDL-Unit  EDL-Component  Start-Recording   Stop-Recording   
# ------------------------------------------------------------------------------------------------------------------

R  rp1     -33.21339797  22.07830312  598.33        1    e3168         p0        2005-11-16T18:00  2005-11-17T13:00
R  rp2     -33.21251272  22.07803132  598.74        2    e3168         p1        2005-11-16T18:00  2005-11-17T13:00
R  rp3     -33.21166987  22.07775852  597.41        3    e3168         p2        2005-11-16T18:00  2005-11-17T13:00
R  rp4     -33.21103422  22.07756537  597.10        4    e3185         p0        2005-11-16T18:00  2005-11-17T13:00
R  rp5     -33.21020620  22.07730941  595.98        5    e3185         p1        2005-11-16T18:00  2005-11-17T13:00
R  rp6     -33.20939127  22.07696380  596.07        6    e3185         p2        2005-11-16T18:00  2005-11-17T13:00
R  rp7     -33.20837359  22.07659491  594.86        7    e3130         p0        2005-11-16T18:00  2005-11-17T13:00
R  rp8     -33.20748451  22.07631964  594.24        8    e3130         p1        2005-11-16T18:00  2005-11-17T13:00
R  rp9     -33.20659018  22.07607680  593.67        9    e3130         p2        2005-11-16T18:00  2005-11-17T13:00
R  rp10    -33.20587042  22.07589593  592.66       10    e3132         p0        2005-11-16T18:00  2005-11-17T13:00


# --- Fin ----------------------------------------------------------------------------------------------------------
