wiki:Shx/ShFetchArea

Return to command index

Fetch waveforms from arclink servers selected by area

command: FETCH_AREA <lat> <lon> <halfwidth> <chanlist> <start> <seclength>

Retrieve waveform data from arclink servers selected by area.

parameters

  • <lat> parameter type: float
    Area center point latitude. Defines rectangular area together with <lon> and <halfwidth>.
  • <lon> parameter type: float
    Area center point longitude. Defines rectangular area together with <lon> and <halfwidth>.
  • <halfwidth> parameter type: float
    All stations are selected which differ less than <halfwidth> degrees in latitude and longitude.
  • <chanlist> parameter type: string
    Comma separated channel list (without components). Only the first channel found is this list is read from the server. Example "hh,bh".
  • <start> parameter type: string
    Start time in SH notation. Example "16-Jun-2016_08:30:22".
  • <seclength> parameter type: float
    Length in s of data traces requested.

qualifiers

  • /host
    Address the request to this arclink server (default in SHX config file).
  • /usecache
    Try to read data from cache first before sending a request to the arclink server.
  • /save
    Save retrieved waveforms into local cache.
  • /storemeta
    Store station metadata into local database.
  • /local
    Do not send requests to arclink servers, only use cache.
  • /location=<loclist>
    Priority list for location codes, similar to the <chanlist> parameter for channels.
  • /comp=<compspec>
    Specify components to read. Default "zne,z12", i.e. 3 component data. Alternative is "z" to read only verticals.

example

fetch_area 51. 10. 2. bh,sh,hh,eh 7-aug-15_00:16:30 600 /comp=z /save /storemeta
Read 10 min of data of stations around point (51.,10.) with maximum difference of 2 deg in lat and lon. Read the first vertical channel found in BH, SH, HH, EH for each station. Store delivered data in local cache, put metadata into local database.