# rtDD documentation

This is documentation for rtDD software in version 1.8.9, which consists in the module scrtdd and few other scripts and resources documented in here. Full release information can be found here.

scrtdd is a SeisComP extension module developed at the Swiss Seismological Service that implements Double-Difference event relocation both in Real-Time, one event at the time, and classic offline mode, where an earthquake catalog is relocated as a whole.

## Installation from binaries

You can find compiled version of this module at https://data.gempa.de/packages/Public/. The installation file is a compressed tar archive containing the binary distribution of this module, which can be extracted in your SeisComP installation folder and used right after.

## Installation from source code

The development page of the rtDD project can be found at https://github.com/swiss-seismological-service/scrtdd. There you can find instructions for the compilation of the software.

### About

- Introduction
- Multi-event relocation
  - Summary
  - Getting started
  - Formats of the Event Catalog
    - Event Catalog: list of origin IDs
    - Event Catalog: plain csv files
  - Relocating the candidate events
    - Relocating a file containing a list of origin ids
    - Relocating the station.csv,event.csv,phase.csv triplet
    - Relocating a XML/SCML file
    - Relocating external data
  - Relocation Process
  - Solving for both absolute and relative locations
    - Inclusion of absolute travel time residuals in the double-difference system
  - Evaluating the results
    - Verifying DD system residuals and absolute RMS
    - Verifying relative locations with cross-correlation
    - Verifying the absolute location of the events
  - Useful options
- Real-time single-event relocation
  - Summary
  - Getting started
  - Configuring a background catalog
  - Testing
    - Relocate origin ID and send the relocation to the messaging system for further processing
    - Relocate origin ID but do not send the relocation (debug)
    - Relocate origin ID and store the result to XML file
    - Relocate XML file and store the result to XML file
    - Relocation log
  - Pick update and Phase detection via cross-correlation
  - Avoiding Relocation Loops
  - Relocation Process
- Cross-correlation
  - Eval-xcorr command
  - Reusing cross-correlation results
  - Waveforms inspection
- A continuously updated multi-event relocated catalog
- Custom velocity models
  - ConstVel
  - NonLinLoc
  - LOCSAT
- Waveforms data
  - RecordStream configuration for Single-Event (real-time)
  - RecordStream configuration for Multi-Event
  - Waveforms data caching
  - Catalog waveforms preloading
- Database connection
- scrtdd
  - Configuration
  - Command Line
    - Generic
    - Verbosity
    - Messaging
    - Database
    - Records
    - Mode
    - Catalog
    - ModeOptions