Conventions¶

These formats apply to all fields of the configuration.

Paths¶

Paths are absolute or relative to the directory where you start qseek. Start the search in the directory of the configuration file, so that relative paths in the configuration point to the right files. Qseek checks that every given file and directory exists when it reads the configuration.

Units¶

Distances, depths and elevations are in meters, times in seconds, frequencies in Hz. Depth is positive down.

Date and time¶

Dates and times follow ISO 8601 and need a time zone, e.g. Z or +00:00 for UTC. A date without a time is midnight UTC. "now", "today" and "yesterday" are also valid.

{
  "start_time": "2023-10-28T01:21:21.003Z",
  "end_time": "2023-10-29"
}

Durations¶

Durations follow ISO 8601 as well: "PT5M" is 5 minutes, "PT600S" 600 seconds, "PT1H30M" one and a half hours.

Station codes¶

Stations are identified by their network, station and location code (NSL), written as "<network>.<station>.<location>", e.g. "6A.STA13.00". The location code is often empty: "GE.RUE.". Network and location codes have up to two characters, station codes up to five.

Where a field selects stations, such as the blacklist of the stations, partial codes and wildcards match several stations: "6A." matches the whole network, "6A.STA*" all stations starting with STA.

Phase descriptions¶

A phase description names a phase of a ray tracer as "<tracer>:<phase>", e.g. "cake:P", "fm:S" or "constant:P". The phase_map of the image function assigns its P and S images to these phase descriptions, and every phase needs a ray tracer that calculates its travel times.

Locations¶

A location is a geographic reference, lat and lon in degrees, plus a shift to the east and north in meters. The search volume and the velocity models are placed with locations.

{
  "lat": 52.3825,
  "lon": 13.0644,
  "east_shift": 0.0,
  "north_shift": 0.0,
  "elevation": 0.0,
  "depth": 0.0
}

lat: float

lon: float

east_shift: float = 0.0

north_shift: float = 0.0

elevation: float = 0.0

depth: float = 0.0

effective_lat_lon: tuple[float, float]

surface_distance_to(other: Location) -> float

azimuth_to(other: Location) -> float

distance_to(other: Location) -> float

offset_from(other: Location) -> tuple[float, float, float]

shifted_origin() -> Self

shift(east: float, north: float, elevation: float) -> Self

origin() -> Location

as_wkt() -> str