7.0.0

# Add a new station

This tutorial guides you through the most common activities involved in configuring a single new station in your existing SeisComP system. Depending on your needs, you will use parts of other tutorials to do this.

Pre-requisites for this tutorial:

- Installation on Ubuntu

- An understanding of Inventory.

You may also need to consult

- Get real-time data from a remote Seedlink server (single station)

- Configure real-time processing

- Maintain waveform archives

Afterwards/Results/Outcomes:

- Optionally, data for the new station are acquired and archived in real time.

- Optionally, the new station is used for automatic real-time data processing.

Time range estimate:

- Variable

## Before you start

Try to answer the questions:

- where will you get data?

- if you want to process data locally, where will you get inventory?

- which data will you share?

- how long will you archive, and what streams?

For this example, we’ll add the GRSN Station Collm (CLL) from the GR network.

- If you want to process data on this system, you will need inventory (metadata). Metadata can be obtained from many different sources or created from scratch.

- If you don’t want to process on this system, you won’t need inventory, but you will have to create key file by hand for acquisition and archiving.

## Obtaining inventory for your station

For processing, you will need inventory for the new station. How to obtain this will vary. You can fetch inventory from:

- Other SeisComP systems. Use scxmldump to fetch inventories.

- EIDA nodes [4]. Use web interfaces such as web browsers or wget to fetch an inventory.

- Data centers providing FDSNWS [8]. Use web interfaces such as web browsers or wget to fetch an inventory.

- Your own or shared user repositories on SMP [24].

Note

Create and share inventories

gempa’s SMP [24] is a tool for creating inventory from scratch and community sharing. Create inventories for new or old networks and stations from permanent or temporary deployments. SMP provides inventories in SCML format in multiple versions which can be used without modification.

## Configuring inventory

Suppose that, by one of the methods above, we have it in a single file, `inventory_CLL.xml`. This must be converted from StationXML to SeisComP XML. The resulting file goes into `~/seiscomp/etc/inventory`. See the chapter on Inventory.

    ~/seiscomp/bin/seiscomp exec import_inv  fdsnxml ~/inventory_CLL.xml
    Generating output to /home/user/seiscomp/etc/inventory/inventory_CLL.xml
    No inventory read from inventory db
    Create empty one
    Processing /home/user/inventory_CLL.xml
     - parsing StationXML
     - converting into SeisComP-XML
    Finished processing
    Writing inventory to /home/user/seiscomp/etc/inventory/inventory_CLL.xml

When inventory is loaded, you will see your station in the results of scinv with the ls option:

    $ ~/seiscomp/bin/seiscomp exec scinv ls
    WARNING: /home/user/seiscomp/etc/inventory/README ignored: wrong extension
    [..]
    Parsing /home/user/seiscomp/etc/inventory/MY.xml ... done
    Parsing /home/user/seiscomp/etc/inventory/GE.xml ... done
    [..]
    Merging inventory ... done
      network GR       German Regional Seismic Network, BGR Hannover
        epoch 1976-02-17
        station CLL    GRSN Station Collm
          epoch 1993-04-01
          location __
            epoch 2007-02-07
            channel BHE
              epoch 2007-02-07
            channel BHN
              epoch 2007-02-07
            channel BHZ
              epoch 2007-02-07
            channel HHE
              epoch 2007-02-07

This shows the networks, stations, and channels, and the time spans for which they are known. For active stations, there must be an epoch (time span) with a start date but no end date shown for the desired channel.

The inventory is not yet synchronized with the database. To finalize inventory configuration, run:

    $ seiscomp update-config

Warning

If you get an error, make sure that MySQL/MariaDB is running and the database has been created correctly (see Installation on Ubuntu).

## Configuring for acquisition

If you’ve configured inventory above, you’ll already have a top-level key file for the station in the `~/seiscomp/etc/key` directory.

- You will need to know the waveform source, channels to be acquired, location code used, if any. See Get real-time data from a remote Seedlink server (single station) for the remaining details.

## Configuring processing

Now you can enable the station for processing. Follow the Configure real-time processing tutorial.

## Configuring for archiving

If you want to archive waveforms, consider how long they should be retained. See Maintain waveform archives for how to do this.