README 3.87 KB
Newer Older
1 2 3 4 5 6
this is <README>
============================================================================
hd: SFF header manipulation
============================================================================

This is a collection of tools that support SFF (Stuttgart File Format)
7 8 9
header manipulation. All file formats supported by libdatrwxx can be handled
with the following programs:
chacox, offlix, tijerasxx, sehefixx
10

11
Programs provided in this subdirectory:
12

13 14
sehefixx  sets trace header fields and operates on all data formats
          supported by libdatrwxx
15 16 17
cooset    this program sets receiver and source coordinates for global
          seismic data; receiver coordinates are obtained from a table of
          seismic stations
18 19 20 21 22
tijerasxx extract portions of time series (windowing - not tapering)

coma      creates a table of equidistant receiver coordinates
chaco     uses a tabel produced by coma to set receiver and source
          coordinates in an SFF data file
23 24 25
offli     prints a list of receiver offsets contained in an SFF file
          this program provied different output formats to craete control
          files for refmet, chaco, or wolle info files
26 27

epi       prints a list of receiver offsets contained in an SFF file
28 29
merse     combines all traces from several different SFF input data files
          within one single SFF data file (does no waveform stacking); use
30
          fidase if you want to manipulate the waveform too and if you want
31
          to stack data at identical offsets
32 33 34 35 36 37

Obsolete programs, which are superseded by the above programs and which will
no longer be maintained:

sehefi    sets the fields station, channel, auxid and instype in the WID2
          lines of an SFF data file to explicite values
38 39 40
sesoc     set the source coordinate in an SFF data file
sesot     set the source time in an SFF data file

41 42 43 44 45 46 47 48 49 50 51 52
============================================================================
Test cases
----------

In subdirectory 'testcases' test cases are provided. These are not yet
documented in detail. Please check Makefile in testcases, which serves as an
entry point to the other Makefiles. Usually the test cases can be controlled
by make variables to be passed on the command line. Test cases may require
other external programs in order to create test waveforms. These programs can
include programs for synthesis of full seismograms. At least the program suite
from src/synt/misc is required in most cases.

53 54 55 56 57
==========================================================================

Installation
------------

58 59 60
This software is part of the project Seitosh. See README.1st in the root
directory of the collection or https://git.scc.kit.edu/Seitosh/Seitosh for
general installation instructions.
61 62 63 64 65 66 67 68 69 70 71


The Makefile supports program compilation and linking. Some binary libraries
are required. 

The command
  make all
will compile and install the binary executables. 

Environment variables control where the results are stored and where
libraries and library header files are expected:
72 73 74
  LOCLIBDIR       defines location of binary libraries
  LOCINCLUDEDIR   defines location of C/C++ header files (prototypes)
  TF_WWWBASEDIR   defines location of doxygen output (used by some libraries)
75 76 77

Dependencies:
  
78
  Seitosh libraries required to compile the code:
79 80 81 82
    libaff        provides libaff.a
    libdatrwxx    provides libdatrwxx.a
    libfapidxx    provides libfapidxx.a
    libgsexx      provides libgsexx.a
83 84 85
    libsff        provides libsff.a
    libsffu       provides libsffu.a
    libsffxx      provides libsffxx.a
86
    libtf         provides libtf.a
87
    libtfxx       provides libtfxx.a
88
    libtime       provides libtime_trad.a and libtime++.a
89 90 91 92

============================================================================

The home of this software suite is
93
https://git.scc.kit.edu/Seitosh/Seitosh/tree/master/src/ts/hd
94 95 96 97 98

Please send bug reports and suggestions to
Thomas.Forbriger@kit.edu

----- END OF README -----