BQMail2.0: 向IRIS DMC发送数据请求的Python模块（2. 发送申请）

在发送数据之前我们需要先查询所需台站和事件。BQMail将根据这些信息发送数据申请。

BQMail将采用调用Python模块的形式，查询和发送数据

导入模块

首先需要导入bqmail和可能用到的模块。

1
2


from bqmail.mail import BQMail
from obspy import UTCDateTime

BQMail中所有的时间信息全部遵循obspy.UTCDateTime格式

创建BQMail实例

我们首先创建一个BQMail实例。

1

bq = BQMail('[email protected]', server='smtp.xxx.com', password='xxx', username='bqmail')

'[email protected]'是发送邮件和接受邮件信息的邮箱
server是发送邮件所用的smtp服务器。默认为localhost。

163邮箱在发送大数据量邮件时可能会被退信，目前测试qq企业邮箱可用。
password是该smtp服务器的密码。
username是IRIS ftp站的用户名。

查询台站信息

在发送申请之前我们先查询所需要申请的台站，查询获得台站将全部用于发送数据申请。我们建议先用get_stations命令选择合适的限制条件预先查询，再将准确的限制条件写入脚本中。例如

1

bq.query_stations(network='CB', station='LZH')

这里所有的参数信息与FDSN Client Usage中相同。

发送连续数据申请

部分研究需要发送连续数据申请，即从一时刻到另一时刻，以固定的时间间隔作为SAC文件的时长。

1
2
3


bq.send_mail(arrange='continue', starttime=UTCDateTime(2018, 1, 1), 
             endtime=UTCDateTime(2018, 2, 1), time_val_in_hours=24, 
             channel='BH?', location='00')

arrange='continue'表示发送连续数据申请。
starttime和endtime分别为数据申请的起止时刻。
time_val_in_hours为单位文件的时间长度（时间单位为小时）。
channel和location分别为所申请的通道名和位置名，详见BREQ_FAST Manuals。

发送事件数据申请

另一种申请方式为事件数据申请，即根据搜索的地震事件信息，以某一参考时刻为标准，前后截取一定时间长度，发送数据申请。

查询事件信息

在发送申请前需要以一定的限制条件获取事件信息，例如

1
2


bq.query_events(starttime=UTCDateTime(2010, 1, 1), endtime=UTCDateTime(2010, 3, 1),
                minmagnitude=5.5, catalog='GCMT')

这里所有的参数信息与fdsnws-event web service中相同。

发送数据申请

获取所需事件信息后，设置截取时窗的标准，即可根据台站和事件发送数据申请。

1

bq.send_mail(arrange='events', mark="P", time_before=-100, time_after=300)

arrange='events'表示发送事件数据申请。
mark表示参考时刻，这里可以选择以发震时刻作为标准，或以某一震相的到时作为标准。
- o: 以发震时刻作为标准。
- P, S, ...: 以指定震相到时作为标准，震相名于Taup相同。
time_before和time_after分别表示相对参考时刻前后截取的时长。

小结

相对于老版本，新版本可以在Python脚本中修改设置，更加灵活。如果有新的建议和意见请在项目主页中提交Issue。

文章目录