Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added a GSF file description

...

...

Code Block
identifier, rupture, type, date, version

GSF File

The GSF file is used to define the geometry of a source in a source modelling problem. It is the first step in the SRF generation process after a realisation is read.

A GSF file contains three sections in order:

  1. Errata/Header section,
  2. Declaration of the number of points (N),
  3. The geometry description: N lines representing each point in the geometry.

There are utilities to read GSF files in the gsf  module within qcore.

Errata/Header

The header consists of a number of commented lines, each beginning with # . Here is an example:

Code Block
# nstk= 179 ndip= 215
# flen=    17.0720 fwid=   21.2853
# LON  LAT  DEP(km)  SUB_DX  SUB_DY  LOC_STK  LOC_DIP  LOC_RAKE  SLIP(cm)  INIT_TIME  SEG_NO

This is the typical output of fault_seg2gsf . The first line has the number of points in the strike and dip directions, respectively. Then the length and width of the fault, and the last line is a description of each column in the points section.

The header is skipped by programs parsing GSF files and may contain any number of lines. The Python GSF generator, for example, only prints out the column description.

Code Block
# LON  LAT  DEP(km)  SUB_DX  SUB_DY  LOC_STK  LOC_DIP  LOC_RAKE  SLIP(cm)  INIT_TIME  SEG_NO

Declaration of the Number of Points

Immediately following the header, there is one line containing the number of points in the GSF geometry definition.

Geometry Description

The geometry description has N lines, where N is the number of points declared in the previous section. Each line has 11 space separated values representing one point in the geometry.

ColumnDescription
LONThe longitude of the point.
LATThe latitude of the point.
DEPThe depth of the point (in kilometres, with -10 meaning 10km below ground level).
SUB_DX

The subdivision length in the strike direction.

SUB_DYThe subdivision length in the dip direction.
LOC_STKThe fault segment strike.
LOC_DIP

The fault segment dip.

LOC_RAKEThe fault segment rake.
SLIPThe total slip at this point (cm), usually -1.
INIT_TIMEThe initial rupture time of this point, usually -1.
SEG_NOThe number corresponding to the segment this point belongs to.: