Radar Altimeter Database System (RADS)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

README.md

rads

The Radar Altimeter Database System (RADS) was developed by the Delft Institute for Earth-Oriented Space Research, the NOAA Laboratory for Satellite Altimetry, and EUMETSAT. Apart from actual altimeter data, RADS provides here a suite of applications and subroutines that simplify the reading, editing and handling of data from various radar altimeters. Although the actual content and layout of the underlying data products do not have to be identical for all altimeters, the user interface is. Also, the data base is easily expandable with additional data and/or additional corrections without impact to the user interface, or to the software in general. In fact, only in very few cases the software will need to be adjusted and recompiled, in even fewer cases adjustments to the actual tools will be required.

Development

The RADS database and code has gone through various generations. NetCDF datasets were introduced in version 3, while the software more or less stayed the same as in version 2. This new version is a complete rewrite of the code, making it much easier to configure, handle, and expand, and for the first time taking all the advantages of the underlying NetCDF data and the linear algebra provided by Fortran 90.

Documentation

There are two manuals that cover the use of the RADS software and the contents of the RADS data base:

Requirements

The only requirements to compile and run the code are:

  • A unix type environment (Linux, Mac OS X, etc.).
  • The make command.
  • A fortran compiler (preferrably gfortran, but others like f90, f95, xlf90, xlf95 and ifort are known to work as well)
  • The NetCDF library (version 4.3 or later) and together with the Fortran 90 interface and module file.
  • Optionally, the git program.
  • For downloading and synchronising the data base: the rsync program.

Distribution

Tarballs are released on GitHub 'releases' page.

Bug reports and feature requests

Please submit your bug reports or feature requests, and track existing ones, on the GitHub 'issues' page. To add content will need to sign up to GitHub.

Version History

Following is a history of releases on GitHub, newest to oldest.

v4.3.3 (19 Nov 2018)

  • Added new optional argument varid to rads_def_var routine (fixed bug issue #139).

v4.3.2 (7 Nov 2018)

  • New mission definitions for Sentinel-3B.
  • Do not store output varid in rads_varinfo struct, but determine as needed (fixed issue #126 and #138).
  • Update data manual on Sentinel-3A and -3B (fixed issue #131).
  • Specify separate flag_meanings for each mission (fixed issue #132).

v4.3.1 (4 Sep 2018)

  • New mission phase definition for Jason-2 Phase D.
  • New mission definitions for Sentinel-3B.
  • Added optional argument "deflate" to nf90_def_axis.
  • Replaced iqsort by more stable version of quicksort (fixed issue #127).
  • No more duplicate tracks in radsxogen when generating single- and dual-satellite xovers (fixed issue #129).
  • Documented the --reject-on-nan=all option in radscolin4.

v4.3.0 (30 May 2018)

  • Added support for processing of Sentinel-3B data.
  • Added routine rads_set_phase.
  • Added <end_time> specifications on last mission phase of terminated missions.
  • Added license file.
  • Added geoid_xgm2016 specification in support of issue #119.
  • Added topo_strm15plus specification in support of issue #120.
  • Fixed issue #121.

v4.2.11 (16 Mar 2018)

  • Updated information on Sentinel-3B orbit and mission phases.
  • Provide better "histogram limits" from radsvar.
  • Changed format for all time fields in 1985 seconds, so they do not overrun the maximum number of characters.
  • Changed the reference frame offset for Sentinel-3A from 27 mm to 2 mm.
  • Polishing of manuals

v4.2.10 (1 Jan 2018)

  • Copyright updated to 2018
  • Increased number of cycles for CryoSat-2

v4.2.9 (30 Nov 2017)

  • Replaced freeunit() by getlun()
  • Added standard_name and axis attributes when writing lat/lon grids
  • Added valid_min, valid_max, grid_step attributes to output grids. Removed actual_range.
  • Many changes to the developer code to produce the Nov 2017 updates; see there for more information.
  • Changes to configuration file (rads.xml) in accordance with the Nov 2017 updates.

v4.2.8 (12 Sep 2017)

  • Fixed information on Jason-2 Phase C in rads.xml

v4.2.7 (7 Sep 2017)

  • Updates for Jason-2 Phase C ("tango")
  • Added definition of qual_alt_rain_ice and qual_rad_rain_ice to Sentinel-3.

v4.2.6 (27 Aug 2017)

  • New features in radscolin: --diff-no-coord and --diff1.
  • Numerous updates for the generation of RADS data for Sentinel-3, Jason-2, and Jason-3.
  • New variables for modern mean sea surfaces and tide models.
  • Updates to user and data manuals.

v4.2.5 (6 Oct 2016)

  • Updates to manuals (e.g., issue #99).
  • Numerous updates for the generation of RADS data for Sentinel-3 and Jason-3 (developer tools only).
  • Bug fix: nesting of <if> tags could go wrong when reading XML files.
  • Installation: use nc-config if nf-config is not supplied.
  • Adjustments for SARAL Drift Mission.
  • Preparation for Jason-2 Interleaved Mission.

v4.2.4 (6 June 2016)

  • Bug fix (issue #97), which prevented radsxogen from running properly. This error was introduced in the master on 1 May 2016 (v4.2.2).
  • Enhancements to the user manual.

v4.2.3 (29 May 2016)

  • Bug fix (issue #96), which prevented installation of symbolic links within shells other than bash.

v4.2.2 (24 May 2016)

  • Updated Jason-1 SLCCI orbits to Version 11 for ERS-1, ERS-2, Envisat, Jason-1, Jason-2, and TOPEX/Poseidon.
  • Changed reference frame offset for CryoSat-2 Baseline C data from -26 to -34 mm.
  • Major additions to the user manual.
  • Changes and additions to configuration files for Jason-3 and Sentinel-3A.
  • All help output to be sent to standard output (not standard error).
  • rads2grd: --fmt replaced by --line-format, variable name in NetCDF now always ${var}_mean and ${var}_stddev, even when only one variable is used.
  • Updated global attributes to be written in new NetCDF files.
  • --quality_flag replaced by --quality-flag (with backward compatibility).
  • Made adaptations for Jason-1 GDR-E (to be released later).
  • Change format of time field to f17.6 in advance of 2016-09-09 when extra digit will be added.
  • Bug fix (issue #89).
  • Bug fix: updated missing building dependencies.

v4.2.1 (22 Mar 2016)

  • Moved directory "include" to "src/include" to avoid clash with default location for "include".
  • Updated information on Sentinel-3A.
  • Made clearer that -- can be used ahead of FILENAME argument to make sure that the option list is terminated; this addressed issue #85.
  • When opening XML file, skip lines until the first line that contains '<'; this fixed issue #87.
  • rads2asc: added -c and -p as alternatives to -sc and -sp.
  • rads2asc, rads2nc, rads2adr: support --output OUTNAME/ for storing passfiles in directory OUTNAME.
  • radscolin: when using -r# (not -rn or -r0) require at least # tracks, not the minimum of # and the available number of tracks.

v4.2.0 (8 Mar 2016)

  • Tuning for processing of Jason-3 data.
  • Added <plot_range> XML tag, which can be used for generating the right plotting range.
  • Added new functionalities to radsvar (i.e. create output that can be included in batch files).
  • Replaced 'units = "count"' by 'units = "1"' in line with udunits standards.
  • On -S option now allow satellite names with more than 2 characters (e.g. ja3, jason3).
  • Introduced the possibility to read RADS data from multiple directories using a tag like <data branch=".ext">.
  • Allow "single-line" XML tags with "var" option like <limits var="sla" sat="j3">-0.4 0.4</limits>
  • Added s3combine to merge and split Sentinel-3 granules into pass files.
  • Made some changes to rads_gen_s3, rads_gen_c2, ogdrsplit.

v4.1.5 (23 Feb 2016)

  • Added SARAL GDR-E orbits, which are now the default.
  • Further updates for Jason-3.

v4.1.4 (12 Feb 2016)

  • Implement processing of Jason-3 and Sentinel-3 data.
  • Implement satellite codes 'j3' (Jason-3), '3a' (Sentinel-3A), '3b' (Sentinel-3B).
  • Minor bug fixes.

v4.1.3 (1 Dec 2015)

  • Added Jason-2 GDR-E orbits, which are now the default.

v4.1.2 (13 Oct 2015)

  • Bug fixes for 'radscolin --diff -r0' and for 'rads2grd -c'.
  • Add 'configure' to distribution.

v4.1.1 (27 Aug 2015)

  • Bug fixes.
  • Improved warnings for erroneous command line options.
  • Subroutines documented with robodoc headers.
  • Start of RADS User Manual.
  • Installing documents with 'make install'.
  • Removed 'verbose' argument from rads_init.

v4.1.0 (19 Aug 2015)

  • Numerous updates to the database: removed obsolete variables, updated several, introduced new variables.
  • New handling of "long options". For example: can now use either --var=VAR or --var VAR (without = symbol).

v4.0.3 (10 Aug 2015)

  • Improvements to rads_add_surface; new landmask based on GSHHG 2.3.4 introduced.
  • Fixed scaling of water_vapor_rad in rads_gen_j1; affected only cycles 1-283.
  • Updated data manual with GDR-D/E references.

v4.0.2 (25 Jun 2015)

  • Prepared for GCC and GFortran version 5.
  • rads_add_ww3_222 did not properly identify 6-hourly time step for recent grids.
  • Improved module dependencies in Makefiles.
  • Introduced GDR-E orbit for CryoSat-2.

v4.0.1 (29 Apr 2015)

  • Updated the way the version number is determined, using either the version tag in configure.ac or "git describe --tags" when using a git repository.
  • Removed all the SVN $Id$ and $Revision$ tags.
  • Updates for future Jason-3 processing.
  • Updates for processing of CryoSat-2 Baseline C.

v4.0.0 (19 Mar 2015)

  • Import from GoogleCode into GitHub.