subnetwork_table files

subnetwork_table files offer a simpler way to enter station information into obsinfo, using a station table, at the expense of some of the flexibility that subnetwork files offer. The subcommand obsinfo table {something}.station_table.yaml creates a subnetwork file named {something}.subnetwork.yaml that you can subsequently run any of the other subcommands on.

subnetwork_table files are built like subnetwork files, except that the stations element is replaced by a stations_table element with 4 sub-elements:

  • instrumentation_base: the path to the default instrumentation file for all stations

  • timing_base: the path to the timing_base file for all stations

  • location_base: the path to the location_base file for all stations

  • table_file: the (local) path to a CSV file containing station-specific information

Below is an example subnetwork_table` file

---
format_version: "1.1"
revision:
    authors:
        - {$ref: "persons/EXAMPLE.person.yaml"}
    date: "2024-05-19"
subnetwork_table:
    operators:
        -   {$ref: "operators/EXAMPLE.operator.yaml"}
    network:
        $ref: "networks/EXAMPLE.network.yaml"
    stations_table:
        instrumentation_base: "instrumentation_bases/EXAMPLE.instrumentation_base.yaml"
        timing_base: "timing_bases/EXAMPLE.timing_base.yaml"
        location_base: "location_bases/EXAMPLE.location_base.yaml"
        table_file: "EXAMPLE_REQUIRED.stations_table.csv"

The table file

The table file is a text CSV (comma-separated variables) file using ‘.’ as the decimal place and ‘,’ as the column separator. The first line of the file specifies the names of each column. Each following line provides the information for one station.

Required columns

code

the station code

start_date

the station start date

end_date

the station end date

lon

the station longitude. Can be written in three ways:

  • “i(.i)”: decimal degrees, for example “46.2424”

  • “i_i(.i)”: integer degrees and decimal minutes, for example “46_14.544”

  • “i_i_i(.i)”: integer degrees, integer minutes and decimal seconds, for example “46_14_33”

lat

the station longitude. Same format as lon

elev.m

the station elevation above sea level, in meters

datalogger_configuration

the specific configuration of the datalogger

sync_inst_start

the reference time at the start synchronization of the datalogger

sync_ref_start

the instrumentation time at the start synchronization of the datalogger

sync_inst_end

the reference time at the end synchronization of the datalogger

sync_ref_end

the instrumentation time at the end synchronization of the datalogger

Optional elements:

site

A description of the station site

serial_number

the serial number of the instrumentation

location_configuration

Configuration providing the location (lat, lon and elev) uncertainty, plus measurement method). If not provided, the default configuration will be used These values are overwritten by the 4 following values, if they are provided.

lon_uncert.m

the longitude uncertainty in meters. Replaces the value in the subnetwork_table file

lat_uncert.m

the latitude uncertainty in meters. Replaces the value in the subnetwork_table file

elev_uncert.m

the elevation uncertainty in meters. Replaces the value in the subnetwork_table file

location_measurement_method

the method used to determine the station location. Replaces the value in the location_base file

channel_start_date_{x}

set the start date of the channel(s) specified by {x}

channel_end_date_{x}

set the end date of the channel(s) specified by {x}

where {x} can be:

  • a channel subbase code [Z, H, …]

  • a location - channel subbase code [01-Z, 01-H, …].

  • * or *-*, in which all channels are modified

  • *-{y}, which behaves the same as {y}

  • {l}-*, which changes all channels with location code {l}

datalogger_SN

serial number of the datalogger

seismic_sensor_SN

serial number of the seismic sensor

pressure_sensor_SN

serial number of the pressure sensor

instrumentation_configuration

specific configuration of the instrumentation

seismic_sensor_configuration

specific configuration of the seismic sensor

pressure_sensor_configuration

specific configuration of the pressure sensor

instrumentation_replace

Replace the instrumentation_base filename with this

datalogger_replace

Replace the datalogger_base filename with this

seismic_sensor_replace

Replace the seismic sensor filename with this

pressure_sensor_replace

Replace the pressure sensor filename with this

Example CSV files

With only the required columns

The CSV file:

code,start_date,end_date,lon,lat,elev.m,datalogger_configuration,sync_inst_start,sync_ref_start,sync_inst_end,sync_ref_end
ANO,2019-10-01T01:00:00,2019-10-29T00:00:00,45_42.00,-12_42.00,-1693,125sps,2019-09-28T10:40:00Z,2019-09-28T10:40:00Z,2019-10-25T06:41:59.331000Z,2019-10-25T06:41:59Z 
ASO,2019-10-01T01:00:00,2019-10-29T00:00:00,45_42.00,-12_54.00,-1218,125sps,2019-09-27T18:43:00Z,2019-09-27T18:43:00Z,2019-10-24T18:49:59.514000Z,2019-10-24T18:49:59Z 
AEA,2019-10-01T01:00:00,2019-10-29T00:00:00,45_48.00,-12_48.00,-3350,125sps,2019-09-28T16:57:00Z,2019-09-28T16:57:00Z,2019-10-25T17:47:59.788000Z,2019-10-25T17:47:59Z 
AWE,2019-10-01T01:00:00,2019-10-29T00:00:00,45_36.00,-12.800,-3350,250sps,2019-09-28T16:57:00Z,2019-09-28T16:57:00Z,2019-10-25T17:47:59.788000Z,2019-10-25T17:47:59Z 
ACE,2019-10-01T01:00:00,2019-10-29T00:00:00,45_42.00,-12_48_2.0,-3350,62.5sps,2019-09-28T16:57:00Z,2019-09-28T16:57:00Z,2019-10-25T17:47:59.788000Z,2019-10-25T17:47:59Z

viewed as a table:

code

start_date

end_date

lon

lat

elev.m

datalogger_configuration

sync_inst_start

sync_ref_start

sync_inst_end

sync_ref_end

ANO

2019-10-01T01:00:00

2019-10-29T00:00:00

45_42.00

-12_42.00

-1693

125sps

2019-09-28T10:40:00Z

2019-09-28T10:40:00Z

2019-10-25T06:41:59.331000Z

2019-10-25T06:41:59Z

ASO

2019-10-01T01:00:00

2019-10-29T00:00:00

45_42.00

-12_54.00

-1218

125sps

2019-09-27T18:43:00Z

2019-09-27T18:43:00Z

2019-10-24T18:49:59.514000Z

2019-10-24T18:49:59Z

AEA

2019-10-01T01:00:00

2019-10-29T00:00:00

45_48.00

-12_48.00

-3350

125sps

2019-09-28T16:57:00Z

2019-09-28T16:57:00Z

2019-10-25T17:47:59.788000Z

2019-10-25T17:47:59Z

AWE

2019-10-01T01:00:00

2019-10-29T00:00:00

45_36.00

-12.800

-3350

250sps

2019-09-28T16:57:00Z

2019-09-28T16:57:00Z

2019-10-25T17:47:59.788000Z

2019-10-25T17:47:59Z

ACE

2019-10-01T01:00:00

2019-10-29T00:00:00

45_42.00

-12_48_2.0

-3350

62.5sps

2019-09-28T16:57:00Z

2019-09-28T16:57:00Z

2019-10-25T17:47:59.788000Z

2019-10-25T17:47:59Z

With all possible columns

The CSV file:

code,start_date,end_date,lon,lat,elev.m,datalogger_configuration,sync_inst_start,sync_ref_start,sync_inst_end,sync_ref_end,site,serial_number,location_configuration,lon_uncert.m,lat_uncert.m,elev_uncert.m,location_measurement_method,datalogger_SN,seismic_sensor_SN,pressure_sensor_SN,instrumentation_configuration,seismic_sensor_configuration,pressure_sensor_configuration,instrumentation_replace,datalogger_replace,seismic_sensor_replace,pressure_sensor_replace,channel_start_date_Z,channel_end_date_Z
ANB,2019-10-01T01:00:00,2019-10-29T00:00:00,45_42.03,-12_43.01,-1693,125sps,2019-09-28T10:40:00Z,2019-09-28T10:40:00Z,2019-10-25T06:41:59.331000Z,2019-10-25T06:41:59Z ,North,BB01,BUC_DIRECT,,,,,T1028,S3028,P028,SN01_2012+,Sphere08,5018,,,,,2019-10-03T01:00:00,2019-10-25T00:00:00
ASB,2019-10-01T01:00:00,2019-10-29T00:00:00,45_42.01,-12_53.02,-1218,125sps,2019-09-27T18:43:00Z,2019-09-27T18:43:00Z,2019-10-24T18:49:59.514000Z,2019-10-24T18:49:59Z ,South,BB02,,250,250,25,Surface deployment postion,T1045,S3045,P045,SN01,,,instrumentation_bases/EXAMPLE_CBBOBS.instrumentation_base.yaml,,,,,
AEB,2019-10-01T01:00:00,2019-10-29T00:00:00,45_47.00,-12_48.01,-3350,125sps,2019-09-28T16:57:00Z,2019-09-28T16:57:00Z,2019-10-25T17:47:59.788000Z,2019-10-25T17:47:59Z ,East,BB03,,10,10,5,BUC drop,T1056,S2056,P0456,SN03_2012+,,,,,,sensor_bases/EXAMPLE_Hydrophone.sensor_base.yaml,,
AWB,2019-10-01T01:00:00,2019-10-29T00:00:00,45_37.01,-12_48.01,-3350,250sps,2019-09-28T16:57:00Z,2019-09-28T16:57:00Z,2019-10-25T17:47:59.788000Z,2019-10-25T17:47:59Z ,West,BB04,,5,5,5,Acoustic survey,T1048,S3048,P048,SN04_2012+,,,,,,,,
ACB,2019-10-01T01:00:00,2019-10-29T00:00:00,45_42.02,-12_48_06.5,-3350,62.5sps,2019-09-28T16:57:00Z,2019-09-28T16:57:00Z,2019-10-25T17:47:59.788000Z,2019-10-25T17:47:59Z ,Central,BB05,BUC_DIRECT,2,2,2,,T1033,S3033,P033,SN05_2012+,,,,,,,,

viewed as a table:

code

start_date

end_date

lon

lat

elev.m

datalogger_configuration

sync_inst_start

sync_ref_start

sync_inst_end

sync_ref_end

site

serial_number

location_configuration

lon_uncert.m

lat_uncert.m

elev_uncert.m

location_measurement_method

datalogger_SN

seismic_sensor_SN

pressure_sensor_SN

instrumentation_configuration

seismic_sensor_configuration

pressure_sensor_configuration

instrumentation_replace

datalogger_replace

seismic_sensor_replace

pressure_sensor_replace

channel_start_date_Z

channel_end_date_Z

ANB

2019-10-01T01:00:00

2019-10-29T00:00:00

45_42.03

-12_43.01

-1693

125sps

2019-09-28T10:40:00Z

2019-09-28T10:40:00Z

2019-10-25T06:41:59.331000Z

2019-10-25T06:41:59Z

North

BB01

BUC_DIRECT

T1028

S3028

P028

SN01_2012+

Sphere08

5018

2019-10-03T01:00:00

2019-10-25T00:00:00

ASB

2019-10-01T01:00:00

2019-10-29T00:00:00

45_42.01

-12_53.02

-1218

125sps

2019-09-27T18:43:00Z

2019-09-27T18:43:00Z

2019-10-24T18:49:59.514000Z

2019-10-24T18:49:59Z

South

BB02

250

250

25

Surface deployment postion

T1045

S3045

P045

SN01

instrumentation_bases/EXAMPLE_CBBOBS.instrumentation_base.yaml

AEB

2019-10-01T01:00:00

2019-10-29T00:00:00

45_47.00

-12_48.01

-3350

125sps

2019-09-28T16:57:00Z

2019-09-28T16:57:00Z

2019-10-25T17:47:59.788000Z

2019-10-25T17:47:59Z

East

BB03

10

10

5

BUC drop

T1056

S2056

P0456

SN03_2012+

sensor_bases/EXAMPLE_Hydrophone.sensor_base.yaml

AWB

2019-10-01T01:00:00

2019-10-29T00:00:00

45_37.01

-12_48.01

-3350

250sps

2019-09-28T16:57:00Z

2019-09-28T16:57:00Z

2019-10-25T17:47:59.788000Z

2019-10-25T17:47:59Z

West

BB04

5

5

5

Acoustic survey

T1048

S3048

P048

SN04_2012+

ACB

2019-10-01T01:00:00

2019-10-29T00:00:00

45_42.02

-12_48_06.5

-3350

62.5sps

2019-09-28T16:57:00Z

2019-09-28T16:57:00Z

2019-10-25T17:47:59.788000Z

2019-10-25T17:47:59Z

Central

BB05

BUC_DIRECT

2

2

2

T1033

S3033

P033

SN05_2012+