event

exception FileParseError

exception EventExtrasDumpError

exception EOF

exception EmptyEvent

class Tag(...) → dummy for str

Any str matching pattern '^([A-Za-z][A-Za-z0-9._]{0,128})(:([A-Za-z0-9._-]*))?$'.

class Event(lat=0.0, lon=0.0, north_shift=0.0, east_shift=0.0, time=0.0, name='', depth=None, elevation=None, magnitude=None, magnitude_type=None, region=None, load=None, loadf=None, catalog=None, moment_tensor=None, duration=None, tags=None, extras=None)

Representation of a seismic event.

Parameters:

• lat – latitude of hypocenter (default 0.0)

• lon – longitude of hypocenter (default 0.0)

• time – origin time system timestamp

• name – event identifier as string (optional)

• depth – source depth (optional)

• magnitude – magnitude of event (optional)

• region – source region (optional)

• catalog – name of catalog that lists this event (optional)

• moment_tensor – moment tensor as moment_tensor.MomentTensor instance (optional)

• duration – source duration as float (optional)

• tags – list of tags describing event (optional)

• extras – dictionary for user defined event attributes (optional). Keys must be strings, values must be YAML serializable.

♦ time

time_float (pyrocko.guts.Timestamp), default: str_to_time('1970-01-01 00:00:00')

♦ depth

float, optional

♦ name

str, optional, default: ''

♦ magnitude

float, optional

♦ magnitude_type

str, optional

♦ region

str, optional

♦ catalog

str, optional

♦ moment_tensor

pyrocko.moment_tensor.MomentTensor, optional

♦ duration

float, optional

♦ tags

list of str (Tag) objects, default: []

♦ extras

dict of pyrocko.guts.Any objects, default: {}

load_events(filename, format='detect')

Read events file.

Parameters:

• filename – name of file as str

• format – file format: 'detect', 'basic', or 'yaml'

Returns:

list of Event objects

exception OneEventRequired

dump_events(events, filename=None, stream=None, format='basic')

Write events file.

Parameters:

• events – list of Event objects

• filename – name of file as str

• format – file format: 'basic', or 'yaml'