rtDD

https://docs.gempa.de/scrtdd/current/
Admin
rtDD is a Double-Difference earthquake relocation software, featuring the scrtdd module, designed...
Tokens:12,573
Snippets:159
Trust Score:8.6
Update:2 months ago
Show doc for...
Tokens:
Raw
### Start Local Web Server for Visualization

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Starts a local web server to view the relocation-map.html visualization tool.

```bash
python3 -m http.server 8080
```

--------------------------------

### Phase CSV Format

Source: https://docs.gempa.de/scrtdd/current/_sources/base/multievent.rst.txt

Example structure for the phase.csv file.

```csv
eventId,isotime,lowerUncertainty,upperUncertainty,type,networkCode,stationCode,locationCode,channelCode
1,2019-11-05T00:54:22.64478Z,0.025,0.025,Pg,8D,RAW2,,HHZ
1,2019-11-05T00:54:23.58254Z,0.100,0.100,Sg,8D,RAW2,,HHT
1,2019-11-05T00:54:22.7681Z,0.025,0.025,Pg,CH,SAYF2,,HGZ
1,2019-11-05T00:54:24.007619Z,0.050,0.050,Sg,CH,STSW2,,HGT
2,2019-11-05T01:03:08.867835Z,0.050,0.050,S,8D,RAW2,,HHT
2,2019-11-05T01:03:07.977432Z,0.025,0.025,P,CH,SAYF2,,HGZ
2,2019-11-05T01:03:08.9947Z,0.050,0.050,Sg,CH,SAYF2,,HGT
2,2019-11-05T01:03:09.12808Z,0.050,0.050,P,CH,STSW2,,HG1
2,2019-11-05T01:03:09.409276Z,0.025,0.025,Sg,CH,SENIN,,HHT
```

--------------------------------

### CSV File Structures

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Example content for event, station, and phase CSV files.

```csv
id,isotime,latitude,longitude,depth,magnitude
1,2019-11-05T00:54:21.256705Z,46.318264,7.365509,4.7881,3.32
2,2019-11-05T01:03:06.484287Z,46.320718,7.365435,4.2041,0.64
3,2019-11-05T01:06:27.140654Z,46.325626,7.356148,3.9756,0.84
4,2019-11-05T01:12:25.753816Z,46.325012,7.353627,3.7090,0.39
```

```csv
latitude,longitude,elevation,networkCode,stationCode,locationCode
45.980278,7.670195,3463.0,4D,MH36,A
45.978720,7.663000,4003.0,4D,MH48,A
46.585719,8.383171,2320.4,4D,RA43,
45.903349,6.885881,2250.0,8D,AMIDI,00
46.371345,6.873937,379.0,8D,NVL3,
```

```csv
eventId,isotime,lowerUncertainty,upperUncertainty,type,networkCode,stationCode,locationCode,channelCode
1,2019-11-05T00:54:22.64478Z,0.025,0.025,Pg,8D,RAW2,,HHZ
1,2019-11-05T00:54:23.58254Z,0.100,0.100,Sg,8D,RAW2,,HHT
1,2019-11-05T00:54:22.7681Z,0.025,0.025,Pg,CH,SAYF2,,HGZ
1,2019-11-05T00:54:24.007619Z,0.050,0.050,Sg,CH,STSW2,,HGT
2,2019-11-05T01:03:08.867835Z,0.050,0.050,S,8D,RAW2,,HHT
2,2019-11-05T01:03:07.977432Z,0.025,0.025,P,CH,SAYF2,,HGZ
2,2019-11-05T01:03:08.9947Z,0.050,0.050,Sg,CH,SAYF2,,HGT
2,2019-11-05T01:03:09.12808Z,0.050,0.050,P,CH,STSW2,,HG1
2,2019-11-05T01:03:09.409276Z,0.025,0.025,Sg,CH,SENIN,,HHT
```

--------------------------------

### Define Active Profiles

Source: https://docs.gempa.de/scrtdd/current/apps/scrtdd.html

Example configuration showing how to activate specific profiles for real-time processing.

```text
rtdd.activeProfiles = a,b
profile.a.value1 = ...
profile.b.value1 = ...
# c is not active because it has not been added
# to the list of rtdd.activeProfiles
profile.c.value1 = ...
```

--------------------------------

### Station CSV Format

Source: https://docs.gempa.de/scrtdd/current/_sources/base/multievent.rst.txt

Example structure for the station.csv file.

```csv
latitude,longitude,elevation,networkCode,stationCode,locationCode
45.980278,7.670195,3463.0,4D,MH36,A
45.978720,7.663000,4003.0,4D,MH48,A
46.585719,8.383171,2320.4,4D,RA43,
45.903349,6.885881,2250.0,8D,AMIDI,00
46.371345,6.873937,379.0,8D,NVL3,
```

--------------------------------

### Configuring Messaging Groups for scrtdd

Source: https://docs.gempa.de/scrtdd/current/base/singleevent.html

A system configuration example showing how to route messages between modules to avoid infinite loops.

```text
                      LISTEN                       SEND
              (MessagingSubscription)      (PrimaryMessagingGroup)
scautoloc             ...                        LOCATION
scanloc       LOCATION, ...                      LOCATION
screloc       LOCATION, ...                     RELOCATION
scrtdd        LOCATION, ...                     RELOCATION
scevent       LOCATION,RELOCATION, ...             ...
scamp         LOCATION,RELOCATION, ...             ...
scmag         LOCATION,RELOCATION, ...             ...
```

--------------------------------

### Install Travel Time Tables

Source: https://docs.gempa.de/scrtdd/current/base/ttt.html

Copies the generated tables into the SeisComP directory for system-wide access.

```bash
cp mymodel* seiscomp_installation/share/locsat/tables/
```

--------------------------------

### Event CSV Format

Source: https://docs.gempa.de/scrtdd/current/_sources/base/multievent.rst.txt

Example structure for the event.csv file.

```csv
id,isotime,latitude,longitude,depth,magnitude
1,2019-11-05T00:54:21.256705Z,46.318264,7.365509,4.7881,3.32
2,2019-11-05T01:03:06.484287Z,46.320718,7.365435,4.2041,0.64
3,2019-11-05T01:06:27.140654Z,46.325626,7.356148,3.9756,0.84
4,2019-11-05T01:12:25.753816Z,46.325012,7.353627,3.7090,0.39
```

--------------------------------

### Define an Origin ID Catalog

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Example of a CSV file format containing a mandatory 'origin' column for input into scrtdd.

```text
origin
Origin/20181214107387.056851.253104
Origin/20180053105627.031726.697885
Origin/20190121103332.075405.6234534
Origin/20190223103327.031726.346363
[...]
```

--------------------------------

### Execute Multi-Event Relocation

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Command to run the relocation process using a specified profile and input catalog.

```bash
scrtdd --reloc-catalog myCatalog.csv --profile myProfile \
       --dump-diagnostics --verbosity=3 --console=1 [db options]
```

--------------------------------

### Relocate Events using XML File

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Relocates events using an XML file for origin data instead of a database.

```bash
# events.xml contais the origins data
# myCatalog.csv contains the origin ids inside events.xml we want relocate
scrtdd --reloc-catalog myCatalog.csv --ep events.xml --profile myProfile \
       --dump-diagnostics --verbosity=3 --console=1 [db options]
```

--------------------------------

### Relocate and export to XML

Source: https://docs.gempa.de/scrtdd/current/base/singleevent.html

Export relocation results to an XML file for inspection in scolv.

```bash
scrtdd --origin-id someOriginId --xmlout --dump-diagnostics \
  --verbosity=3 --console=1 [db options] \
  > relocated-origin.xml
```

--------------------------------

### Pre-download Catalog Waveforms

Source: https://docs.gempa.de/scrtdd/current/base/xcorr.html

Forces the application to cache all reference catalog waveforms for a specific profile to disk.

```bash
scrtdd --load-profile-wf --profile myprofile  \
       --verbosity=3 --console=1  [-I RecordStream] [db options]
```

--------------------------------

### Dump Event Catalog to CSV

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Generates event.csv, phase.csv, and stations.csv from an existing list of origin IDs.

```bash
scrtdd --dump-catalog myCatalog.csv --verbosity=3 --console=1 [db options]
```

--------------------------------

### Relocate Events using CSV Triplet

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Relocates events using the provided station, event, and phase CSV files.

```bash
scrtdd --reloc-catalog station.csv,event.csv,phase.csv --profile myProfile \
       --dump-diagnostics --verbosity=3 --console=1 [db options for cross-correlation]
```

--------------------------------

### List Origin IDs with sclistorg

Source: https://docs.gempa.de/scrtdd/current/base/multievent.html

Commands to filter and export origin IDs from a SeisComP database based on time, type, and agency criteria.

```bash
# List preferred origin IDs for all events between 2018-11-27 and 2018-12-14
sclistorg --begin "2018-11-27 00:00:00" --end "2018-12-14 00:00:00" \
          --org-type preferred [db options]

# Filter by event type and specific agencies
sclistorg --begin "2018-11-27 00:00:00" --end "2018-12-14 00:00:00" \
          --org-type preferred --ev-type "earthquake,quarry blast" \
          --inc-agency Agency1,Agency2 [db options] > myCatalog.csv
```

--------------------------------

### Process XML origin file offline

Source: https://docs.gempa.de/scrtdd/current/_sources/base/singleevent.rst.txt

Use the --ep option to process all origins within an XML file and redirect the output to a new file.

```bash
scrtdd --ep origin.xml --verbosity=3 --console=1 [db options] \
  > relocated-origin.xml
```

--------------------------------

### Generate Travel Time Tables

Source: https://docs.gempa.de/scrtdd/current/base/ttt.html

Executes the taup_table command for various seismic phases to create the required LOCSAT files.

```bash
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph ttp+ -locsat -header mymodel.header -o mymodel.P
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph tts+ -locsat -header mymodel.header -o mymodel.S
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph PcP  -locsat -header mymodel.header -o mymodel.PcP
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph Pg   -locsat -header mymodel.header -o mymodel.Pg
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph Pn   -locsat -header mymodel.header -o mymodel.Pn
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph pP   -locsat -header mymodel.header -o mymodel.pP
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph PP   -locsat -header mymodel.header -o mymodel.PP
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph pS   -locsat -header mymodel.header -o mymodel.pS
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph ScP  -locsat -header mymodel.header -o mymodel.ScP
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph Sg   -locsat -header mymodel.header -o mymodel.Sg
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph Sn   -locsat -header mymodel.header -o mymodel.Sn
./TauP-installation/bin/taup_table -mod iasp91_mymodel -ph sP   -locsat -header mymodel.header -o mymodel.sP
```

--------------------------------

### Define Travel-Time Table Header

Source: https://docs.gempa.de/scrtdd/current/_sources/base/ttt.rst.txt

Header configuration file specifying the number of depth and distance samples and their respective values.

```text
n # P,S travel-time table sampling for mymodel
    20     # number of depth samples
       0.00   2.50   5.00   7.50  10.00  15.00  20.00  25.00  30.00  40.00
      50.00  75.00 100.00 150.00 200.00 300.00 400.00 500.00 600.00 800.00
    140    # number of distances
       0.00   0.05   0.10   0.15   0.20   0.25   0.30   0.35   0.40   0.45
       0.50   0.60   0.70   0.80   0.90   1.00   1.10   1.20   1.30   1.40
       1.50   1.60   1.70   1.80   1.90   2.00   2.50   3.00   4.00   5.00
       5.50   6.00   6.50   7.00   7.50   8.00   8.50   9.00   9.50  10.00
      11.00  12.00  13.00  14.00  15.00  16.00  17.00  18.00  19.00  20.00
      21.00  22.00  23.00  24.00  25.00  26.00  27.00  28.00  29.00  30.00
      31.00  32.00  33.00  34.00  35.00  36.00  37.00  38.00  39.00  40.00
      41.00  42.00  43.00  44.00  45.00  46.00  47.00  48.00  49.00  50.00
      51.00  52.00  53.00  54.00  55.00  56.00  57.00  58.00  59.00  60.00
      61.00  62.00  63.00  64.00  65.00  66.00  67.00  68.00  69.00  70.00
      71.00  72.00  73.00  74.00  75.00  76.00  77.00  78.00  79.00  80.00
      81.00  82.00  83.00  84.00  85.00  86.00  87.00  88.00  89.00  90.00
      91.00  92.00  93.00  94.00  95.00  96.00  97.00  98.00  99.00 100.00
     102.00 104.00 106.00 108.00 110.00 112.00 114.00 116.00 118.00 120.00
```

--------------------------------

### Dump Processed Waveforms for Inspection

Source: https://docs.gempa.de/scrtdd/current/base/xcorr.html

Exports processed waveforms to miniSEED files for external inspection using tools like scrttv or ObsPy.

```bash
scrtdd --dump-wf station.csv,event.csv,phase.csv --profile myProfile \
       --verbosity=3 --console=1  [-I RecordStream] [db options]
```

--------------------------------

### Configure RecordStream for Multi-Event Access

Source: https://docs.gempa.de/scrtdd/current/base/xcorr.html

Specifies the RecordStream source for historical catalog waveforms using FDSN or SDS archive services.

```bash
scrtdd -I fdsnws://service.iris.edu:80/fdsnws/dataselect/1/query [...options...]
```

```bash
scrtdd -I sdsarchive:///path/to/archive [...options...]
```

--------------------------------

### Export Relocated Origin to XML

Source: https://docs.gempa.de/scrtdd/current/_sources/base/singleevent.rst.txt

Relocate an origin ID and save the output to an XML file for inspection in scolv. This command redirects the diagnostic output to a file.

```bash
scrtdd --origin-id someOriginId --xmlout --dump-diagnostics \
       --verbosity=3 --console=1 [db options] \
  > relocated-origin.xml
```

--------------------------------

### Configure RecordStream for Single-Event Real-Time Access

Source: https://docs.gempa.de/scrtdd/current/base/xcorr.html

Defines the RecordStream to combine SeedLink and SDS archive sources for real-time and historical data retrieval.

```text
recordstream = combined://slink/localhost:18000;sdsarchive//path/to/miniseed
```

```text
recordstream = combined://slink/localhost:18000?timeout=5&retries=0;sdsarchive//path/to/miniseed
```

--------------------------------

### Merge Velocity Models

Source: https://docs.gempa.de/scrtdd/current/base/ttt.html

Combines a custom shallow layer model with a standard reference model like iasp91.

```bash
./TauP-installation/bin/taup velmerge -mod iasp91 -tvelmerge mymodel.tvel
```

--------------------------------

### Test Single-Event Relocation

Source: https://docs.gempa.de/scrtdd/current/_sources/base/singleevent.rst.txt

Relocate a specific origin ID without broadcasting the result to the messaging system. Use the --test flag to prevent message transmission and --dump-diagnostics for troubleshooting.

```bash
scrtdd --origin-id someOriginId --test --dump-diagnostics \
       --verbosity=3 --console=1 [db options]
```

--------------------------------

### Define Sampling Header

Source: https://docs.gempa.de/scrtdd/current/base/ttt.html

Specifies depth and distance sampling points for the travel time tables in a header file.

```text
    n # P,S travel-time table sampling for mymodel
20     # number of depth samples
   0.00   2.50   5.00   7.50  10.00  15.00  20.00  25.00  30.00  40.00
  50.00  75.00 100.00 150.00 200.00 300.00 400.00 500.00 600.00 800.00
140    # number of distances
   0.00   0.05   0.10   0.15   0.20   0.25   0.30   0.35   0.40   0.45
   0.50   0.60   0.70   0.80   0.90   1.00   1.10   1.20   1.30   1.40
   1.50   1.60   1.70   1.80   1.90   2.00   2.50   3.00   4.00   5.00
   5.50   6.00   6.50   7.00   7.50   8.00   8.50   9.00   9.50  10.00
  11.00  12.00  13.00  14.00  15.00  16.00  17.00  18.00  19.00  20.00
  21.00  22.00  23.00  24.00  25.00  26.00  27.00  28.00  29.00  30.00
  31.00  32.00  33.00  34.00  35.00  36.00  37.00  38.00  39.00  40.00
  41.00  42.00  43.00  44.00  45.00  46.00  47.00  48.00  49.00  50.00
  51.00  52.00  53.00  54.00  55.00  56.00  57.00  58.00  59.00  60.00
  61.00  62.00  63.00  64.00  65.00  66.00  67.00  68.00  69.00  70.00
  71.00  72.00  73.00  74.00  75.00  76.00  77.00  78.00  79.00  80.00
  81.00  82.00  83.00  84.00  85.00  86.00  87.00  88.00  89.00  90.00
  91.00  92.00  93.00  94.00  95.00  96.00  97.00  98.00  99.00 100.00
 102.00 104.00 106.00 108.00 110.00 112.00 114.00 116.00 118.00 120.00
```
Tokens:
Raw