BREQ_FAST 是 Batch REQuests FAST 的简称。简单来说，就是通过发送特定格式的邮件到指定的 邮箱来申请数据。这种数据申请的方法不同于常见的交互式方法，因而特别适合写脚本自动生成 邮件内容、自动发送邮件、自动下载数据。

优点

  • 简单易用，易于自动化
  • 速度快，不受网速限制
  • 从申请到下载可以完全脚本化，适合数据批量申请

缺点

  • 需要自己准备地震目录及台站列表
  • 需要自己计算震相走时以确定要申请的数据时间窗
  • 非交互式，不像其他方法那样可以在线获得事件信息，根据事件选择符合一定条件的台站

邮件内容格式

BREQ_FAST 对邮件内容的格式有严格的要求，但对邮件主题无要求。具体格式要求如下:

.NAME
.INST
.MAIL
.EMAIL
.PHONE
.FAX
.MEDIA:
.ALTERNATE MEDIA:
.ALTERNATE MEDIA:
.LABEL
.SOURCE     ---
.HYPO         | optional
.MAGNITUDE  ---
.QUALITY
.END
 request line-1
 request line-2
 ...
 ...
 ...
 request line-n

要保证所有以 “.” 开头的标记行左对齐！！！

  • .NAME ：用户姓名，IRIS 会根据此标记在 ftp 上建立相关文件夹；
  • .INST ：单位或者机构信息（应该没啥用）；
  • .MAIL ：邮寄地址；（不会寄东西的）
  • .EMAIL ：邮箱。IRIS 会向这个邮箱发送有关数据状态的邮件，可以与发送该邮件的邮箱地址不同；
  • .PHONE ：电话；（没用）
  • .FAX ：传真；（没用）
  • .MEDIA ：数据获取介质。有如下几种方式可以选择（按照倾向性排序），现在常用的方式是 FTP， 要求指定第一、第二、第三介质；
    • Electronic (FTP)
    • EXABYTE – 2 gigabyte
    • EXABYTE – 5 gigabyte
    • DAT (digital audio tape)
    • DLT
    • DVD-R
  • .LABEL ：申请的 SEED 数据将会以该 LABEL 命名，SEED 文件内部也会包含这个 LABEL 的信息，应该 选择合适的 LABEL 以保证文件名的唯一性和可区分性；（以发震时刻命名是个不错的选择）
  • .SOURCE 、 .HYPO 和 .MAGNITUDE 是可选的，其指定了震源的一些信息，这些信息最终 会被写入 SEED 文件中；若未指定这三个标记，SEED 解压出的 SAC 文件时没有震源信息的；若指定了这三个 标记，解压出来的 SAC 文件时有震源信息的（有发震的经纬度、深度和震级，头段变量 o 的意义也是发震时刻相对于参考时刻的时间，然而 o 没有被修改为 0）。 震源信息也可以后期再写入。这三个标记的详细信息可以参考最后给出的链接。
  • .QUALITY ：数据质量；一般默认 B；
    • B ：最好的数据（首选 Q，没有 Q 则选择 D，没有 D 则选择 R）
    • E ：所有数据（Q+D+R）
    • Q ：经过质量控制的数据
    • D ：中等质量数据；
    • R ：最原始数据；
  • request line 是真正的数据申请信息，前面的那些都只是辅助信息；

Request Line 格式

STA NN YYYY MM DD HH MM SS.TTTT YYYY MM DD HH MM SS.TTTT #_CH CH1 CH2 CHn LI
  • STA ：台站名
  • NN ：台网或虚拟台网名
  • YYYY、MM、DD、HH、MM：年份（四位）、月、日、时、分
  • SS.TTTT ：秒；小数点后为毫秒，可以省略；
  • 日期和时间出现了两次，分别代表要申请的数据的开始时间和结束时间；
  • #_CH ：接下来通道名的列数；
  • CHn ：通道名可以包含通配符；
  • LI ：LOCATION ID，可选

每行最多包含 100 个字符。

通配符

通道标识符支持通配符，目前仅支持通配符 ?，代表任意单个字符，比如 BH? 代表所有宽频带 （Broadband）高增益（High gain）的通道，可能包含 BHE、BHN、BHZ、BH1、BH2 等等；通道列表 可以包含多个字段，比如 3 LHZ BH? S??。

台网和台站也可使用通配符，但是不建议台网和台站同时使用通配符；单个 ? 可以匹配该台网的所有台站。

如果不指定位置号，则获取该台站的全部 location 的数据。

对于每个台站可以分别指定数据窗范围，因而可以根据到时信息确定需要的数据窗，最大程度减少数据量。不过长一点也无所谓。

例子

给出了 SOURCE、HYPO、MAGNITUDE 的例子，request line 给出了尽可能多的写法：

.NAME Joe Seismologist
.INST Podunk University
.MAIL 101 Fast Lane, Middletown, KS  89432
.EMAIL joe@podunk.edu
.PHONE 555 555-1212
.FAX   555 555-1213
.MEDIA FTP
.ALTERNATE MEDIA 1/2" tape - 6250
.ALTERNATE MEDIA EXABYTE
.LABEL Joe's FIRST Request
.SOURCE ~NEIC PDE~Jan 1990 PDE~National Earthquake Information Center - USGS DOI~
.HYPO ~1999 01 02 20 21 32.62~ 13.408~ 144.439~135.0~18~216~Mariana Islands~
.MAGNITUDE ~5.7~mb~
.QUALITY B
.END
GRFO IU 1999 01 02 00 18 10.4 1999 01 02 00 20 10.4  1 SHZ
ANTO IU 1999 01 02 02 10 36.6 1999 01 02 02 12 36.6  1 SH?
AFI  IU 1999 01 02 02 10 37.1 1999 01 02 02 12 37.1  1 BH? 00
SEE  CD 1999 01 02 14 45 08.9 1999 01 02 14 47 08.9  1 SHZ
CASY IU 1999 01 04 02 42 13.4 1999 01 04 02 44 13.4  1 BHZ 10
NNA  II 1999 01 04 02 41 57.5 1999 01 04 02 43 57.5  1 BHZ
PFO  TS 1999 01 04 02 41 57.5 1999 01 04 02 43 57.5  1 BHZ
PFO  II 1999 01 04 02 41 57.5 1999 01 04 02 43 57.5  1 BHZ
KMI  CD 1999 01 04 02 41 57.5 1999 01 04 02 43 57.5  1 BHZ
SSE  CD 1999 01 04 02 18 25.4 1999 01 04 02 20 25.4  2 B?? SHZ
PAS  TS 1999  1  4  2 10 49   1999  1  4  2 12 49    3 BH? SHZ L??

发送邮件到这里

根据上面的规则生成了邮件内容，直接将内容作为邮件正文（不是附件）以纯文本格式发送到指定邮箱，不同的邮箱功能不同；

  • breq_fast@iris.washington.edu ：申请完整的 SEED 文件，最常用的方式；
  • DATALESS@iris.washington.edu ：无数据的 SEED 文件，包含仪器响应、仪器坐标等台站信息，一般与 miniSEED 数据联合使用；
  • miniseed@iris.washington.edu ：miniSEED 数据，只有数据没有台站信息；
  • sync@iris.washington.edu ：合成数据

申请回应

发送数据请求之后，通常在很短的时间内，就会收到第一封邮件，通知你 IRIS 已经收到该邮件。一段较长的时间后， 将收到第二封邮件。如果一切顺利，则第二封邮件将告诉你数据已经准备完毕，并给出下载链接。否则则告诉你无法 完成你的请求。通常有如下几种出错的原因：

  1. 邮件内容的格式错误
  2. IRIS DMC 中没有你要申请的数据
  3. 要申请的数据不完全公开

如果发送数据请求后，很长时间都没有收到第一封邮件，一个可能的情况是在发送邮件时使用了富文本，这种情况 通常是由于使用网页版的邮箱发送导致的。

为了避免富文本导致的问题，建议用 Perl 或 Python 脚本发送邮件。

Bug 和限制

  • 无法识别超过正常范围的时间，比如分钟数大于 59，这要求用户自己认真处理时间问题；
  • 每行必须左对齐；
  • 通配符只支持 “?”

参考