wiki:ShFetch

Return to command index

Fetch seismograms from arclink servers

command: FETCH <stations> <channel> <components> <start> <length>

Load waveform data from remote arclink servers. The downloaded data is cached by default.

parameters

  • <stations> parameter type: string
    Denotes the stations. The notation in SEED-Format style is mandantory, e.g. GR.GRA. (network GR, station GRA1, location empty). If did configure station aliases, they will be resolved.
  • <channel> parameter type: string
    Request channel type, e.g. BH.
  • <components> parameter type: string
    Set component(s), e.g. Z or ZNE
  • <start> parameter type: time
    Beginning of the data window.
  • <duration> parameter type: float
    Duration of the data window in seconds.

qualifiers

  • /host
    Use other arclink server than specified in configuration file.
  • /usecache
    Use cache for reading. As default SHX requests data remotely if the local cache does not contain data for start time and of given length. There's no method to check whether a in-between gap results from missing local or original data without remote request (this would make the cache irrelevant). Therefore you should only save "final" data to cache (see next parameter). Does not support wildcards.
  • /save
    Save downloaded data into local cache. SHX builds an SDS structure in $HOME/.shx/sds/.
  • /user
    Set username for request (override "user" value in section [arclink] of configuration file)
  • /password
    Set password for request (override "login" value in configuration file)
  • /storemeta
    Store meta data of fetched streams in user's data base.
  • /local
    Disable remote access. Sets implicitly USECACHE option.

examples

fetch gr.gra1. bh z 1-jan-12_1:44:44 600 /save
Download and save data into cache for station GRA1 in given time-range.
fetch gra1,grb1,grc1 hh ne 1-jan-12_12:12:12 300 /local
Load 100 Hz data for three station aliases of Graefenberg array, read only from cache.