.. highlight:: rst .. _scmtv: ##### scmtv ##### **Moment tensor analysis user interface.** Description =========== |appvbin| is an interactive tool to generate, revise or review moment tensor solutions. Deviatoric or full 6-component moment tensors can be computed as well as the centroid depth. Inversion for the full moment tensor and different :ref:`decompositions ` can be selected interactively. The defaults are configurable. The automatic inversion for moment tensors is provided through :ref:`scautomt`. The inverson scheme of both tools is based on the publication by :cite:t:`minson-2008`. |appvbin| can be applied to optimize control parameters interactively and use these parameters as defaults or in :ref:`scautomt` for automatic moment tensor inversion. |appvbin| provides the following main GUI components. - :ref:`Main view ` - :ref:`Waveform editor ` - :ref:`Centroid depth table and plot ` - :ref:`3D Centroid search plot ` - :ref:`Inversion control parameters` for magnitude dependent profiles - :ref:`Solution stability analysis ` - :ref:`Data source, distance and time windows ` - :ref:`Custom script interface `, e.g. for report generation .. _scmttv-method: Methodology =========== The procedures for data processing and the inversion algorithm are set out in the sections :ref:`scautomt-event-processing` and :ref:`scautomt-data`. In |appvbin| the inversion control parameters can be set interactively by :ref:`changing the parameter profiles `. To apply the parameters at start up adjust :file:`scmtv.cfg` or configure the parameters through :program:`scconfig`. |appvbin| provides additional :ref:`options` for flexible time windows and for dumping of data and results from centroid-depth search. See the documentation of |appbin| for further information on: - :ref:`Waveform Data` (sampling rate, time windows) - :ref:`Green's functions ` (formats, data structure) - :ref:`Considered wavetypes ` - :ref:`Data time windows ` - :ref:`Algorithms ` and inversion for deviatoric and full moment tensors - :ref:`Moment-tensor decomposition `. A video how to use the |appvbin| is available at :ref:`gempa YouTube channel`. .. _scmttv-data: Waveform data ============= As in :ref:`scautomt` waveform data are provided by the :term:`RecordStream` interface considering a configurable maximum epicentral distance (:confval:`automt.maximumDistance`). Data processing is explained in section :ref:`scautomt-algorithm`. .. _scmttv-gf: Green's functions ================= The waveform data are matched against Green's functions which are pre-computed. Read the sections on :ref:`Green's functions ` of |appname| for a description of accepted formats and the archive structures. |appvbin| Components ==================== .. _scmtv-main-view: Main view --------- The main perspective (Moment tensor tab) of |appvbin| is build up by 3 main elements, the map showing hypocenter including MT (upper left side), the overall information matrix (upper right side) and the component list at the bottom. With *F8* the event summary can be activated. Buttons in the lower right corner allow to generate a MT bulletin (similar to the USGS bulletin), open the interactive waveform review or commit the solution. .. _fig-scmtv-main: .. figure:: media/scmtv/main.png :width: 18cm :align: center Actions ~~~~~~~ Interactive actions are available in the main view: #. Load an event from the "Events" tab for viewing the parameters and for starting the inversion. #. Press "Waveforms" to load data and to open the :ref:`waveform editor ` for full control over the inversion. #. Press "Commit" to send the results to the |scname| messaging. Otherwise the results will be lost when selecting a new event or when closing |appvbin|. #. Press "Bulletin" to generate ascii art bulletins or to trigger :ref:`custom scripts `. .. _general_settings: Runtime configuration ~~~~~~~~~~~~~~~~~~~~~ Configuration of the data source, epicentral distances and inital time window for loading data can be overwritten during runtime of |appvbin|. Access these general settings though the settings menu or press the "F3" key. Here the user can change the parameters for data source, maximum station distance, time restitution, waveform time windows and extended logging. The values can be pre-set by :ref:`configuration `. .. _fig-scmtv-settings-general: .. figure:: media/scmtv/settings-general.png :width: 8cm :align: center The connection to the |scname| messaging system can also be accessed through the messaging system or by pressing "F2". .. _mtv_scripts: Custom scripts ~~~~~~~~~~~~~~ Custom scripts can be provided and configured to be applied when pressing the "Bulletin" button. More details are explained :ref:`below `. .. _scmtv-waveform-editor: Waveform editor --------------- The editor or waveform review perspective allows to analyze the waveforms and to interactively guide and improve the MT solution. The left side shows the beach ball for either the double couple or the full moment tensor. The color of the ball represents the overall fit (red=bad, green=good). The small squares next to the beach ball show the azimuthal distribution of the stations including their color coded fit. Below follows: * moment tensor matrix * Green's function selection * selected source depths * nodal plane information * derived values: Mw, DC, CLVD, ISO, station count, fit etc. .. _fig-scmtv-editor: .. figure:: media/scmtv/editor.png :width: 18cm :align: center The central block of the editor shows the observed filtered waveforms on the right side including the time windows used for the inversion of the different wave types (orange=body wave, green=surface waves etc.) The right side of the central block is comparing the filtered observed waveforms (black line) with the synthetic seismogram (red line) for each component and wave type. Below the wave snippets is information like azimuth, fit, time shift etc. shown. A detailed description is shown through a mouse over effect. The synthetic and observed waveforms can be either fitted manual by mouse or automatically by selecting the component and press either "b". Components can be deselected through a double click. Deviatoric and full moment tensors ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Either the deviatoric moment tensor or the full moment tensor can be computed. The default inversion type is controlled by the configuration parameter :confval:`automt.invertFor6Components`. Select the type interactively in the **Options** menu of the Waveform editor. .. _fig-scmtv-type: .. figure:: media/scmtv/6comp.png :width: 8cm :align: center Options menu providing the type selection. Inversion for deviatoric and full moment tensors require 8- and 10-component :ref:`Green's functions `, respectively. Read the section :ref:`Algorithm ` for the details. .. _scmtv-mt-decomposition: Moment tensor decomposition ~~~~~~~~~~~~~~~~~~~~~~~~~~~ From the moment tensor the DC, ISO and CLVD components are derived. The ISO is only computed when inverting for the full moment tensor. Different :ref:`decomposition methods ` are available. Select the method :ref:`interactively ` or by configuration :confval:`automt.MTDecomp100`. .. _scmtv-parameter-profiles: Parameter profiles ~~~~~~~~~~~~~~~~~~ |appvbin| works with pre-defined filter profiles containing the filters and other parameters. They can be selected in the combo box in the upper part of the central block. The profiles are separated into magnitude groups. The detailed settings for each profile can be changed in the phase settings. The selection of the filter is based on magnitude filter settings can be changed through the phase settings dialog. The dialog can be opened through the screw wrench button next to the profile. .. _fig-scmtv-settings-phases: .. figure:: media/scmtv/settings-phases.png :width: 12cm :align: center The colors represent the following wave types. .. _fig-scmtv-wave-types: .. figure:: media/scmtv/wavetypes.png :width: 3.25cm :align: center The right block of the editor shows the depth search and inversion settings. The depth search can be limited through a depth range and also the default refinement can be changed. Components can be added and removed by their fit, either manually or automatically after each iteration. .. _scmtv-centroid-depth: Centroid depth search ~~~~~~~~~~~~~~~~~~~~~ Centroid depth search can be controlled and activated in the depth search parameter window. .. _fig-scmtv-depth-plot: .. figure:: media/scmtv/depth-search-control.png :width: 8cm :align: center Centroid depth search parameter window. Once the depth search is started, the depth search widget appears showing the progress of the Centroid depth search. In the depth search widget the solutions can be viewed and the preferred depth can be interactively adjusted in the table of the *Data* tab or in the graphs from the *Plot* tab by left double click at the selected depth. The goodness is automatically determined based on the :ref:`fit `. .. _fig-scmtv-depth-control: .. figure:: media/scmtv/depth-search.png :width: 18cm :align: center Depth search widget with Data and Plot tab showing the results and the preferred Centroid depth. The *Data* and the *Plot* tabs show the same values at the given depth: * Mw: Moment magnitude * Fit: Waveform fit * DC: Double-couple percentage of the deviatoric moment tensor * CLVD: Modulus of the Compensated-Linear Vector Dipole percentage of the deviatoric moment tensor * ISO: Modulus of the isotropic percentage of the computed moment tensor * Quality: Product of Fit and relative number of stations * Stations: Number of stations used for the results The table columns can be sorted and the values can be activated or deactivated in the plot. .. _scmtv-centroid-3D: Centroid search in 3D ~~~~~~~~~~~~~~~~~~~~~ Centroid depth search can be controlled and started in the 3D Centroid search parameter window. .. _fig-scmtv-centroid-control: .. figure:: media/scmtv/centroid-search-control.png :width: 8cm :align: center 3D Centroid search parameter window. The 3D Centroid search widget shows the path of the Centroid search starting from coarse grid and ending a the grid with the smallest extend as defined by the the final 3D cell size. The refinement is done in steps where the cell size is reduced. The goodness is determined based on the :ref:`quality `. The location of the cell with the best quality for each step is indicated the by a black rectangle. The widget shows the solution from the top in a vertical perspective. When increasing the depth with the depth slider, the solutions for shallower depths are therefore hidden. Use the depth slider to navigate through depth. Transparency allows to view the results from greater depths. To only see the solutions at a particular depth, minimize the transparency by the transparency slider. As in the waveform editor, the color of the beach balls indicate their :ref:`fit `. The color of an area indicates the relative fit for the corresponding centroid grid point w.r.t. all grids of the particular refinement step. * Press *Cancel* to stop the search. * Press *OK* when the search is finished to accept the best solution with its location and to return to the waveform editor. .. _fig-scmtv-centroid-plot: .. figure:: media/scmtv/centroid-search.png :width: 12cm :align: center Centroid search widget showing the results from 3D Centroid search. .. _sec-scmtv-stability: Solution stability and statistics ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. _fig-scmtv-monte-carlo: .. figure:: media/scmtv/monte_carlo_inversion_plot.png :width: 8cm :align: center Monte-Carlo simulations. Right-click on the widget to change the view. To check the quality of the solution, inversions based on * Monte-Carlo simulations or * Single-station inversions can be performed. The resulting graphs show the P- and T-axes of each individual inversion.. Monte-Carlo inversions take by default 100 subsets of stations with a station count between 4 and the maximum count of stations. The more the P- and T-axas of the 100 solutions cluster the better ist the solution. Select the Monte-Carlo or the Single-station inversion interactively in the **Inversions** menu of the Waveform editor. Dumping waveforms ~~~~~~~~~~~~~~~~~ MiniSEED data for a particular station can be stored in a file by right-clicking on a trace in the phase view (right waveform window) of the waveform editor. Selecting *Export traces as miniSEED* with create the miniSEED file in the home directory. .. figure:: media/scmtv/editor-export-miniseed.png :width: 10cm :align: center Interactive export of waveforms from waveform editor. Hotkeys ------- Hotkey are alternatives to selecting actions by mouse click. Using hotkeys may speed up procedures. The table below describes some available key combinations and their triggered actions. .. csv-table:: :widths: 20 80 :header: Hot key, Action :align: left **Main View** F1 , Open |scname| documentation F2 , Open a dialog to adjust the connection to the messaging and the database F3 , "Adjust the data source, time window parameters, extended Log" F8 , Activate/deactivate the summary view F10 , Show Events Shift+F1 , Open |appvbin| documentation **Waveform Editor** escape , Deselect all selected station / Clear selection a , Activate selected phases x , Deactivate selected phases del , Delete selected stations from data set permanently b , Best local fit for all selected phases c , Cross-correlate f , Toggle filtered/raw waveform data p , Alig by pick time r , Reset time correction (zcorr) of all selected phases s , Find best solution for current dataset ctrl+a , Select all stations ctrl+d , Use displacement ctrl+i , Invert phase selection ctrl+q , Close window ctrl+left , Increase time scale of waveform data ctrl+right , Decrease time scale of waveform data ctrl+up , Increase row height ctrl+down , Decrease row height ctrl+shift+d , Show/hide depth search control window ctrl+shift+t , Show/hide inversion control window ctrl+shift+s , Show/hide centroid search control window ctrl+shift+w , Show/hide wave snippets control window .. _sec-mtv-custom-scripts: Custom Scripts ============== Custom scripts can be generated and executed. E.g. user-defined actions such as report generation can be triggered by setting :confval:`mtv.extendedLog.enable`: to *enabled*. When setting :confval:`mtv.extendedLog.enable`: to *enabled* the Python script provided in :confval:`mtv.extendedLog.script` is available in the main window of |appvbin|. It is executed when hitting the button *Bulletin*. .. _sec-mtv-report: Report generation ----------------- The moment tensor package provides an example Python script, :file:`@DATADIR@/mtv/tools/mtv-plot-extended-log.py`, and an example LaTeX template file, :file:`@DATADIR@/mtv/tools/mtv-plot-extended-log.tex`, for generating PNG images and a report in PDF format. Both files are located in .. code-block:: sh $SEISCOMP_ROOT/share/mtv/tools/ The location of the Python script can be configured by adjusting :confval:`mtv.extendedLog.script`. The provided default Python script and the LaTeX template are meant to be examples which can be adjusted. There is no guarantee that it works on any system as it depends on the local LateX and Python installations. The Python script generates a PDF file based on the PNG images and the LaTeX template file. When applying any change to the files, remember to copy the files and to provide the new file location to your script :confval:`mtv.extendedLog.script`. Otherwise the files will be overwritten when calling the script from |appvbin| and any changes will be lost. .. _sec-mtv-report-files: Generated files ~~~~~~~~~~~~~~~ The default report generator will generate PNG image files and the report in LaTeX format. The LaTeX file is compiled to generate the PDF file containing the report. The files are located in the *report* directory which is a subdirectory of :confval:`mtv.extendedLog.path`. Read the debug output of |appvbin| which contains the names of the generated files. In order to see what PNG and LaTeX files are generated, start |appvbin| with debug output, e.g. .. code-block:: sh scmtv --debug The debug output also shows the commands for executing the Python script and for compiling the LaTeX file manually. Execute these commands for troubleshooting. .. _sec-mtv-report-requirements: Software requirements ~~~~~~~~~~~~~~~~~~~~~ The default report generator requires additional software packages as described in section :ref:`sec-mt-install`. .. _sec-mtv-report-troubleshooting: Troubleshooting ~~~~~~~~~~~~~~~ The default python script configured in :confval:`mtv.extendedLog.script` creates PNG image files showing data and results and the PDF file containing the report. The script seeks compile the generated LaTeX file to generate the PDF. It also opens and shows the PDF file by choosing the default application defined by the local system. If the PDF file is not opened automatically, check your system settings and select the default document viewer for PDF files. The name and the location of the created PNG and PDF files are printed to the debug output of |appvbin|. The debug output also provides the command lines for executing the Python script and the for compiling the LaTeX file. The commands can be executed separately for troubleshooting. .. _mtv-startup_settings: Initial Configuration ===================== The control parameters of |appvbin| can be set and modified in the configuration file :file:`scmtv.cfg` or through :program:`scconfig`. The settings concern e.g.: - **Data source:** * :confval:`recordstream`: Choose the source of the waveform data by configuring the :term:`RecordStream` interface. By default, the provided Green's functions are sampled at 1 Hz intervals. If 1 Hz Green's functions are used, we recommend to use the *dec* or the *resample* RecordStream implementations to decimate or resample the data to 1 Hz or another sample rate. Downsampling the data may significantly speed up the data processing. It is in particular relevant when computing centroid moment tensors. .. hint:: In previous versions of *SeisComP3* the *dec* was occasionally skipping records resulting in incomplete data set. The issue has been fixed with the SeisComP3 in version jakarta-2018.324.p23 and with SeisComP in version 4.0. Therefore, we recommend not to use older releases of SeisComP3. * **Green's functions:** * Generate and configure as set out in the section :ref:`scautomt-gf`. * **Time windows:** * :confval:`automt.data.maxDistanceTimeWindows`: time windows from P-wave onset for extracting data and Green's functions based on distances (linear interpolartion in between). * Add :confval:`automt.data.safetyMargin`, :confval:`automt.data.leftNoiseLength`, :confval:`automt.data.leftNoiseMaxLength` and :confval:`automt.data.rightNoiseLength` to account for travel-time uncertainties and artifacts from data processing at the edges of the windowed data, e.g. filtering. * **Profiles:** * :confval:`automt.profiles.$name.name`: Define the parameters of the magnitude-dependent inversion profiles, * :confval:`automt.profiles`: Register the defined inversion profiles. * **Extended logging:** * :confval:`mtv.extendedLog.enable`: Activate to enable extended logging for writing time-windowed data and Green's functions and results from centroid-depth search to file. When this option is enabled a user-defined script may be provided by :confval:`mtv.extendedLog.script`. * :confval:`mtv.extendedLog.script`: Set the full path to the custom script. The default script allows to :ref:`generate reports ` in PDF format. Module Configuration ==================== | :file:`etc/defaults/global.cfg` | :file:`etc/defaults/scmtv.cfg` | :file:`etc/global.cfg` | :file:`etc/scmtv.cfg` | :file:`~/.seiscomp/global.cfg` | :file:`~/.seiscomp/scmtv.cfg` scmtv inherits :ref:`global options`. .. note:: Modules/plugins may require a license file. The default path to license files is :file:`@DATADIR@/licenses/` which can be overridden by global configuration of the parameter :confval:`gempa.licensePath`. Example: :: gempa.licensePath = @CONFIGDIR@/licenses .. confval:: gfaUrls Default: ``sc3gf1d:///home/data/greensfunctions`` Type: *list:string* A list of Greens function URLs which can be selected in the GUI. Examples: sc3gf1d:\/\/\/home\/data\/greensfunctions for recommended format, helmberger:\/\/\/home\/data\/greensfunctions for Helmberger format. See the documentation of scautomt for a description of the formats. .. confval:: visibleMagnitudes Default: ``M,ML,MLv,MLc,mb,mB,Mwp,Mjma,Ms_20,Ms(BB)`` Type: *list:string* A list of magnitude types to be displayed in the summary widget \(F8\). .. _mtv: .. confval:: mtv.autoInvert Default: ``true`` Type: *boolean* Whether automatic inversion is enable or not. If enabled then each modification if the dataset will trigger an MT inversion and update the beachball. .. _mtv.depthSearch: .. note:: **mtv.depthSearch.\*** *Parameters for pre-setting the depth search window. The* *parameter "depthSearchGrid" and* *"depthFineSearchIncrements" are configured in the* *"automt" section.* .. confval:: mtv.depthSearch.keepCurrentDataSet Default: ``false`` Type: *boolean* If enabled only the current dataset is used. No components are activated or deactivated for each depth. .. confval:: mtv.depthSearch.shiftTraces Default: ``true`` Type: *boolean* If enabled trace\/component time shifts are allowed during inversion. .. confval:: mtv.depthSearch.optimizeResult Default: ``false`` Type: *boolean* If enabled at each depth a full optimization run is done which can remove traces\/components that fall below the minimum fit. This can lead to different stations sets for each depth. .. confval:: mtv.depthSearch.minDepth Unit: *km* Type: *double* Sets the minimum depth of the depth search. If this value is not specified or lower than the minimum depths supported by the Green's functions then Green's functions minimum depth is used instead. .. confval:: mtv.depthSearch.maxDepth Unit: *km* Type: *double* Sets the maximum depth of the depth search. If this value is not specified or larger than the maximum depths supported by the Green's functions then Green's functions maximum depth is used instead. .. confval:: mtv.depthSearch.runAfterDataSelection Default: ``false`` Type: *boolean* Run the depth search automatically after each data selection run \(shortcut 's'\). .. _mtv.extendedLog: .. note:: **mtv.extendedLog.\*** *The extended log creates additional log files when a solution* *is committed from the waveform analysis window to the main window.* *Those files are: waveform data (synthetics and real), depth search* *result and an event XML file containing the current event as* *well as the moment tensor solution.* .. confval:: mtv.extendedLog.enable Default: ``false`` Type: *boolean* Enables the extended log. .. confval:: mtv.extendedLog.path Default: ``@LOGDIR@/MT/ext`` Type: *directory* Configures the output path for the extended log. For each solution a subdirectory is created named after the publicID of the focal mechanism. .. confval:: mtv.extendedLog.script Type: *file* Configures a script that is called when the Extended Log button is pressed. scmtv will pass the extendedLog.path to this particular script. The script is then responsible for creating and displaying the bulletin as well as removing the sub\-directory. .. _mtv.whitelist: .. confval:: mtv.whitelist.stations Type: *list:string* Whitelist of stations to be used in the processing. Each item is of format [net].[sta] where net or sta can be an asterisk used as wildcard. .. confval:: mtv.whitelist.channels Type: *list:string* Whitelist of channels to be used in the processing. Each item is of format [loc].[cha] where loc or cha can be an asterisk used as wildcard. Note that only the first two characters of the channel code are used for comparison, e.g. BH instead of BHZ. .. _mtv.blacklist: .. confval:: mtv.blacklist.stations Type: *list:string* Blacklist of stations to be ignored in the processing. Each item is of format [net].[sta] where net or sta can be an asterisk used as wildcard. .. confval:: mtv.blacklist.channels Type: *list:string* Blacklist of channels to be ignored in the processing. Each item is of format [loc].[cha] where loc or cha can be an asterisk used as wildcard. Note that only the first two characters of the channel code are used for comparison, e.g. BH instead of BHZ. .. _automt: .. note:: **automt.\*** *The automt parameters can be optimzed in scmtv and directly used* *in scautomt.* .. confval:: automt.enableResponses Default: ``true`` Type: *boolean* Uses sensor response to deconvolve data. .. confval:: automt.invertFor6Components Default: ``false`` Type: *boolean* Whether to invert for 6 components or 5 components. 6 component inversion support requires API version 13 or above and that all 10 Green's function components are available in the used Green's function data set. The option is thus ignored with SeisComP3 in version Jakarta 2018.327 and older. .. confval:: automt.MTDecomp100 Default: ``false`` Type: *boolean* Apply the decomposition according to Knopoff and Randall, 1970: 100 \= \|ISO\| + \|DC\| + \|CLVD\|. When not inverting for the full 6\-component moment tensor, only ISO and DC are calculated. Default: decomposition according to Silver and Jordan \(1982\). .. confval:: automt.GOF Default: ``internal`` Type: *string* Values: ``internal,varred`` Defines the goodness of fit function to be used. Allowed values are: \"internal\" and \"varred\". .. confval:: automt.IWT Default: ``rms**2`` Type: *string* Values: ``rms**2,rms`` Defines the type of weight computed per inversion item. This weight will affect the individual influence on the final inversion. Allowed values are: rms\*\*2 \(Default type which seems to overweight sometimes stations which are very close\), rms \(Alternative type which is less sensitive to larger amplitudes, e.g. with close stations\). .. confval:: automt.maximumDistance Default: ``70`` Unit: *deg* Type: *double* Maximum distance of stations to be used. .. confval:: automt.depthSearchGrid Default: ``100:20, 200:30, 400:50, 100`` Unit: *km:km* Type: *string* The initial depth search grid. A list of tokens in format [depth]:[interval]. The first token creates a grid from 0 to [depth] with spacing [km]. Any succeeding token creates a grid from the previous token with spacing [km]. If the depth is left out then it is valid until the maximum depth of the Greens functions. .. confval:: automt.depthFineSearchIncrements Default: ``50, 10, 5, 1`` Unit: *km* Type: *list:double* The depth search intervals. All intervals are processed subsequently. The predecessor and successor of the best fitting depth are used as a new interval for the next search with a finer increment. .. confval:: automt.profiles Type: *list:string* Enabled profiles. .. _automt.data: .. note:: **automt.data.\*** *Parameters controlling the time windowing of data and* *Green's functions.* .. confval:: automt.data.maxDistanceTimeWindows Default: ``0.0:80,1.8:100,18.4:832.5,36.4:1617.0,54.49:2392.5,72.4:3164,90.4:3953,108.4:4720,126.4:5506.5,144.4:6234.5,162.4:7011,184.5:8000`` Unit: *km:sec* Type: *list:string* Distance\-dependent signal length for loading data and Green's functions starting from P onset \(distance:window length\). Uses default values if empty. Supports also arithmetic expressions can be used, e.g. P+D\*15 and constants, e.g. 100. .. confval:: automt.data.leftNoiseLength Default: ``600`` Unit: *s* Type: *int* How many seconds of data to use before the signal to stabilize deconvolution and so on. .. confval:: automt.data.leftNoiseMaxLength Default: ``600`` Unit: *s* Type: *int* How many maximum seconds of data to use before the signal to stabilize deconvolution and so on. .. confval:: automt.data.rightNoiseLength Default: ``0`` Unit: *s* Type: *int* How many seconds of data after the signal to use and to fetch. .. confval:: automt.data.safetyMargin Default: ``120`` Unit: *s* Type: *int* Safety margin around the signal to shift the traces at different depth and distances. .. _automt.settings: .. note:: **automt.settings.\*** *Global phase settings. The following parameters are used* *if not defined in a profile.* .. confval:: automt.settings.wZ Default: ``1.0`` Type: *double* Default vertical component weight. .. confval:: automt.settings.wR Default: ``0.25`` Type: *double* Default radial component weight. .. confval:: automt.settings.wT Default: ``0.5`` Type: *double* Default tangential component weight. .. _automt.settings.minSNR: .. confval:: automt.settings.minSNR.body Default: ``3`` Type: *double* The minimum SNR of a body wave signal. .. confval:: automt.settings.minSNR.surface Default: ``2`` Type: *double* The minimum SNR of a surface wave signal. .. confval:: automt.settings.minSNR.mantle Default: ``2`` Type: *double* The minimum SNR of a mantle wave signal. .. confval:: automt.settings.minSNR.w-phase Default: ``2`` Type: *double* The minimum SNR of a W\-phase signal. .. confval:: automt.settings.minSNR.full Default: ``3`` Type: *double* The minimum SNR of the full signal. .. _automt.settings.maxShift: .. confval:: automt.settings.maxShift.body Default: ``10`` Unit: *s* Type: *double* The maximum time shift of a body wave signal. .. confval:: automt.settings.maxShift.surface Default: ``30`` Unit: *s* Type: *double* The maximum time shift of a surface wave signal. .. confval:: automt.settings.maxShift.mantle Default: ``45`` Unit: *s* Type: *double* The maximum time shift of a mantle wave signal. .. confval:: automt.settings.maxShift.w-phase Default: ``60`` Unit: *s* Type: *double* The maximum time shift of a W\-phase signal. .. confval:: automt.settings.maxShift.full Default: ``30`` Unit: *s* Type: *double* The maximum time shift of the full signal. .. _automt.profiles: .. note:: **automt.profiles.\*** *Processing profiles that can be selected in automt.profiles.* .. _automt.profiles.$name: .. note:: **automt.profiles.$name.\*** *Defines a processing profile for a certain magnitude* *range.* $name is a placeholder for the name to be used and needs to be added to :confval:`automt.profiles` to become active. .. code-block:: sh automt.profiles = a,b automt.profiles.a.value1 = ... automt.profiles.b.value1 = ... # c is not active because it has not been added # to the list of automt.profiles automt.profiles.c.value1 = ... .. confval:: automt.profiles.$name.name Type: *string* A profile name \(Model\) shown and selected in the GUI. .. confval:: automt.profiles.$name.method Type: *string* A string with a method that will be used to populate the MomentTensor.methodID attribute. .. confval:: automt.profiles.$name.magnitudes Type: *string* Defines the magnitude range this profile is valid for. Format: min;max whereas INF and \-INF is supported to define open boundaries. .. confval:: automt.profiles.$name.minItemFit Unit: *%* Type: *int* The minimum item fit in percent. .. confval:: automt.profiles.$name.maxShift Unit: *s* Type: *double* The maximum time shift of the complete waveform set accounting for differences in centroid time wrt. source time. .. confval:: automt.profiles.$name.shiftStep Default: ``1`` Unit: *s* Type: *double* Time steps to shift the complete waveform set. Limited by maxShift. .. confval:: automt.profiles.$name.minDist Default: ``0`` Unit: *deg* Type: *double* The minimum epicentral distance of a station to be included in the processing. If \"auto\" is specified then the minimum distance will be computed to be at least a single wavelength according to the configured filter periods. .. _automt.profiles.$name.minSNR: .. confval:: automt.profiles.$name.minSNR.body Type: *double* The minimum SNR of a body wave signal. .. confval:: automt.profiles.$name.minSNR.surface Type: *double* The minimum SNR of a surface wave signal. .. confval:: automt.profiles.$name.minSNR.mantle Type: *double* The maximum time shift of a mantle wave signal. .. confval:: automt.profiles.$name.minSNR.w-phase Type: *double* The minimum SNR of a w\-phase wave signal. .. confval:: automt.profiles.$name.minSNR.full Type: *double* The minimum SNR of a full wave signal. .. _automt.profiles.$name.minSNR.body: .. confval:: automt.profiles.$name.minSNR.body.P Type: *double* The minimum SNR of a P wave signal. .. confval:: automt.profiles.$name.minSNR.body.S Type: *double* The minimum SNR of an S wave signal. .. _automt.profiles.$name.minSNR.surface: .. confval:: automt.profiles.$name.minSNR.surface.R Type: *double* The minimum SNR of a Rayleigh wave signal. .. confval:: automt.profiles.$name.minSNR.surface.L Type: *double* The minimum SNR of a Love wave signal. .. _automt.profiles.$name.minSNR.mantle: .. confval:: automt.profiles.$name.minSNR.mantle.RM Type: *double* The minimum SNR of a Rayleigh mantle wave signal. .. confval:: automt.profiles.$name.minSNR.mantle.LM Type: *double* The minimum SNR of a Love mantle wave signal. .. _automt.profiles.$name.maxShift: .. confval:: automt.profiles.$name.maxShift.body Unit: *s* Type: *double* The maximum time shift of a body wave signal. .. confval:: automt.profiles.$name.maxShift.surface Unit: *s* Type: *double* The maximum time shift of a surface wave signal. .. confval:: automt.profiles.$name.maxShift.mantle Unit: *s* Type: *double* The maximum time shift of a mantle wave signal. .. confval:: automt.profiles.$name.maxShift.w-phase Unit: *s* Type: *double* The maximum time shift of a W\-phase signal. .. confval:: automt.profiles.$name.maxShift.full Unit: *s* Type: *double* The maximum time shift of a W\-phase signal. .. _automt.profiles.$name.maxShift.body: .. confval:: automt.profiles.$name.maxShift.body.P Unit: *s* Type: *double* The maximum time shift of a P wave signal. .. confval:: automt.profiles.$name.maxShift.body.S Unit: *s* Type: *double* The maximum time shift of a S wave signal. .. _automt.profiles.$name.maxShift.surface: .. confval:: automt.profiles.$name.maxShift.surface.R Unit: *s* Type: *double* The maximum time shift of a Rayleigh wave signal. .. confval:: automt.profiles.$name.maxShift.surface.L Unit: *s* Type: *double* The maximum time shift of a Love wave signal. .. _automt.profiles.$name.maxShift.mantle: .. confval:: automt.profiles.$name.maxShift.mantle.RM Unit: *s* Type: *double* The maximum time shift of a Rayleigh mantle wave signal. .. confval:: automt.profiles.$name.maxShift.mantle.LM Unit: *s* Type: *double* The maximum time shift of a Love mantle wave signal. .. _automt.profiles.$name.wZ: .. confval:: automt.profiles.$name.wZ.body Type: *double* Vertical component weight of a body wave. .. confval:: automt.profiles.$name.wZ.surface Type: *double* Vertical component weight of a surface wave. .. confval:: automt.profiles.$name.wZ.mantle Type: *double* Vertical component weight of a mantle wave. .. confval:: automt.profiles.$name.wZ.w-phase Type: *double* Vertical component weight of a W\-phase. .. confval:: automt.profiles.$name.wZ.full Type: *double* Vertical component weight of a full wave. .. _automt.profiles.$name.wZ.body: .. confval:: automt.profiles.$name.wZ.body.P Type: *double* Vertical component weight of a P wave. .. _automt.profiles.$name.wZ.surface: .. confval:: automt.profiles.$name.wZ.surface.R Type: *double* Vertical component weight of a Rayleigh wave. .. _automt.profiles.$name.wZ.mantle: .. confval:: automt.profiles.$name.wZ.mantle.RM Type: *double* Vertical component weight of a Rayleigh mantle wave. .. _automt.profiles.$name.wR: .. confval:: automt.profiles.$name.wR.body Type: *double* Radial component weight of a body wave. .. confval:: automt.profiles.$name.wR.surface Type: *double* Radial component weight of a surface wave. .. confval:: automt.profiles.$name.wR.mantle Type: *double* Radial component weight of a mantle wave. .. confval:: automt.profiles.$name.wR.w-phase Type: *double* Radial component weight of a W\-phase. .. confval:: automt.profiles.$name.wR.full Type: *double* Radial component weight of a full wave. .. _automt.profiles.$name.wR.body: .. confval:: automt.profiles.$name.wR.body.S Type: *double* Radial component weight of an S wave. .. _automt.profiles.$name.wR.surface: .. confval:: automt.profiles.$name.wR.surface.R Type: *double* Radial component weight of a Rayleigh wave. .. _automt.profiles.$name.wR.mantle: .. confval:: automt.profiles.$name.wR.mantle.RM Type: *double* Radial component weight of a Rayleigh mantle wave. .. _automt.profiles.$name.wT: .. confval:: automt.profiles.$name.wT.body Type: *double* Tangential component weight of a body wave. .. confval:: automt.profiles.$name.wT.surface Type: *double* Tangential component weight of a surface wave. .. confval:: automt.profiles.$name.wT.mantle Type: *double* Tangential component weight of a mantle wave. .. confval:: automt.profiles.$name.wT.w-phase Type: *double* Tangential component weight of a W\-phase. .. confval:: automt.profiles.$name.wT.full Type: *double* Tangential component weight of a full wave. .. _automt.profiles.$name.wT.body: .. confval:: automt.profiles.$name.wT.body.S Type: *double* Tangential component weight of an S wave. .. _automt.profiles.$name.wT.surface: .. confval:: automt.profiles.$name.wT.surface.L Type: *double* Tangential component weight of a Love wave. .. _automt.profiles.$name.wT.mantle: .. confval:: automt.profiles.$name.wT.mantle.LM Type: *double* Tangential component weight of a Love mantle wave. .. _automt.profiles.$name.wNormalize: .. note:: **automt.profiles.$name.wNormalize.\*** *Defines whether the configured weights are normalized* *among all waveforms of a station of the same type. Normalization* *is done by dividing the weight by square root of the noise RMS times 1000:* *sqrt(rms*1000).* .. confval:: automt.profiles.$name.wNormalize.body Default: ``true`` Type: *boolean* Normalization flag for body waves. .. confval:: automt.profiles.$name.wNormalize.surface Default: ``true`` Type: *boolean* Normalization flag for surface waves. .. confval:: automt.profiles.$name.wNormalize.mantle Default: ``true`` Type: *boolean* Normalization flag for mantle waves. .. confval:: automt.profiles.$name.wNormalize.w-phase Default: ``true`` Type: *boolean* Normalization flag for W\-phases. .. confval:: automt.profiles.$name.wNormalize.full Default: ``true`` Type: *boolean* Normalization flag for full waves. .. _automt.profiles.$name.wNormalize.body: .. confval:: automt.profiles.$name.wNormalize.body.P Default: ``true`` Type: *boolean* Normalization flag for P waves. .. confval:: automt.profiles.$name.wNormalize.body.S Default: ``true`` Type: *boolean* Normalization flag for S waves. .. _automt.profiles.$name.wNormalize.surface: .. confval:: automt.profiles.$name.wNormalize.surface.R Default: ``true`` Type: *boolean* Normalization flag for Rayleigh waves. .. confval:: automt.profiles.$name.wNormalize.surface.L Default: ``true`` Type: *boolean* Normalization flag for Love waves. .. _automt.profiles.$name.wNormalize.mantle: .. confval:: automt.profiles.$name.wNormalize.mantle.RM Default: ``true`` Type: *boolean* Normalization flag for Rayleigh mantle waves. .. confval:: automt.profiles.$name.wNormalize.mantle.LM Default: ``true`` Type: *boolean* Normalization flag for Love mantle waves. .. _automt.profiles.$name.periods: .. confval:: automt.profiles.$name.periods.body Unit: *s* Type: *string* The filter periods in seconds of the body wave signals. Format [lower]\-[upper], e.g. 20\-50. .. confval:: automt.profiles.$name.periods.surface Unit: *s* Type: *string* The filter periods in seconds of the surface wave signals. Format [lower]\-[upper], e.g. 20\-50. .. confval:: automt.profiles.$name.periods.mantle Unit: *s* Type: *string* The filter periods in seconds of the mantle wave signals. Format [lower]\-[upper], e.g. 50\-150. .. confval:: automt.profiles.$name.periods.w-phase Unit: *s* Type: *string* The filter periods in seconds of the W\-phase signals. Format [lower]\-[upper], e.g. 100\-600. .. confval:: automt.profiles.$name.periods.full Unit: *s* Type: *string* The filter periods in seconds of the full signals. Format [lower]\-[upper], e.g. 8\-20. .. _automt.profiles.$name.periods.body: .. confval:: automt.profiles.$name.periods.body.P Unit: *s* Type: *string* The filter periods in seconds of the P wave signals. Format [lower]\-[upper], e.g. 20\-50. .. confval:: automt.profiles.$name.periods.body.S Unit: *s* Type: *string* The filter periods in seconds of the S wave signals. Format [lower]\-[upper], e.g. 20\-50. .. _automt.profiles.$name.periods.surface: .. confval:: automt.profiles.$name.periods.surface.R Unit: *s* Type: *string* The filter periods in seconds of the surface Rayleigh wave signals. Format [lower]\-[upper], e.g. 20\-50. .. confval:: automt.profiles.$name.periods.surface.L Unit: *s* Type: *string* The filter periods in seconds of the surface Love wave signals. Format [lower]\-[upper], e.g. 20\-50. .. _automt.profiles.$name.periods.mantle: .. confval:: automt.profiles.$name.periods.mantle.RM Unit: *s* Type: *string* The filter periods in seconds of the mantle Rayleigh wave signals. Format [lower]\-[upper], e.g. 50\-150. .. confval:: automt.profiles.$name.periods.mantle.LM Unit: *s* Type: *string* The filter periods in seconds of the mantle Love wave signals. Format [lower]\-[upper], e.g. 50\-150. .. _automt.profiles.$name.signalBegin: .. confval:: automt.profiles.$name.signalBegin.w-phase Unit: *s* Type: *string* The time of the signal to start for the W\-phase with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. confval:: automt.profiles.$name.signalBegin.full Default: ``0`` Unit: *s* Type: *string* The time of the signal to start for full waveforms with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. _automt.profiles.$name.signalBegin.body: .. confval:: automt.profiles.$name.signalBegin.body.P Unit: *s* Type: *string* The time of the signal to start for P phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. confval:: automt.profiles.$name.signalBegin.body.S Unit: *s* Type: *string* The time of the signal to start for S phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. _automt.profiles.$name.signalBegin.surface: .. confval:: automt.profiles.$name.signalBegin.surface.R Unit: *s* Type: *string* The time of the signal to start for Rayleigh phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. confval:: automt.profiles.$name.signalBegin.surface.L Unit: *s* Type: *string* The time of the signal to start for Love phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. _automt.profiles.$name.signalBegin.mantle: .. confval:: automt.profiles.$name.signalBegin.mantle.RM Unit: *s* Type: *string* The time of the signal to start for Rayleigh mantle phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. confval:: automt.profiles.$name.signalBegin.mantle.LM Unit: *s* Type: *string* The time of the signal to start for Love mantle phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: d\/10\-20 .. _automt.profiles.$name.signalEnd: .. confval:: automt.profiles.$name.signalEnd.w-phase Unit: *s* Type: *string* The time of signal end for the W\-phase with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 .. confval:: automt.profiles.$name.signalEnd.full Default: ``300`` Unit: *s* Type: *string* The time of signal end for full waveforms with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 .. _automt.profiles.$name.signalEnd.body: .. confval:: automt.profiles.$name.signalEnd.body.P Unit: *s* Type: *string* The time of signal end for P phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 .. confval:: automt.profiles.$name.signalEnd.body.S Unit: *s* Type: *string* The time of signal end for S phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 .. _automt.profiles.$name.signalEnd.surface: .. confval:: automt.profiles.$name.signalEnd.surface.R Unit: *s* Type: *string* The time of signal end for Rayleigh phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 .. confval:: automt.profiles.$name.signalEnd.surface.L Unit: *s* Type: *string* The time of signal end for Love phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 .. _automt.profiles.$name.signalEnd.mantle: .. confval:: automt.profiles.$name.signalEnd.mantle.RM Unit: *s* Type: *string* The time of signal end for Rayleigh mantle phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 .. confval:: automt.profiles.$name.signalEnd.mantle.LM Unit: *s* Type: *string* The time of signal end for Love mantle phases with respect to origin time. This is an arithmetic expression. The following parameters are available: distance in km \(d\), distance in degree \(D\), onsets \(P,sP,S,LQ,LR\) and end of data \(EOD\). Example: 80+d\/3.5 Command-Line Options ==================== :program:`scmtv [options]` .. _Generic: Generic ------- .. option:: -h, --help Show help message. .. option:: -V, --version Show version information. .. option:: --config-file arg Use alternative configuration file. When this option is used the loading of all stages is disabled. Only the given configuration file is parsed and used. To use another name for the configuration create a symbolic link of the application or copy it. Example: scautopick \-> scautopick2. .. option:: --plugins arg Load given plugins. .. option:: -D, --daemon Run as daemon. This means the application will fork itself and doesn't need to be started with \&. .. option:: --auto-shutdown arg Enable\/disable self\-shutdown because a master module shutdown. This only works when messaging is enabled and the master module sends a shutdown message \(enabled with \-\-start\-stop\-msg for the master module\). .. option:: --shutdown-master-module arg Set the name of the master\-module used for auto\-shutdown. This is the application name of the module actually started. If symlinks are used, then it is the name of the symlinked application. .. option:: --shutdown-master-username arg Set the name of the master\-username of the messaging used for auto\-shutdown. If \"shutdown\-master\-module\" is given as well, this parameter is ignored. .. _Verbosity: Verbosity --------- .. option:: --verbosity arg Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug. .. option:: -v, --v Increase verbosity level \(may be repeated, eg. \-vv\). .. option:: -q, --quiet Quiet mode: no logging output. .. option:: --component arg Limit the logging to a certain component. This option can be given more than once. .. option:: -s, --syslog Use syslog logging backend. The output usually goes to \/var\/lib\/messages. .. option:: -l, --lockfile arg Path to lock file. .. option:: --console arg Send log output to stdout. .. option:: --debug Execute in debug mode. Equivalent to \-\-verbosity\=4 \-\-console\=1 . .. option:: --log-file arg Use alternative log file. .. _Messaging: Messaging --------- .. option:: -u, --user arg Overrides configuration parameter :confval:`connection.username`. .. option:: -H, --host arg Overrides configuration parameter :confval:`connection.server`. .. option:: -t, --timeout arg Overrides configuration parameter :confval:`connection.timeout`. .. option:: -g, --primary-group arg Overrides configuration parameter :confval:`connection.primaryGroup`. .. option:: -S, --subscribe-group arg A group to subscribe to. This option can be given more than once. .. option:: --start-stop-msg arg Default: ``0`` Set sending of a start and a stop message. .. _Database: Database -------- .. option:: --db-driver-list List all supported database drivers. .. option:: -d, --database arg The database connection string, format: service:\/\/user:pwd\@host\/database. \"service\" is the name of the database driver which can be queried with \"\-\-db\-driver\-list\". .. option:: --config-module arg The config module to use. .. option:: --inventory-db arg Load the inventory from the given database or file, format: [service:\/\/]location . .. _Records: Records ------- .. option:: --record-driver-list List all supported record stream drivers. .. option:: -I, --record-url arg The recordstream source URL, format: [service:\/\/]location[#type]. \"service\" is the name of the recordstream driver which can be queried with \"\-\-record\-driver\-list\". If \"service\" is not given, \"file:\/\/\" is used. .. option:: --record-file arg Specify a file as record source. .. option:: --record-type arg Specify a type for the records being read. .. _User interface: User interface -------------- .. option:: -F, --full-screen Start the application filling the entire screen. This only works with GUI applications. .. option:: -N, --non-interactive Use non\-interactive presentation mode. This only works with GUI applications. .. _Options: Options ------- .. option:: -E, --event arg Type: *string* Preload event with given event ID. .. option:: --offline Switch to offline mode. .. option:: -i arg Type: *string* Load events from given XML file during startup and switch to offline mode.