pyrocko.scenario.scenario

Implementation of the scenario generator’s main class.

Classes

ScenarioGenerator(**kwargs)

Generator for synthetic seismo-geodetic scenarios.

class ScenarioGenerator(**kwargs)

Bases: LocationGenerator

Generator for synthetic seismo-geodetic scenarios.

♦ target_generators

list of pyrocko.scenario.targets.base.TargetGenerator objects, default: []

Targets to spawn in the scenario.

♦ source_generator

pyrocko.scenario.sources.base.SourceGenerator, default: DCSourceGenerator()

Sources to spawn in the scenario.

dump_data(path, overwrite=False)

Invoke generators and dump the complete scenario.

Parameters:

• path (str) – Output directory

• overwrite (bool) – If True remove all previously generated files and recreating the scenario content. If False stop if previously generated content is found.

Wrapper to call prepare_data() followed by ensure_data() with default arguments.

prepare_data(path, overwrite)

Prepare directory for scenario content storage.

Parameters:

• path (str) – Output directory

• overwrite (bool) – If True, remove all previously generated files and recreate the scenario content. If False, stop if previously generated content is found.

ensure_data(path, tmin=None, tmax=None)

Generate and output scenario content to files, as needed.

Parameters:

• path (str) – Output directory

• tmin (get_time_float()) – Start of time interval to generate

• tmax (get_time_float()) – End of time interval to generate

This method only generates the files which are relevant for the given time interval, and which have not yet been generated. It is safe to call this method several times, for different time windows, as needed.

If no time interval is given, the origin times of the generated sources and signal propagation times are taken into account to estimate a reasonable default.

classmethod initialize(path, center_lat=None, center_lon=None, radius=None, targets=[<class 'pyrocko.scenario.targets.waveform.WaveformGenerator'>, <class 'pyrocko.scenario.targets.insar.InSARGenerator'>, <class 'pyrocko.scenario.targets.gnss_campaign.GNSSCampaignGenerator'>], stationxml=None, force=False)

Initialize a Scenario and create a scenario.yml

Parameters:

• path (str) – Path to create the scenerio in

• center_lat (float) – Center latitude [deg]

• center_lon (float) – Center longitude [deg]

• radius (float) – Scenario’s radius in [m]

• targets (list of pyrocko.scenario.targets.base.TargetGenerator objects) – Targets to throw into scenario, defaults to AVAILABLE_TARGETS

• force (bool) – If set to True, overwrite directory

• stationxml (str) – path to a StationXML to be used by the pyrocko.scenario.targets.waveform.WaveformGenerator.

Returns:

Scenario

Return type:

pyrocko.scenario.scenario.ScenarioGenerator