5. Appendices¶
Mapping SEED blockettes to StationXML placeholder¶
StationXML to SEED conversion mapping chart
Yazan Suleiman, Tim Ronan, Robert Casey
Last updated Jan 23, 2020
The following chart maps StationXML elements to their equivalent SEED Blockette numbers and fields. Information external to SEED that may appear in StationXML is largely not shown, except where needed. The nesting and ordering of XML elements are not shown in this chart, but attributes will be clearly marked with a leading dot and indent. Blockettes and their data field numbers are referred to in the following way:
B050 Blockette 50 (Station)
B050.f16 Blockette 50, field 16
B050.f10->B033.f4 Blockette 50, field 10 refers to a Blockette 33 by Abbreviation lookup code, then get value from field 4
Element ‘Network’ | Blockette 050 | Notes |
| B050.f16 | |
| Non-existent | Start date must be determined from the earliest time extent of station epochs in the network. |
| Non-existent | End date must be determined from the earliest time extent of station epochs in the network. |
‘Description’ | B050.f10->B033.f4 | Network description string |
Element ‘Comment’ | B051/B059 | Notes |
‘BeginEffectiveTime’ | B051.f3 B059.f3 | Station = use B051 Channel = use B059 |
‘EndEffectiveTime’ | B051.f4 B059.f4 | |
‘Value’ | B051.f5->B033.f4 B059.f5->B033.f4 | |
Element ‘Station’ | B050 | Notes |
| B050.f3 | |
| B050.f13 | |
| B050.f14 | |
‘Latitude’ | B050.f4 | |
‘Longitude’ | B050.f5 | |
‘Elevation’ | B050.f6 | |
‘Site’.’Name’ | B050.f9 | ‘Site’ is a standalone parent element with a single ‘Name’ element containing the string. |
‘CreationDate’ | Non-existent | Created from the earliest epoch ‘startDate’ of this station. |
Element ‘Channel’ | B052 | Notes |
| B052.f3 | |
| B052.f4 | |
| B052.f22 | |
| B052.f23 | |
‘Latitude’ | B052.f10 | |
‘Longitude’ | B052.f11 | |
‘Elevation’ | B052.f12 | |
‘Depth’ | B052.f13 | |
‘Azimuth’ | B052.f14 | |
‘Dip’ | B052.f15 | |
‘SampleRate’ | B052.f18 | |
‘ClockDrift’ | B052.f19 | |
‘CalibrationUnits’.’Name’ | B052.f9->B034.f4 | ‘CalibrationUnits’ is a standalone element with descriptive sub-elements. |
‘CalibrationUnits’.’Description’ | B052.f9->B034.f5 | |
‘Type’ (can be multiple elements) | B052.f21 | Type code mapping:
|
‘Sensor’.’Description’ | B052.f6->B33.f4 | ‘Sensor’ is a standalone element with a ‘Description’ element for the value string. |
Element ‘Response’ | B053-B062 | Notes |
‘InstrumentSensitivity’ | Stage 0 only. See table below. | Cannot use with ‘Polynomial’ |
‘Polynomial’ | See table below | |
‘Stage’ | Groups B053-B062 entries | Refers to a single response stage, containing multiple elements. |
| B053.f4 B054.f4 B055.f3 B057.f3 B058.f3 B061.f3 B062.f4 | Sequential stage number starting at ‘1’ |
Element ‘PolesZeros’ | B053 | Notes |
‘PzTransferFunctionType’ | B053.f3 | Type code mapping:
|
‘InputUnits’.’Name’ | B053.f5->B034.f4 | |
‘InputUnits’.’Description’ | B053.f5->B034.f5 | |
‘OutputUnits’.’Name’ | B053.f6->B034.f4 | |
‘OutputUnits’.’Description’ | B053.f6->B034.f5 | |
‘NormalizationFactor’ | B053.f7 | Use 1.0 if no entry present |
‘NormalizationFrequency’ | B053.f8 | |
‘Zero’ | Complex number group | Refers to a single zero coefficient entry, containing a real and an imaginary element. |
| Sequence in range from B053.f9 | Sequential row number starting at ‘0’ |
‘Zero’.’Real’ | B053.f10 | |
‘Zero’.’Imaginary’ | B053.f11 | |
| B053.f12 | Applied to both ‘Real’ and ‘Imaginary’ elements. |
| B053.f13 | Applied to both ‘Real’ and ‘Imaginary’ elements. |
‘Pole’ | Complex number group | Refers to a single pole coefficient entry, containing a real and an imaginary element. |
| Sequence in range from B053.f14 | Sequential row number starting at ‘0’ |
‘Pole’.’Real’ | B053.f15 | |
‘Pole.’Imaginary’ | B053.f16 | |
| B053.f17 | Applied to both ‘Real’ and ‘Imaginary’ elements. |
| B053.f18 | Applied to both ‘Real’ and ‘Imaginary’ elements. |
Element ‘Coefficients’ | B054 | Notes |
‘CfTransferFunctionType’ | B054.f3 | Type code mapping:
|
‘InputUnits’.’Name’ | B054.f4->B034.f4 | |
‘InputUnits’.’Description’ | B054.f4->B034.f5 | |
‘OutputUnits’.’Name’ | B054.f5->B034.f4 | |
‘OutputUnits’.’Description’ | B054.f5->B034.f5 | |
‘Numerator’ | B054.f8 | Many of these elements can be listed, based on the count found in B054.f7 |
| B054.f9 | Both attributes are listed and will have the same value in conversion. |
‘Denominator’ | B054.f11 | Many of these elements can be listed, based on the count found in B054.f10 |
| B054.f12 | Both attributes are listed and will have the same value in conversion. |
Element ‘ResponseList’ | B055 | Notes |
‘InputUnits’.’Name’ | B055.f4->B034.f4 | |
‘OutputUnits’.’Name’ | B054.f5->B034.f4 | |
‘ResponseListElementType’.’Frequency’ | B055.F7 | |
‘ResponseListElementType’.’Amplitude’ | B055.F8 | |
| B055.F9 | Both attributes are listed and will have the same value in conversion. |
‘ResponseListElementType’.’Phase’ | B055.F10 | |
| B055.F11 | Both attributes are listed and will have the same value in conversion. |
Element ‘Decimation’ | B057 | Notes |
‘SampleRate’ | B054.f4 | |
‘DecimationFactor’ | B054.f5 | |
‘DecimationOffset’ | B054.f6 | |
‘EstimatedDelay’ | B054.f7 | |
‘Correction’ | B054.f8 | |
Elements ‘InstrumentSensitivity’ & ‘StageGain’ | B058 | Notes |
‘Value’ | B058.f4 | |
‘Frequency’ | B058.f5 | |
‘InputUnits’.’Name’ | B053.f5->B034.f4 B054.f5->B034.f4 B061.f6->B034.f4 | Only used in ‘InstrumentSensitivity’. Use the stage 1 Blockette field value only. Cannot be used for Polynomial response. |
‘InputUnits.’Description’ | B053.f5->B034.f5 B054.f5->B034.f5 B061.f6->B034.f5 | Only used in ‘InstrumentSensitivity’ |
‘OutputUnits’.’Name’ | B053.f6->B034.f4 B054.f6->B034.f4 B061.f7->B034.f4 | Only used in ‘InstrumentSensitivity’. Use the very last (highest) stage Blockette field value only. Cannot be used for Polynomial response. |
‘OutputUnits’.’Description’ | B053.f6->B034.f5 B054.f6->B034.f5 B061.f7->B034.f5 | Only used in ‘InstrumentSensitivity’ |
Element ‘FIR’ | B061 | Notes |
‘Symmetry’ | B061.f5 | Type code mapping:
|
‘InputUnits’.’Name’ | B061.f6->B034.f4 | |
‘InputUnits’.’Description’ | B061.f6->B034.f5 | |
‘OutputUnits’.’Name’ | B061.f7->B034.f4 | |
‘OutputUnits’.’Description’ | B061.f7->B034.f5 | |
‘NumeratorCoefficient’ | B061.f9 | |
| Sequence in range from B061.f8 | Sequential row number starting at ‘0’ |
Element ‘Polynomial’ | B062 | Notes |
‘InputUnits’.’Name’ | B062.f5->B034.f4 | |
‘InputUnits’.’Description’ | B062.f5->B034.f5 | |
‘OutputUnits’.’Name’ | B062.f6->B034.f4 | |
‘OutputUnits’.’Description’ | B062.f6->B034.f5 | |
‘ApproximationType’ | B062.f7 | Type code mapping:
|
‘FrequencyLowerBound’ | B062.f9 | |
‘FrequencyUpperBound’ | B062.f10 | |
‘ApproximationLowerBound’ | B062.f11 | |
‘ApproximationUpperBound’ | B062.f12 | |
‘MaximumError’ | B062.f13 | |
‘Coefficients’ | B062.f15 | |
| Sequence in range from B062.f14 | Sequential row number starting at ‘0’ |
| B062.f16 | Both attributes are listed and will have the same value in conversion. |
Document Structure | B011 | Notes |
B011.F3 B011.F4 B011.F5 | [IRIS] Controls the order that stations are presented when converting from dataless to StationXML. Generated using the station order when converting from StationXML to dataless. | |