跳转到主要内容

用于访问和处理NIED Hi-net地震数据的Python包

项目描述

https://github.com/seisman/HinetPy/actions/workflows/tests.yml/badge.svg https://codecov.io/gh/seisman/HinetPy/branch/main/graph/badge.svg https://img.shields.io/github/release/seisman/HinetPy.svg https://img.shields.io/pypi/v/HinetPy.svg https://img.shields.io/pypi/pyversions/HinetPy.svg https://img.shields.io/github/license/seisman/HinetPy.svg https://joss.theoj.org/papers/10.21105/joss.06840/status.svg https://zenodo.org/badge/23509035.svg

NIED Hi-net | 源代码 | 文档 | 中文文档


HinetPy 是一个Python包,用于访问和处理来自 NIED Hi-net 的地震数据。

关键特性

  • 简化了对NIED Hi-net地震数据的访问,包括连续/事件波形数据和事件目录。

  • 支持日本的多地震网络(例如,F-net、S-net、MeSO-net等,除了Hi-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
# ...

引用

如果您觉得这个包很有用,请考虑以下方式之一引用此包

引用HinetPy论文(推荐)

从HinetPy v0.9.0版本起,在开源软件杂志上发表了一篇正式论文。这是引用的首选方式。

天,D. (2024). HinetPy:一个用于访问和处理NIED Hi-net地震数据的Python包。开源软件杂志,9(98),6840. https://doi.org/10.21105/joss.06840

引用特定的HinetPy版本

如果您想引用特定的HinetPy版本,可以访问Zenodo,选择您想引用的版本,并按如下方式引用

天,D. (20XX). HinetPy:一个用于访问和处理NIED Hi-net地震数据的Python包(X.X.X)。Zenodo. https://doi.org/10.5281/zenodo.xxxxxxxx

贡献

欢迎反馈和贡献!如果您有任何建议或想贡献一个功能,请随时打开一个issue或pull request。对于更多信息或具体问题,请直接打开一个issue。

许可证

本项目遵循MIT许可协议。

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面