Skip to content
yazan-iris edited this page Aug 7, 2017 · 22 revisions

Welcome to the StationXML-Validation wiki!

Overview

The IRIS StationXML Validator is a Java library and related command-line tool for validating FDSN StationXML documents. The purpose is ensure that the metadata is complete and formatted sufficiently for acceptance at the IRIS DMC.

Downloading releases

Releases of the StationXML Validator can be downloaded from the project release page:

https://github.com/iris-edu/StationXML-Validator/releases

The compiled .jar may be used immediately.

If you wish to compile you can download the source code and follow the instructions below.

Using the Validator

The command line version of the Validator requires Java. A usage message will be printed if no arguments are supplied:

java -jar stationxml-validator-1.0.2.jar

To validate a StationXML file simply provide the name of the StationXML formatted document on the command line:

java -jar stationxml-validator-1.0.2.jar IU.ANMO.00.BHZ.xml

Validation tests

The validator performs a number of tests starting with validation with the StationXML schema followed by a number of other tests to ensure completeness sufficient for long-term archiving. All tests with descriptions are listed on the page below:

Validation tests

Convention for Units

The Validator includes a rule to check the unit names specified in StationXML metadata. The guidelines for unit names and the list of accepted names are available on the page below:

Unit name overview for IRIS StationXML validator

Building the command line validator from source

The build the command line validator from source code you will need a working Java Development Kit (JDK) and Apache Maven. The validator can be built using these steps:

  1. Download source code and untar/unzip, either a release or clone the repository
  2. Change to the created StationXML-Validator- directory
  3. mvn clean install

The resulting jar is under the target directory, e.g. stationxml-validtor-.jar