SeisComP3 文档

scinv

编目数据库同步

描述

scinv 将编目XML文件合并成一个,与其他编目(通常为数据库)进行同步,创建初始化 key 文件…

scinv 使用etc/init/scinv.pyetc/inventory同步至数据库。

seiscomp update-config inventory

命令

scinv 使用不同的命令工作。命令 必须 作为 第一个 参数提供,其他参数跟随其后:

scinv $command [options] [files]

sync

使用给定的源文件进行同步。编目可以从数据库读取,或者从 --inventory-db 读取。 作为结果,所有源中的信息均写入目标中,该目标不包含任何附加信息。源必须保存所有的信息。这项工作不同于合并。如果由 -o 指定输出文件,那么不会生成任何消息通知。

该命令由 etc/init/scinv.py 调用:

scinv sync --console=1 -H localhost:$p --filebase "$fb" \
           --rc-dir "$rc" --key-dir "$kd"

这里:

$p = 已配置的消息端口
$fb = $SEISCOMP_ROOT/etc/inventory
$rc = $SEISCOMP_ROOT/var/lib/rc
$kd = $SEISCOMP_ROOT/etc/key

merge

将多个编目合并成一个。用于同步之前。

scinv merge net1.xml net2.xml -o inv.xml

apply

应用已存储的通知器,该通知器由sync命令和–create-notifer -o选项创建。用于离线处理前的测试、调试或准备。

# Synchronise inventory and save the notifiers locally (no messages
# are sent)
scinv sync -d mysql://sysop:sysop@localhost/seiscomp3 \
      --create-notifier -o sync_patch.xml

# Sent the notifiers to the target system
scinv apply -H localhost sync_patch.xml

该操作用于保存同步的异常或问题。

keys

使用当前编目缓冲池同步台站 key 文件。该命令将所有 XML 文件合并至编目缓冲池(或文件)中,并检查etc/key中是否有相应的台站 key 文件。如果不存在,创建空的台站 key 文件。如果一个台站 key 文件没有相应的编目,则删之。

ls

列印编目项目(至通道级别)。用于检查XML文件或编目缓冲池。

$ scinv ls SK.KOLS.xml
  network SK       Slovak National Network of Seismic Stations
    epoch 1980-01-01
    station KOLS   Kolonicke sedlo, Slovakia
      epoch 2004-09-01
      location __
        epoch 2004-09-01
        channel BHE
          epoch 2006-04-25 12:00:00 - 2010-03-24
        channel BHN
          epoch 2006-04-25 12:00:00 - 2010-03-24
        channel BHZ
          epoch 2006-04-25 12:00:00 - 2010-03-24
        channel EHE
          epoch 2004-09-01 - 2006-04-25 10:00:00
        channel EHN
          epoch 2004-09-01 - 2006-04-25 10:00:00
        channel EHZ
          epoch 2004-09-01 - 2006-04-25 10:00:00
        channel HHE
          epoch 2006-04-25 12:00:00 - 2010-03-24
        channel HHE
          epoch 2010-03-25
        channel HHN
          epoch 2006-04-25 12:00:00 - 2010-03-24
        channel HHN
          epoch 2010-03-25
        channel HHZ
          epoch 2006-04-25 12:00:00 - 2010-03-24
        channel HHZ
          epoch 2010-03-25

打印信息的默认级别是 chan。有效的级别有:netstachanresp

要检查编目缓冲池中有效的台网和台站,调用:

scinv ls

check

检查编目文件或全部文件的一致性。第一步,合并所有编目文件。第二步,进行下列一致性检查:

  • 重叠每级(台网、台站…)初相
  • 有效的初相(开始小于结束)
  • 流中定义的增益
  • 设置增益单位
  • 传感器与台站之间的距离
  • 无效的位置 0/0

配置

etc/defaults/global.cfg
etc/defaults/scinv.cfg
etc/global.cfg
etc/scinv.cfg
~/.seiscomp3/global.cfg
~/.seiscomp3/scinv.cfg

命令行

scinv command [options] [files]

可用命令 :syncmergeapplykeyslscheck