A client for downloading continuous data from AFAD TDVMS

Python scripts for downloading data from AFAD TDVMS.

Install

Install directly from github:

$ pip install git+https://github.com/rdno/tdvms_py.git

Or install for development:

$ git clone https://github.com/rdno/tdvms_py.git
$ cd tdvms_py
$ pip install -e .

Example Usage

An Example script can be found in example/example.py

Download Script (tdvms_download)

Download script attempts to ease the data request stage. Uses configuration file and keeps track of the progress. Example configuration file (example/maras.yml) requests 40 minutes seismograms from TK network stations within the 200 km of the epicenter.

Usage:

$ tdvms_download config_file.yml [email protected]

To avoid the possible bans, data requests are manual. Pressing enter submits the request. After you get the e-mail with the link, you can press enter again to submit the next request.

Number of requested batches are recorded in the *_state.yml for every config file.

Configuration file

starttime and endtime format: YYYY-MM-DD HH:MM:SS

data_format: mseed, fseed, inventory. Multiple format can be selected using comma as a separator (e.g. "mseed,inventory").

networks: networks codes (TK, KO, etc.) All networks can be selected like this:

networks:
 - "GZ"
 - "KO"
 - "TB"
 - "TK"
 - "TU"

selection: can be one or multiple of circle,rectangle, name, and device_type.

Examples:

selection:
  circle:
    latitude: 37.224
    longitude: 37.4700
    min_dist_km: 0
    max_dist_km: 200

selection:
  rectangle:
    north_latitude: 39.8183
    west_longitude: 34.7887
    south_latitude: 37.4961
    east_longitude: 43.8576

selection:
  name:
    - "TK.3140"
    - "TK.3141"
    - "TK.3143"

selection:
  device_type:
    - "H"
    - "L"
    - "N"

batch_size: number of station to request at once. 50 is recommended.

Auto download from e-mail

You can also use IMAP to check your e-mail and download the linked zip file automatically using utils.check_imap_email function.

tdvms_download can also use this feature by using a yaml file which includes the login credentials (--use-imap-email flag).

Example IMAP yaml file:

imap_url: "imap.university.edu"
username: "[email protected]"
password: "mysecretpassword"

If you are using Gmail, you might need to create an App Password. More info can be found here.

Notes

There seems to be a server side limitation to requests. You might want to request only 50 stations at a time. You can submit another request after you get the data via e-mail.