NOTE: 2016-06-23
52°North is migrating this TWiki to foswiki which will become availabe via the well known domain soon.
Hence, this wiki is switched to read-only mode starting Monday - 27.06.2016 - until the end of the migration. Hence, save your changes beforehand.

The 52°North IT-Team.


The Sensor Observable Registry (SOR) is a web service interface for managing the definitions of phenomena measured by sensors as well as exploring semantic relationships between these phenomena. The current implementation is based on the OGC discussion paper 09-112 ( download) and presents a pragmatic solution that may serve as the basis for further discussion and development.

The specification

SOR is currently a discussion paper with the OGC and can be downloaded from the OGC website. The paper contains extensive descriptions of the service operations (requests and responses) for GET, POST, and RESTful methods.


... about the data, where it comes from and what is actually there ...


The schema files (one for each operation) are located in the repository folder SOR/schemas/sor. An ant build-file to create XML Beans can be found at SOR/schemas/build.xml, it copies the sorXBs.jar directly into the folder .../WEB-INF/lib.

The schemas are available online for validation at and the namespace is You can use these schemas for direct validation by including the root schema document into the XML documents, e.g. xsi:schemaLocation="".


As the 52°North SOR does currently not utilize any kind of database, so you only need to deploy the attached .war file to a Tomcat of your choice. If you make changes to the code, you can easily use the Eclipse functionality File > Export > Export to WAR file to create it.

Build Process

ALERT! The build process has been moved to Maven - please contact the developers directly until this page is updated. ALERT!

If new properties are added to the configuration file, the must be added to both the one in .../WebContent and the one in .../build, as the former is used for builds within Eclipse (and running the service locally from within Eclipse) and the latter for the build via Ant.

Furthermore, the build-folder contains an adapted log configuration (default level warn), a sample properties file, and a file which is autmatically updated if the build script is run and saves information about build time and number, which is included in the element display-name in web.xml file.

Requirements for Installation

  • Tomcat, Version >= 6
  • Text editor for changing settings (see section below).


The location of the main config file is .../WEB-INF/conf/sor.config. Here you find all important settings for the service. At the current state, you only (!) need to set SERVICEURL (and possibly the service endpoints) to the correct URL. This is for client requests and the capabilities document, and it has to match the settings in web.xml and the name of the web application in the Tomcat.

Warning, important All (other) settings should be handled with care.

Warning, important Check the debug configuration in the file .../WEB-INF/classes/log4j.xml, because a high priority mode (e.g. debug) can considerably slow down the service!

You can change the content of the capabilities document in the file .../WEB-INF/conf/sorCapabilitiesSkeleten.xml. Apart from the URLs, keywords, application domain, ontology URL, and the sor:Contents section, which will both be replaced/created during runtime using the settings in sor.config and the actual values of the used data set, all information remains unprocessed. So unprocessed information really boils down to contact information.



  • 0.4.0
    • Switched to Maven build process
    • Changed logging to slf4j
  • 0.5


See SensorObservableRegistryArchitecture.

Development Instructions

SOR is a Maven module in the OpenSensorSearch project. Please make sure to check the project out as a Maven project or use "File > Import > Import existing Maven projects into workspace" if you checked out the project without Maven.

Please follow the internal guidelines: DeveloperInformation and QualityManagement.

Roadmap and Tasks


A coarse list of possible directions for future development and features for the implementation is as follows:

  • XML database
  • Implement more features of OWS common (i.e. the update sequence parameter)
  • Implement test which checks the content of responses ( Is the inserted/deleted definition really (not) there (anymore)?)
  • ... (please feel free to continue)


  • Implementation
    • Support for multiple data files
    • Base identifiers on URLs instead of URNs (AirBase SOS compatible)
  • Content (SJ)
    • SWE Dictionary (SWSL user survey?)
    • Environmental Noise Dictionary (Italian guys)
    • Synchronise contents with existing SOS, SES, SPS instances
    • Dictionary für EEA AirBase data on the basis of ..._measurement_configurations.csv
Topic attachments
I Attachment Action Size Date Who Comment
Unknown file formatwar SOR.war manage 20539.8 K 2010-11-15 - 09:40 DanielNuest Deployable WAR file
Unknown file formatPNG client.PNG manage 22.5 K 2010-08-25 - 16:13 DanielNuest Class diagram for package "client"
Unknown file formatPNG datastructures.PNG manage 6.3 K 2010-08-25 - 16:13 DanielNuest Class diagram for package "datastructures"
Unknown file formatPNG decoder.PNG manage 1.6 K 2010-08-25 - 16:57 DanielNuest Class diagram for package "decoder"
Unknown file formatPNG listener.PNG manage 6.8 K 2010-08-25 - 16:58 DanielNuest Class diagram for package "listener"
Unknown file formatPNG reasoner.PNG manage 8.3 K 2010-08-25 - 16:58 DanielNuest Class diagram for package "reasoner"
Unknown file formatPNG request.PNG manage 20.8 K 2010-08-25 - 16:58 DanielNuest Class diagram for package "request"
Unknown file formatPNG response.PNG manage 19.8 K 2010-08-25 - 16:58 DanielNuest Class diagram for package "response"
Unknown file formatPNG sor.PNG manage 14.9 K 2010-08-25 - 16:59 DanielNuest Class diagram for package "sor"
Unknown file formateap sor.eap manage 2530.0 K 2010-08-25 - 16:12 DanielNuest Enterprise Architect Project of SOR
Unknown file formatPNG test.PNG manage 7.8 K 2010-08-25 - 16:59 DanielNuest Class diagram for package "test"
Unknown file formatPNG util.PNG manage 7.4 K 2010-08-25 - 16:59 DanielNuest Class diagram for package "util"
create new tag
, view all tags
Topic revision: r21 - 2013-12-21 - 19:42:42 - DanielNuest

  • Search: 
This site is powered by the TWiki collaboration platform Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback