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

  • Attribute ‘code’

B050.f16

  • Attribute ‘startDate’

Non-existent

Start date must be determined from the earliest time extent of station epochs in the network.

  • Attribute ‘endDate’

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

  • Attribute ‘code’

B050.f3

  • Attribute ‘startDate’

B050.f13

  • Attribute ‘endDate’

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

  • Attribute ‘locationCode’

B052.f3

  • Attribute ‘code’

B052.f4

  • Attribute ‘startDate’

B052.f22

  • Attribute ‘endDate’

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:

  • C = ‘CONTINUOUS’
  • G = ‘GEOPHYSICAL’
  • T = ‘TRIGGERED’
  • H = ‘HEALTH’
  • W = ‘WEATHER’
  • F = ‘FLAG’
  • S = ‘SYNTHESIZED’
  • I = ‘INPUT’
  • E = ‘EXPERIMENTAL’
  • M = ‘MAINTENANCE’
  • B = ‘BEAM’

‘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.

  • Attribute ‘number’

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:

  • A = ‘LAPLACE (RADIANS/SECOND)’
  • B = ‘LAPLACE (HERTZ)’
  • D = ‘DIGITAL (Z-TRANSFORM)’

‘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.

  • Attribute ‘number’

Sequence in range from B053.f9

Sequential row number starting at ‘0’

‘Zero’.’Real’

B053.f10

‘Zero’.’Imaginary’

B053.f11

  • Attribute ‘minusError’

B053.f12

Applied to both ‘Real’ and ‘Imaginary’ elements.

  • Attribute ‘plusError’

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.

  • Attribute ‘number’

Sequence in range from B053.f14

Sequential row number starting at ‘0’

‘Pole’.’Real’

B053.f15

‘Pole.’Imaginary’

B053.f16

  • Attribute ‘minusError’

B053.f17

Applied to both ‘Real’ and ‘Imaginary’ elements.

  • Attribute ‘plusError’

B053.f18

Applied to both ‘Real’ and ‘Imaginary’ elements.

Element ‘Coefficients’

B054

Notes

‘CfTransferFunctionType’

B054.f3

Type code mapping:

  • A = ‘ANALOG (RADIANS/SECOND)’
  • B = ‘ANALOG (HERTZ)’
  • D = ‘DIGITAL’

‘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

  • Attribute ‘minusError’
  • Attribute ‘plusError’

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

  • Attribute ‘minusError’
  • Attribute ‘plusError’

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

  • Attribute ‘minusError’
  • Attribute ‘plusError’

B055.F9

Both attributes are listed and will have the same value in conversion.

‘ResponseListElementType’.’Phase’

B055.F10

  • Attribute ‘minusError’
  • Attribute ‘plusError’

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:

  • A = ‘None’
  • B = ‘ODD’
  • C = ‘EVEN’

‘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

  • Attribute ‘i’

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:

  • M = ‘MACLAURIN’

‘FrequencyLowerBound’

B062.f9

‘FrequencyUpperBound’

B062.f10

‘ApproximationLowerBound’

B062.f11

‘ApproximationUpperBound’

B062.f12

‘MaximumError’

B062.f13

‘Coefficients’

B062.f15

  • Attribute ‘number’

Sequence in range from B062.f14

Sequential row number starting at ‘0’

  • Attribute ‘minusError’
  • Attribute ‘plusError’

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.

Channel Naming Conventions placeholder

_images/Appendix_A_1.png _images/Appendix_A_2.png _images/Appendix_A_3.png _images/Appendix_A_4.png _images/Appendix_A_5.png _images/Appendix_A_6.png _images/Appendix_A_7.png _images/Appendix_A_8.png