The hinetpy from herrmuellerluedenscheid

hinetpy's Introduction

HinetPy is a Python package to automate and simplify tedious data request, downloading and format conversion tasks related to NIED Hi-net.

NIED Hi-net | Source Code | Documentation | 中文文档

Feature Support

Request continuous waveform data from Hi-net
Request event waveform data from Hi-net
Select Hi-net/F-net stations inside a box or circular region
Convert waveform data from win32 format to SAC format
Extract instrumental response as SAC polezero file
Multithreads downloading and conversion to speedup

A simple example

The power of HinetPy makes it simple to request continuous waveform data from Hi-net, convert the data into SAC format and extract instrumental responses as SAC polezero files.

>>> from HinetPy import Client, win32
>>>
>>> # You need a Hi-net account to access their data
>>> client = Client("username", "password")
>>>
>>> # Let's try to request 20 minutes data since 2010-01-01T00:00(GMT+0900) from Hi-net
>>> # '0101' is the code of Hi-net network
>>> data, ctable = client.get_continuous_waveform('0101', '201001010000', 20)
>>> # The request and downloading process usually takes several minutes
>>> # waiting data request ...
>>> # waiting data downloading ...
>>> ls  # the downloaded data and corresponding channel table
0101_201001010000_20.cnt 0101_20100101.ch
>>>
>>> # Let's convert data from win32 format to SAC format
>>> win32.extract_sac(data, ctable)
>>> # Let's extract instrument response as PZ file from channel table
>>> win32.extract_pz(ctable)
>>> ls
N.NGUH.E.SAC  N.NGUH.U.SAC  N.NNMH.N.SAC
N.NGUH.N.SAC  N.NNMH.E.SAC  N.NNMH.U.SAC
...
N.NGUH.E.SAC_PZ  N.NGUH.U.SAC_PZ  N.NNMH.N.SAC_PZ
N.NGUH.N.SAC_PZ  N.NNMH.E.SAC_PZ  N.NNMH.U.SAC_PZ
...