Guralp Systems Limited
MAN-SWA-0008 - Guralp Systems' Linux tools

Chapter 5. Libraries

5.1 Core libraries

5.1.1 libiso8601

This library manipulates dates/times (including leap second support) using the ISO8601 international date/time representation. It is an open source library maintained at:

http://www.lwithers.me.uk/usr/src/libiso8601/

No configuration is necessary (although there is a mechanism for updating the table of leap-seconds; see above page for details).

5.1.2 libcgic

This library provides CGI support routines. It is based on the cgic package at http://boutell.com/cgic/.

5.1.3 libgslutil

A comprehensive utility library developed and used by Güralp Systems Ltd.

5.1.4 libgsldaemon

A library developed and used by Güralp Systems Ltd which provides functions to enable a program to run as a daemon.

5.1.5 libCStreamedXML

This library handles the XML file format used by the SEED mappings file. It is required by libseedmap2. It is an open source library maintained at:

http://www.lwithers.me.uk/usr/src/libCStreamedXML/

5.1.6 libtimespan

A library for representing and manipulating spans or ranges of time efficiently. Time-spans are represented as a start point and an end point. Spans can be added or removed from a timespan set. The library copes with merging or splitting existing spans of time as it is manipulated.

This library is frequently used to record things such as gaps in received data. It can store persistent files if the application needs, but no configuration is required.

5.1.7 libframesettrack

This library is used to efficiently record received frames or blocks for protocols using a 64-bit sequence number. It represents a set of frames or blocks as a list of [start,end] tuples and copes with merging tuples if gaps between them are bridged.

It is frequently used in data receivers to keep track of received frames or blocks and to request backfill as appropriate. It can store persistent files if the application needs, but no configuration is required.

5.2 Seismic data formats

5.2.1 libdata-gcf

Library for handling the decoding of GCF (Güralp Compressed Format) data. Comprehensive functionality and very fast performance.

5.2.2 libdata-strong-motion

Support library for handling strong motion format GCF blocks (see the document SWA-RFC-STMN for the specification of these blocks).

5.2.3 libdata-unified-status

Support library for handling unified status format GCF blocks (see the document SWA-RFC-UNIS for the specification of these blocks).

5.2.4 libmseed

Maintained by Chad Trabant at Iris, this library provides a comprehensive set of routines for reading and writing Mini-SEED records (data-only SEED volumes).

http://www.iris.edu/software/libraries/#libmseed

Currently, there are some minor modifications made to the library (primarily to its build system); these have been submitted for inclusion. The library is open source and released under the terms of the GNU GPL v2 (note that GSL only distribute this library in source code format and, thus, complies with the license obligations).