Structure and Field Descriptions

SeisChannel Fields

Name	Type	Meaning
id	String	unique channel ID formatted net.sta.loc.cha
name	String	freeform channel name string
src	String	description of data source
units	String	units of dependent variable [1]
fs	Float64	sampling frequency in Hz
gain	Float64	scalar to convert x to SI units in flat part of power spectrum [2]
loc	Array{Float64,1}	sensor location: [lat, lon, ele, az, inc] [3]
resp	Array{Complex {Float64},2}	complex instrument response [4]
misc	Dict{String,Any}	miscellaneous information [5]
notes	Array{String,1}	timestamped notes
t	Array{Int64,2}	time gaps (see below)
x	Array{Float64,1}	univariate data

Table Footnotes

[1]	Use UCUM-compliant abbreviations wherever possible.

[2]	Gain has an identical meaning to the “Stage 0 gain” of FDSN XML.

[3]	Azimuth is measured clockwise from North; incidence of 0° = vertical; both use degrees.

[4]	Zeros in :resp[i][:,1], poles in :resp[i][:,2].

[5]	Arrays in :misc should each contain a single Type (e.g. Array{Float64,1}, never Array{Any,1}). See the SeisIO file format description for a full list of allowed value types in :misc.

SeisData Fields

As SeisChannel, plus

Name	Type	Meaning
n	Int64	number of channels
c	Array{TCPSocket,1}	array of TCP connections

Time Convention

The units of t are integer microseconds, measured from Unix epoch time (1970-01-01T00:00:00.000).

For regularly sampled data (fs > 0.0), each t is a sparse delta-compressed representation of time gaps in the corresponding x. The first column stores indices of gaps; the second, gap lengths.

Within each time field, t[1,2] stores the time of the first sample of the corresponding x. The last row of each t should always take the form ` [length(x) 0]`. Other rows take the form [(starting index of gap) (length of gap)].

For irregularly sampled data (fs = 0), t[:,2] is a dense representation of time stamps for each sample.

SeisHdr Fields

Name	Type	Meaning
id	Int64	numeric event ID
ot	DateTime	origin time
loc	Array{Float64, 1}	hypocenter
mag	Tuple{Float32, String}	magnitude, scale
int	Tuple{UInt8, String}	intensity, scale
mt	Array{Float64, 1}	moment tensor: (1-6) tensor, (7) scalar moment, (8) %dc
np	Array{Tuple{Float64, Float64, Float64},1}	nodal planes
pax	Array{Tuple{Float64, Float64, Float64},1}	principal axes, ordered P, T, N
src	String	data source (e.g. url/filename)

SeisEvent Fields

Name	Type	Meaning
hdr	SeisHdr	event header
data	SeisData	event data