Copyright (C) 2015-2017 S[&]T, The Netherlands

                HARP 0.6 Release Notes


HARP is a toolset for ingesting, processing and inter-comparing satellite or
model data against correlative data. The toolset is composed of a set of
command line tools and a library of analysis functions. The main goal of HARP
is to assist in the inter-comparison of data sets. By appropriatelty chaining
calls to the HARP command line tools one can preprocess satellite, model,
and/or correlative data such that two datasets that need to be compared end
up having the same temporal/spatial grid, same data format/structure, and
same physical unit.

This version of HARP is still a beta release. HARP still lacks a few
components (see below), but these are planned to be added in the near future.

The main functionalities of HARP are:
 - ingestion of product data for:
   - ACE FTS L2
   - ACTRIS CLOUDS L2
   - ADM-Aeolus L1b/L2a/L2b
   - Aura OMI/TES/MLS/HIRDLS L2 + OMI L3
   - CALIPSO (Lidar L2)
   - ECMF GRIB (includes CAMS global model data)
   - ENVISAT GOMOS/MIPAS/SCIAMACHY L1/L2
   - ERS GOME L1/L2
   - ESA CCI Aerosol/Cloud/GHG/Ozone
   - GOSAT FTS L1/L2
   - Metop GOME-2/IASI L1/L2
   - NDACC FTIR/Lidar/MWR/UVVIS-DOAS data (GEOMS format)
   - NPP Suomi (CrIS/OMPS/VIIRS) L2
   - ODIN OSIRIS/SMR L2
   - QA4ECV NO2/HCHO L2
   - Sentinel 5P L1/L2
   - TEMIS ozone fields
 - import/export of data from/into HARP-specific data format
   The HARP data format standard is a convention on top of netCDF3/HDF4/HDF5
   similar to netCDF-CF (and can be used in conjunction with netCDF-CF).
 - advanced filtering of product data
 - automatic unit conversion of quantities using udunits2
 - automatic generation of quantities ('derived variables') based on
   available product data: you just say which quantity you want, and if HARP
   has an algorithm for it and the necessary inputs quantities are in the
   product, HARP will automatically do all calculations for you
 - performing regridding operations
 - vertical smoothing of atmospheric profiles
 - built-in AFGL86 and USSTD76 climatology data
 - C Library interface to all core functionality
 - direct ingestion/import/export interfaces for:
   - Python
 - command line tools harpcheck, harpcollocate, harpconvert, harpdump,
   harpfilter, and harpmerge
 - extensive documentation, including specification of algorithms used for
   the variable derivations.

Note that HARP is meant as a successor to the BEAT-II interface of the ESA
Atmospheric Toolbox, which means that BEAT-II will at some point become
deprecated and will no longer receive updates.


Restrictions
============

Note that this version of HARP is not yet feature complete.
The direct ingestion/import/export interfaces for MATLAB and IDL are planned
to be added in an upcoming release.


Installation
============

Installation instructions can be found in the HARP documentation or the
INSTALL file.


Documentation
=============

Full documentation in HTML is included with the HARP software.

An online version of the documentation matching the latest development
status on GitHub can be viewed at:

    https://cdn.rawgit.com/stcorp/harp/master/doc/html/index.html


Download
========

The HARP software can be downloaded from GitHub:

    https://github.com/stcorp/harp/releases/latest


If you encounter any issues with the toolkit or if you would like to see
certain functionality added, let us know at:

    harp@stcorp.nl


HARP Developers
S[&]T, The Netherlands