pyrocko.io.quakeml

exception QuakeMLError

exception NoPreferredOriginSet

class ResourceIdentifier(dummy) → str

Any str matching pattern "^(smi|quakeml):[\\w\\d][\\w\\d\\-\\.\\*\\(\\)_~']{2,}/[\\w\\d\\-\\.\\*\\(\\)_~'][\\w\\d\\-\\.\\*\\(\\)\\+\\?_~'=,;#/&]*$".

class WhitespaceOrEmptyStringType(dummy) → str

Any str matching pattern '^\\s*$'.

class OriginUncertaintyDescription(dummy) → str

Any str out of ['horizontal uncertainty', 'uncertainty ellipse', 'confidence ellipsoid'].

class AmplitudeCategory(dummy) → str

Any str out of ['point', 'mean', 'duration', 'period', 'integral', 'other'].

class OriginDepthType(dummy) → str

Any str out of ['from location', 'from moment tensor inversion', 'from modeling of broad-band P waveforms', 'constrained by depth phases', 'constrained by direct phases', 'constrained by depth and direct phases', 'operator assigned', 'other'].

class OriginType(dummy) → str

Any str out of ['hypocenter', 'centroid', 'amplitude', 'macroseismic', 'rupture start', 'rupture end'].

class MTInversionType(dummy) → str

Any str out of ['general', 'zero trace', 'double couple'].

class EvaluationMode(dummy) → str

Any str out of ['manual', 'automatic'].

class EvaluationStatus(dummy) → str

Any str out of ['preliminary', 'confirmed', 'reviewed', 'final', 'rejected'].

class PickOnset(dummy) → str

Any str out of ['emergent', 'impulsive', 'questionable'].

class EventType(dummy) → str

Any str out of ['not existing', 'not reported', 'earthquake', 'anthropogenic event', 'collapse', 'cavity collapse', 'mine collapse', 'building collapse', 'explosion', 'accidental explosion', 'chemical explosion', 'controlled explosion', 'experimental explosion', 'industrial explosion', 'mining explosion', 'quarry blast', 'road cut', 'blasting levee', 'nuclear explosion', 'induced or triggered event', 'rock burst', 'reservoir loading', 'fluid injection', 'fluid extraction', 'crash', 'plane crash', 'train crash', 'boat crash', 'other event', 'atmospheric event', 'sonic boom', 'sonic blast', 'acoustic noise', 'thunder', 'avalanche', 'snow avalanche', 'debris avalanche', 'hydroacoustic event', 'ice quake', 'slide', 'landslide', 'rockslide', 'meteorite', 'volcanic eruption', 'duplicate earthquake', 'rockburst'].

class DataUsedWaveType(dummy) → str

Any str out of ['P waves', 'body waves', 'surface waves', 'mantle waves', 'combined', 'unknown'].

class AmplitudeUnit(dummy) → str

Any str out of ['m', 's', 'm/s', 'm/(s*s)', 'm*s', 'dimensionless', 'other'].

class EventDescriptionType(dummy) → str

Any str out of ['felt report', 'Flinn-Engdahl region', 'local time', 'tectonic summary', 'nearest cities', 'earthquake name', 'region name'].

class MomentTensorCategory(dummy) → str

Any str out of ['teleseismic', 'regional'].

class EventTypeCertainty(dummy) → str

Any str out of ['known', 'suspected'].

class SourceTimeFunctionType(dummy) → str

Any str out of ['box car', 'triangle', 'trapezoid', 'unknown'].

class PickPolarity(dummy) → str

Any str out of ['positive', 'negative', 'undecidable'].

class AgencyID(dummy) → str

Undocumented.

class Author(dummy) → str

Undocumented.

class Version(dummy) → str

Undocumented.

class Phase(**kwargs)

Undocumented.

♦ value

str

class GroundTruthLevel(dummy) → str

Undocumented.

class AnonymousNetworkCode(dummy) → str

Undocumented.

class AnonymousStationCode(dummy) → str

Undocumented.

class AnonymousChannelCode(dummy) → str

Undocumented.

class AnonymousLocationCode(dummy) → str

Undocumented.

class Type(dummy) → str

Undocumented.

class MagnitudeHint(dummy) → str

Undocumented.

class Region(dummy) → str

Undocumented.

class RealQuantity(**kwargs)

Undocumented.

♦ value

float

♦ uncertainty

float, optional

♦ lower_uncertainty

float, optional

♦ upper_uncertainty

float, optional

♦ confidence_level

float, optional

class IntegerQuantity(**kwargs)

Undocumented.

♦ value

int

♦ uncertainty

int, optional

♦ lower_uncertainty

int, optional

♦ upper_uncertainty

int, optional

♦ confidence_level

float, optional

class ConfidenceEllipsoid(**kwargs)

Undocumented.

♦ semi_major_axis_length

float

♦ semi_minor_axis_length

float

♦ semi_intermediate_axis_length

float

♦ major_axis_plunge

float

♦ major_axis_azimuth

float

♦ major_axis_rotation

float

class TimeQuantity(**kwargs)

Undocumented.

♦ value

builtins.float (pyrocko.guts.Timestamp)

♦ uncertainty

float, optional

♦ lower_uncertainty

float, optional

♦ upper_uncertainty

float, optional

♦ confidence_level

float, optional

class TimeWindow(**kwargs)

Undocumented.

♦ begin

float

♦ end

float

♦ reference

builtins.float (pyrocko.guts.Timestamp)

class ResourceReference(dummy) → str

Any str matching pattern "^(smi|quakeml):[\\w\\d][\\w\\d\\-\\.\\*\\(\\)_~']{2,}/[\\w\\d\\-\\.\\*\\(\\)_~'][\\w\\d\\-\\.\\*\\(\\)\\+\\?_~'=,;#/&]*$".

class DataUsed(**kwargs)

Undocumented.

♦ wave_type

builtins.str (DataUsedWaveType)

♦ station_count

int, optional

♦ component_count

int, optional

♦ shortest_period

float, optional

♦ longest_period

float, optional

class EventDescription(**kwargs)

Undocumented.

♦ text

str

♦ type

builtins.str (EventDescriptionType), optional

class SourceTimeFunction(**kwargs)

Undocumented.

♦ type

builtins.str (SourceTimeFunctionType)

♦ duration

float

♦ rise_time

float, optional

♦ decay_time

float, optional

class OriginQuality(**kwargs)

Undocumented.

♦ associated_phase_count

int, optional

♦ used_phase_count

int, optional

♦ associated_station_count

int, optional

♦ used_station_count

int, optional

♦ depth_phase_count

int, optional

♦ standard_error

float, optional

♦ azimuthal_gap

float, optional

♦ secondary_azimuthal_gap

float, optional

♦ ground_truth_level

builtins.str (GroundTruthLevel), optional

♦ maximum_distance

float, optional

♦ minimum_distance

float, optional

♦ median_distance

float, optional

class Axis(**kwargs)

Undocumented.

♦ azimuth

RealQuantity

♦ plunge

RealQuantity

♦ length

RealQuantity

class Tensor(**kwargs)

Undocumented.

♦ mrr

RealQuantity

♦ mtt

RealQuantity

♦ mpp

RealQuantity

♦ mrt

RealQuantity

♦ mrp

RealQuantity

♦ mtp

RealQuantity

class NodalPlane(**kwargs)

Undocumented.

♦ strike

RealQuantity

♦ dip

RealQuantity

♦ rake

RealQuantity

class CompositeTime(**kwargs)

Undocumented.

♦ year

IntegerQuantity, optional

♦ month

IntegerQuantity, optional

♦ day

IntegerQuantity, optional

♦ hour

IntegerQuantity, optional

♦ minute

IntegerQuantity, optional

♦ second

RealQuantity, optional

class OriginUncertainty(**kwargs)

Undocumented.

♦ horizontal_uncertainty

float, optional

♦ min_horizontal_uncertainty

float, optional

♦ max_horizontal_uncertainty

float, optional

♦ azimuth_max_horizontal_uncertainty

float, optional

♦ confidence_ellipsoid

ConfidenceEllipsoid, optional

♦ preferred_description

builtins.str (OriginUncertaintyDescription), optional

♦ confidence_level

float, optional

class ResourceReferenceOptional(dummy) → str

Undocumented.

class CreationInfo(**kwargs)

Undocumented.

♦ agency_id

builtins.str (AgencyID), optional

♦ agency_uri

builtins.str (ResourceReference), optional

♦ author

builtins.str (Author), optional

♦ author_uri

builtins.str (ResourceReference), optional

♦ creation_time

builtins.float (pyrocko.guts.Timestamp), optional

♦ version

builtins.str (Version), optional

class StationMagnitudeContribution(**kwargs)

Undocumented.

♦ station_magnitude_id

builtins.str (ResourceReference)

♦ residual

float, optional

♦ weight

float, optional

class PrincipalAxes(**kwargs)

Undocumented.

♦ t_axis

Axis

♦ p_axis

Axis

♦ n_axis

Axis, optional

class NodalPlanes(**kwargs)

Undocumented.

♦ preferred_plane

int, optional

♦ nodal_plane1

NodalPlane, optional

♦ nodal_plane2

NodalPlane, optional

class WaveformStreamID(**kwargs)

Undocumented.

♦ value

builtins.str (ResourceReferenceOptional)

♦ network_code

builtins.str (AnonymousNetworkCode)

♦ station_code

builtins.str (AnonymousStationCode)

♦ channel_code

builtins.str (AnonymousChannelCode), optional

♦ location_code

builtins.str (AnonymousLocationCode), optional

class Comment(**kwargs)

Undocumented.

♦ id

builtins.str (ResourceReference), optional

♦ text

str

♦ creation_info

CreationInfo, optional

class MomentTensor(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ data_used_list

list of DataUsed objects, default: []

♦ comment_list

list of Comment objects, default: []

♦ derived_origin_id

builtins.str (ResourceReference), optional

♦ moment_magnitude_id

builtins.str (ResourceReference), optional

♦ scalar_moment

RealQuantity, optional

♦ tensor

Tensor, optional

♦ variance

float, optional

♦ variance_reduction

float, optional

♦ double_couple

float, optional

♦ clvd

float, optional

♦ iso

float, optional

♦ greens_function_id

builtins.str (ResourceReference), optional

♦ filter_id

builtins.str (ResourceReference), optional

♦ source_time_function

SourceTimeFunction, optional

♦ method_id

builtins.str (ResourceReference), optional

♦ category

builtins.str (MomentTensorCategory), optional

♦ inversion_type

builtins.str (MTInversionType), optional

♦ creation_info

CreationInfo, optional

class Amplitude(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ comment_list

list of Comment objects, default: []

♦ generic_amplitude

RealQuantity

♦ type

builtins.str (Type), optional

♦ category

builtins.str (AmplitudeCategory), optional

♦ unit

builtins.str (AmplitudeUnit), optional

♦ method_id

builtins.str (ResourceReference), optional

♦ period

RealQuantity, optional

♦ snr

float, optional

♦ time_window

TimeWindow, optional

♦ pick_id

builtins.str (ResourceReference), optional

♦ waveform_id

WaveformStreamID, optional

♦ filter_id

builtins.str (ResourceReference), optional

♦ scaling_time

TimeQuantity, optional

♦ magnitude_hint

builtins.str (MagnitudeHint), optional

♦ evaluation_mode

builtins.str (EvaluationMode), optional

♦ evaluation_status

builtins.str (EvaluationStatus), optional

♦ creation_info

CreationInfo, optional

class Magnitude(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ comment_list

list of Comment objects, default: []

♦ station_magnitude_contribution_list

list of StationMagnitudeContribution objects, default: []

♦ mag

RealQuantity

♦ type

builtins.str (Type), optional

♦ origin_id

builtins.str (ResourceReference), optional

♦ method_id

builtins.str (ResourceReference), optional

♦ station_count

int, optional

♦ azimuthal_gap

float, optional

♦ evaluation_mode

builtins.str (EvaluationMode), optional

♦ evaluation_status

builtins.str (EvaluationStatus), optional

♦ creation_info

CreationInfo, optional

class StationMagnitude(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ comment_list

list of Comment objects, default: []

♦ origin_id

builtins.str (ResourceReference), optional

♦ mag

RealQuantity

♦ type

builtins.str (Type), optional

♦ amplitude_id

builtins.str (ResourceReference), optional

♦ method_id

builtins.str (ResourceReference), optional

♦ waveform_id

WaveformStreamID, optional

♦ creation_info

CreationInfo, optional

class Arrival(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ comment_list

list of Comment objects, default: []

♦ pick_id

builtins.str (ResourceReference)

♦ phase

Phase

♦ time_correction

float, optional

♦ azimuth

float, optional

♦ distance

float, optional

♦ takeoff_angle

RealQuantity, optional

♦ time_residual

float, optional

♦ horizontal_slowness_residual

float, optional

♦ backazimuth_residual

float, optional

♦ time_weight

float, optional

♦ time_used

int, optional

♦ horizontal_slowness_weight

float, optional

♦ backazimuth_weight

float, optional

♦ earth_model_id

builtins.str (ResourceReference), optional

♦ creation_info

CreationInfo, optional

class Pick(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ comment_list

list of Comment objects, default: []

♦ time

TimeQuantity

♦ waveform_id

WaveformStreamID

♦ filter_id

builtins.str (ResourceReference), optional

♦ method_id

builtins.str (ResourceReference), optional

♦ horizontal_slowness

RealQuantity, optional

♦ backazimuth

RealQuantity, optional

♦ slowness_method_id

builtins.str (ResourceReference), optional

♦ onset

builtins.str (PickOnset), optional

♦ phase_hint

Phase, optional

♦ polarity

builtins.str (PickPolarity), optional

♦ evaluation_mode

builtins.str (EvaluationMode), optional

♦ evaluation_status

builtins.str (EvaluationStatus), optional

♦ creation_info

CreationInfo, optional

class FocalMechanism(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ waveform_id_list

list of WaveformStreamID objects, default: []

♦ comment_list

list of Comment objects, default: []

♦ moment_tensor_list

list of MomentTensor objects, default: []

♦ triggering_origin_id

builtins.str (ResourceReference), optional

♦ nodal_planes

NodalPlanes, optional

♦ principal_axes

PrincipalAxes, optional

♦ azimuthal_gap

float, optional

♦ station_polarity_count

int, optional

♦ misfit

float, optional

♦ station_distribution_ratio

float, optional

♦ method_id

builtins.str (ResourceReference), optional

♦ evaluation_mode

builtins.str (EvaluationMode), optional

♦ evaluation_status

builtins.str (EvaluationStatus), optional

♦ creation_info

CreationInfo, optional

class Origin(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ composite_time_list

list of CompositeTime objects, default: []

♦ comment_list

list of Comment objects, default: []

♦ origin_uncertainty_list

list of OriginUncertainty objects, default: []

♦ arrival_list

list of Arrival objects, default: []

♦ time

TimeQuantity

♦ longitude

RealQuantity

♦ latitude

RealQuantity

♦ depth

RealQuantity, optional

♦ depth_type

builtins.str (OriginDepthType), optional

♦ time_fixed

bool, optional

♦ epicenter_fixed

bool, optional

♦ reference_system_id

builtins.str (ResourceReference), optional

♦ method_id

builtins.str (ResourceReference), optional

♦ earth_model_id

builtins.str (ResourceReference), optional

♦ quality

OriginQuality, optional

♦ type

builtins.str (OriginType), optional

♦ region

builtins.str (Region), optional

♦ evaluation_mode

builtins.str (EvaluationMode), optional

♦ evaluation_status

builtins.str (EvaluationStatus), optional

♦ creation_info

CreationInfo, optional

class Event(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ description_list

list of EventDescription objects, default: []

♦ comment_list

list of Comment objects, default: []

♦ focal_mechanism_list

list of FocalMechanism objects, default: []

♦ amplitude_list

list of Amplitude objects, default: []

♦ magnitude_list

list of Magnitude objects, default: []

♦ station_magnitude_list

list of StationMagnitude objects, default: []

♦ origin_list

list of Origin objects, default: []

♦ pick_list

list of Pick objects, default: []

♦ preferred_origin_id

builtins.str (ResourceReference), optional

♦ preferred_magnitude_id

builtins.str (ResourceReference), optional

♦ preferred_focal_mechanism_id

builtins.str (ResourceReference), optional

♦ type

builtins.str (EventType), optional

♦ type_certainty

builtins.str (EventTypeCertainty), optional

♦ creation_info

CreationInfo, optional

♦ region

builtins.str (Region), optional

get_pyrocko_event()

Convert into Pyrocko event object.

Uses preferred origin, magnitude, and moment tensor. If no preferred item is specified, it picks the first from the list and emits a warning.

class EventParameters(**kwargs)

Undocumented.

♦ public_id

builtins.str (ResourceReference)

♦ comment_list

list of Comment objects, default: []

♦ event_list

list of Event objects, default: []

♦ description

str, optional

♦ creation_info

CreationInfo, optional

class QuakeML(**kwargs)

Undocumented.

♦ event_parameters

EventParameters, optional

get_pyrocko_events()

Extract a list of pyrocko.model.Event instances