With the words “weather knows no boundaries”, eight organizations in seven countries sought and were granted funding in 2008 from the European Union’s Baltic Sea Region (BSR) Programme, to network existing weather radars in the region. Weather radar is an active remote sensing technique that allows us to monitor the atmosphere with high resolution in both time and space. Such radars are deployed by the national meteorological (and hydrological) institutes of the respective countries. The radars operate at a frequency of around 5.6 GHz (5 cm wavelength), and have common ranges of 200–250 km, with new data being acquired every 5–15 minutes. Radar-based information helps save lives and property, and it facilitates operations in several weather-dependant sectors of the economy such as aviation, urban water management, radiation and nuclear safety, construction, and recreation.
The approved project, called BALTRAD (not an acronym), marked the first time European structure funds were used to build an element of regional infrastructure in the form of an international weather radar network. BALTRAD also marked the first time that the project partners developed such a system together as a partnership. The BSR required that all outputs be made available openly and freely, which matched the partners’ desire to release the software with an Open Source license. The lifetime of the BALTRAD project was three years (February 2009 to January 2012). Into the third year, the BSR approached the partnership and solicited a second proposal for an extension stage. The result was the BALTRAD+ project that saw both geographical and thematic expansion, now with 13 partners in all 10 BSR countries, and two additional years.
This paper provides a technical reference for the software that comprises a functional member of the network: a so-called “BALTRAD node”, along with an example user application. Following an introduction that provides the historical context, the system’s main design constraints and system components are presented. Establishing a software framework will be highlighted not just for real-time international data exchange but also for data processing. So will the importance of systematic data quality control and characterization, as this is the main scientific innovation achieved by the partnership.
Significant time has passed since the project funding ended, so the software’s reuse potential will be discussed in the light of project vs. post-project realities.
Lead-up to BALTRAD
Weather-radar data have been exchanged in real time in the Nordic collaboration called NORDRAD since the early 1990’s [1, 2]. The first version of the system was developed using the Ada and Pascal programming languages, and it was deployed on VAX-VMS platforms. Data were exchanged over the X.25 protocol using a “notify-pull” mechanism whereby a node broadcasts data availability and those nodes entitled to such data are responsible for fetching the data. The software development and maintenance was performed by a commercial third party on behalf of the NORDRAD members. The first countries to deploy NORDRAD were Finland, Norway, and Sweden. Owing to low network bandwidth, the primary data that were exchanged were so-called CAPPI (Constant Altitude Plan Position Indicator) products, where the radar data’s original spherical coordinate system expressed as elevation angle (from horizontal level), azimuth angle (from true north) and range (distance from the radar’s location) is transformed to a regular Cartesian grid on a horizontal plane at a selected altitude. Each country reprocessed its own CAPPIs together with data from its neighbours, using the common software, to create so-called composite products covering large international domains using a projection and coverage area that was adapted to that country’s needs. This is an example of a decentralized radar network concept.
In the early 2000’s, the second generation NORDRAD system was commissioned, also by a commercial third-party. The decentralized networking concept was preserved, as was the basic data processing approach of exchanging and processing Cartesian data. There were two innovations with this new system: 1) it was Python-based for deployment on Linux platforms with communications using the TCP/IP protocol, and 2) algorithmic improvements from research experiences in the Baltic Sea Experiment  were pulled through to operations [4, 5]. Yet it soon became evident that improved network bandwidth was sufficient to support the exchange of original radar data in spherical coordinates, and that there was much greater potential in harmonizing data quality by accessing and processing such data. At the same time it became increasingly clear to the members, now including Denmark, Estonia, and Latvia, that such functionality could be created collaboratively. An important driving force in the weather radar world, for open and harmonized post-measurement data processing, is the fact that the quality challenges of the measured data are relatively large, especially as great variety exists among the technical and signal-processing properties of the radar systems that establish international networks. Moreover, many weather radar operators and service providers are not able to put major resources in the R&D of new methodologies and algorithms. This led to the BALTRAD and BALTRAD+ projects that acted as development incubators, with a critical mass of resources devoted to establishing the partnership, software system, and weather radar network.
As has been noted in , BALTRAD is one of several open source radar software systems that have emerged in recent years. TITAN  is a system that pioneered the concept of open software for weather radar, and like BALTRAD is deployed in real-time operational environments. Py-ART  and wradlib  are two other packages that have a critical mass of developers and users, mainly for research and development purposes, but also for processing large amounts of archived data.
Implementation and architecture
BALTRAD software is designed to exchange weather radar data in real time. Optionally, a sub-system is responsible for processing data using a common toolbox of algorithms. The same de-centralized networking concept as was applied in NORDRAD has also been used with BALTRAD, such that no individual partner is dependent on another to process data and disseminate radar-based products. A BALTRAD node is an instance of a complete system containing the functionality to exchange and, if desired, process data. BALTRAD software does not interact directly with the weather radar instrument. When the Partnership was formed, and its skill set inventoried, it was found that around half of the developers preferred Python and the other half preferred Java, while there were no objections to C/C++. So the decision was made to create functional sub-systems in any of these languages and ensure that they communicated with each other through well-defined interfaces.
A small package called the node-installer installs a complete functional BALTRAD node. It downloads specific versions of its dependencies (listed below), and provides a robust framework for installing and performing a basic configuration of a node. What follows are brief descriptions of each of the main sub-systems comprising a node, and how they interact. These sub-systems are illustrated in Figure 1.
Data exchange (DEX)
The DEX contains the functionality used to subscribe to and exchange data in real time. In contrast to the NORDRAD “notify-pull” exchange mechanism, we use a “subscribe-push” model over secure network communications. Recalling that the partnership comprises different legal entities in different sovereign states, it is important that the communications contain sufficient security and checks and balances. To summarize:
- Two nodes exchange secure keys, allowing them to transact securely.
- A sender node selectively exposes its data catalogue to another receiver node.
- The receiver node selects which data it wishes to subscribe to.
- The sender node pushes subscribed data to the receiver node in real time.
- The receiver node validates that it has received what it has requested.
This peer-to-peer functionality is achieved in Java using a Tomcat server container. All communications between nodes are conducted through a single open port.
All weather radar data are expected to be exchanged using the modern European HDF5-based standard representation , and it is each partner’s responsibility to convert its data to this ODIM_H5 format before “injecting” the data into their nodes. The partnership has developed converters/injectors in Java and Python for these purposes.
BALTRAD database (bdb)
Each node operates a PostgreSQL database instance that is used to manage all data and metadata. A Python application is responsible for this. Exchanged data entering a node from the DEX are passed to the bdb, the metadata are extracted from ODIM_H5 files to populate database tables, and the ODIM_H5 files themselves are preserved inside the database. This approach allows files to be associated with their metadata quickly, allowing for rapid access to input data by other parts of the node. ODIM_H5 files can be optionally exported to local or remote file system. The bdb interacts with other sub-systems through a RESTful interface.
This sub-system is devoted to interacting with the other system components, to schedule event-based and non-trivial data processing jobs, among other things, without actually running the jobs themselves. This Java application therefore interfaces with the bdb to learn when data are available to trigger such jobs, and they are triggered by messaging the BALTRAD Toolbox. A web-based interface is shared with the DEX for configuring and scheduling the node as a whole, along with different types of data processing jobs. Jobs are defined through this interface either using pre-defined rule-based menus, or through the use of Groovy scripting (based on Java).
An event-based job can be processing data from a single radar site, e.g. generating a Cartesian representation from the data’s original polar geometry. An example of non-trivial scheduling of a job is generating a composite image containing data from many radars; such a job is triggered either when all input data are available, or with those data that have arrived at a specified timeout.
The science of refining radar data into useful information is the responsibility of this software toolbox. It comprises a main package called the Radar Analysis and Visualization Environment (RAVE) along with several add-on packages for processing data for specific purposes. The code base is written in a combination of C and Python, to benefit from the high performance and relatively low memory footprint of C together with the ease of managing the system using Python. In real time, the Toolbox receives job requests from the Beast through an XML-RPC interface to its server, jobs are dispatched to an asynchronous pool of worker processes organized through Python’s multiprocessing module, and output is forwarded to the DEX and on to the bdb. Off-line work, e.g. algorithm development and processing archived data, is performed interactively through the Python interpreter, command-line utilities, or hands-off through scripting.
The Toolbox and its add-ons contains functionality for quality controlling radar data, e.g. identifying and removing non-precipitation echoes , correction due to topographical beam blockage, attenuation correction of conventional reflectivity data, data-quality characterization , and dealiasing of radial velocity data based on . Compositing of data from many radars is supported in different ways, including the ability to use data quality as the main selection criterion (Figure 2).
The functionality for reading and writing data to ODIM_H5 is separated from the data processing. This is done to enable the efficient chaining of processing algorithms in memory, without needing to write temporary/intermediate files to disk, which is achieved through a so-called “quality-plugin” framework.
As part of the extended thematic scope in BALTRAD+, we introduced the BALTRAD Cookbook (URL below) as a collection of openly documented data-processing algorithms, which can serve as a reference collection for implementation in our Toolbox or independently in other software.
BALTRAD software is mostly intended to support various users, but we have also developed specific applications, one being a Web Map Services (WMS) server supporting radiation and nuclear safety in Finland, called baltrad-wms and based on an Open Source Geospatial Foundation (OSGeo) MapServer. Radar composites generated by a BALTRAD node are disseminated to a baltrad-wms instance where they are converted from ODIM_H5 to GeoTIFF format and displayed (Figure 3).
Each of the sub-systems requires that unit tests be written. This is done using JUnit for Java and unittest for Python. Most developers apply agile methods when developing the system, to ensure that the system components achieve stable and consistent interfaces as early as possible, and to introduce new functionality in many small iterations. During the most intense development phase, lasting over a year, new versions of the node-installer were released and deployed live every two weeks. Project infrastructure supporting the development includes a dedicated Git server together with a Jenkins continuous integration server. Code coverage output is given for Java. Tickets are written and managed using a Trac server, which also hosts the BALTRAD Cookbook using its wiki functionality.
Anyone is able to clone any of the software packages on the BALTRAD Git server; authorized users can push new commits. Each new commit triggers Jenkins to build the package and run its unit tests. The fundamental criterion that decides if new changes are acceptable is if all the unit tests pass; this will automatically merge the changes into the master branch. Jenkins also performs a nightly build and test run for the most important system components.
Linux, preferably 64-bit
Gnu C/C++ 4.1+
Python 2.6 and 2.7 (migration to 3.5 underway)
Additional system requirements
Java SDK 1.6+
Gnu make 3.8+
Unicode support (ICU)
bzip2 development libraries
PostgreSQL development libraries
The following packages and their exact versions are managed by the BALTRAD node-installer, although more recent versions are also known to work.
Apache ant 1.8.0
Apache Tomcat 7.0.64
Python Imaging Library 1.1.7
ASN.1 Library for Python 0.1.2
Python 2.6.4 or 2.7.2
setuptools for Python 2.7
Additional optional dependencies are required for certain features.
List of contributors
- Rasphal Gill and Martin Sørensen, Danish Meteorological Institute, Copenhagen, Denmark
- Harri Hohti and Markus Peura, Finnish Meteorological Institute, Helsinki, Finland
- Iwan Holleman, Radboud University, Nijmegen, Netherlands
- Daniel Johnson, Ulf Nordh, Lars Norin, Mats Sundqvist, and Mats Vernersson, Swedish Meteorological and Hydrological Institute, Norrköping, Sweden
- Tomasz Sznajderski and Łukasz Wojtas, Institute of Meteorology and Water Management, Warsaw, Poland
(e.g. institutional repository, general repository) (required – please see instructions on journal website for depositing archive copy of software in a suitable repository)
Licence: CC-BY 4.0
Publisher: Swedish Meteorological and Hydrological Institute, on behalf of the BALTRAD Partnership
Version published: 2.2.1
Date published: 19/02/18
(e.g. SourceForge, GitHub etc.) (required)
Name: BALTRAD Git
Licence: Lesser Gnu General Public Licence
Date published: 26/08/16
(3) Reuse potential
Externally-funded development projects are extremely useful in creating a critical mass of people and resources that can be used to create new outputs quickly and with high priority; the BALTRAD and BALTRAD+ projects were successful in this regard. The critical moment comes when the projects end and the partner organizations assume responsibility for the operations, maintenance, and continued development of the project outputs. This is particularly sensitive if the outputs have been created by the partners themselves, and are not subject to any commercial service-level agreement. It is common for interest to wane at this point, so the challenge becomes one of ensuring that the resources are secured by each partner to continue contributing to the collaborative effort. The BALTRAD Cooperation Agreement has been written and signed by the partners to meet this challenge. The radar network continues to operate, and the software is being maintained and further developed. What follows are examples of not just potential reuse, but real reuse of BALTRAD outputs.
Before the end of the BALTRAD+ project, the Central Aerological Observatory of the Russian Federation joined the partnership, deployed a BALTRAD node, and started exchanging Russian weather-radar data with other partners. By the end of the project, data from 60 radars in ten countries were being exchanged, with data from eight additional specialized X-band radars in Denmark supporting urban hydrology.
The network of European National Meteorological Services (EUMETNET) and its project for weather radar called OPERA  are responsible for a centralized European facility for collecting and generating European continental radar composite products. This service, called Odyssey and hosted jointly by Météo France and the United Kingdom Meteorological Office, has deployed the BALTRAD Toolbox operationally to quality control all available input radar data before European composites are generated on behalf of its members.
In 2014, the first Open Source Radar Software short course was held in association with a major radar conference. Contributors created an Open Radar Virtual Machine in which software presented in  was installed and made openly and freely available . This solution has been proven useful at this short course and others that have followed, through Jupyter notebooks that run BALTRAD, Py-ART  and wradlib  software and visualize the results. Interoperability between these packages is also highlighted at these courses, an example of which is given in Figure 4.
Recently, the BALTRAD Toolbox was deployed in Canada to support the assimilation of weather radar data in numerical weather prediction. File-format decodes were required for North American data to provide input data in ODIM_H5, and the NEXRAD Level II decode from Py-ART  is another good example of reuse for this purpose. Once this was achieved, the Toolbox was able to process Canadian and American data with the advantages of the BALTRAD data-quality processing framework (Figure 2). This is, in principle, the same quality-control approach as that already taken in Europe .
Additional reuse potential is based on the free and open availability of the software, and through its availability as part of the Open Radar Virtual Machine, in operational real-time environments, or in academic/educational settings.
Finally, the legacy NORDRAD system was decommissioned in early 2017, marking reliance on BALTRAD as the fully-operational system for weather-radar networking in the BSR.
- FAQ, User Guide, and rendered inline documentation: http://git.baltrad.eu/
- BALTRAD Cookbook: http://git.baltrad.eu/trac/wiki/cookbook
- Google Group: firstname.lastname@example.org
- Support: email@example.com
- BALTRAD and BALTRAD+ project information: http://www.baltrad.eu/
- Open Radar Virtual Machine: http://openradarscience.org/vm-docs/