HinetPy

HinetPy 是一个可用于申请和处理 NIED Hi-net 地震数据的 Python 包。

主要功能

方便访问 NIED Hi-net 地震数据，包括连续/事件波形数据和事件目录。
支持日本多个地震台网（如 Hi-net、F-net、S-net、MeSO-net 等）。
根据地理位置或台站名称选择台站子集（仅支持 Hi-net、F-net、S-net 和 MeSO-net）。
将波形数据转换为 SAC 格式，将仪器响应转换为 SAC 极零文件。
通过使用多线程，加快下载和处理工作流程。

一个简单的示例

下面的示例展示了如何使用 HinetPy 从 Hi-net 申请连续波形数据，将数据转换为 SAC 格式，并提取 SAC 零极点格式的仪器响应文件。

from HinetPy import Client, win32

# You need a Hi-net account to access the data
client = Client("username", "password")

# Let's try to request 20-minute data of the Hi-net network (with an internal
# network code of '0101') starting at 2010-01-01T00:00 (JST, GMT+0900)
data, ctable = client.get_continuous_waveform("0101", "201001010000", 20)

# The request and download process usually takes a few minutes
# waiting for data request ...
# waiting for data download ...

# Now you can see the data and corresponding channel table in your working directory
# waveform data (in win32 format) : 0101_201001010000_20.cnt
# channel table (plaintext file)  : 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 files from the channel table file
win32.extract_sacpz(ctable)

# Now you can see several SAC and SAC_PZ files in your working directory

# 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
# ...

引用

If you find this package useful, please consider citing the package in either of the following ways:

引用 HinetPy 的文章（推荐）

自 HinetPy v0.9.0 起，HinetPy 的介绍文章发表在 The Journal of Open Source Software 上。这是首选的引用方式。

Tian, D. (2024). HinetPy: A Python package for accessing and processing NIED Hi-net seismic data. Journal of Open Source Software, 9(98), 6840. https://doi.org/10.21105/joss.06840

引用特定的 HinetPy 版本

如果想引用特定的 HinetPy 版本，可以访问 Zenodo，选择要引用的版本，然后像这样引用：

Tian, D. (20XX). HinetPy: A Python package for accessing and processing NIED Hi-net seismic data (X.X.X). Zenodo. https://doi.org/10.5281/zenodo.xxxxxxxx

贡献指南

欢迎反馈和贡献！如果您有任何建议或想贡献一项功能，请新建一个 issue 或 pull request。如需其他信息或具体问题，请直接提交 issue。

许可协议

本项目使用 MIT 许可协议。