====== Diana  ======

Diana is a meteorological visualisation and production software developed at the Norwegian Meteorological Institute (met.no).
Diana is developed for operational use at met.no, and has been used this way since spring 2000. Diana is also used extensively by researchers. It was released as open source under the [[http://www.gnu.org/licenses/old-licenses/gpl-2.0.html|GNU General Public License (GPL)]] in May 2006.

  * Report bugs [[diana@met.no|diana email list]]
  * [[https://github.com/metno/diana|github repository]]
  * [[Installing Diana from Launchpad]]


===== Diana features =====

Combined visualisation of

    * Fields
    * Satellite and radar images
    * Surface observations
    * Trajectories in isosurfaces
    * Weather charts

Separate viewers available for

    * Soundings
    * Vertical cross sections
    * Time series

Editing tools 

    * Field modification
    * Drawing of fronts, weather symbols etc.

Other features 

    * Highly customizable with setup-files
    * Batch version for non-interactive production available

Diana depends on an IT infrastructure, including databases/filesystems for fields, observations and images. There are no acquisition or dissemination tools included.

===== Programming environment =====

  * Linux (We use Ubuntu 18.04 and 20.04)
  * C++ (g++)
  * Qt 5 for GUI and window handling, platform independent
  * Qt OpenGL for hardware-accelerated 2D graphics
  * a few other Free and Open Source libraries (fonts etc.)
  * connections between applications via [[https://github.com/metno/coserver4|coserver]] messages.

See [[https://github.com/metno/diana/blob/master/README.md|README.md]] for build instructions and information about dependencies.

The test data files may be downloaded here:
  * {{ :diana:diana-test-data-20201019T0800.tar.gz | diana-test-data-20201019T0800.tar.gz}}
  * {{ :diana:diana-test-data-20200514T0800.tar.gz | diana-test-data-20200514T0800.tar.gz}} (superseded)
===== Formats =====

  * Field format: NetCDF (CF-1.1 compliant), OpenDAP, Grib1&2
  * Observation format: BUFR (rdb and WMO standard templates), Ascii (simple inhouse format)
  * Satellite and radar images: geotiff, mitiff (tiff with [[http://diana.met.no/mitiff/mitiff.html|geographical header]]), HDF5
  * Maps: ESRI shape, ASCII (simple inhouse format)
  * Weather symbols: ASCII (simple inhouse format)

===== Documentation =====
  * [[GettingStarted|Getting Started]]
  * [[http://diana.met.no/doc/index.html|User guide]]
  * [[http://diana.met.no/triangle.txt|Map format]]
    * See [[Triangle Map Format|]] for clarifications.
  * [[http://diana.met.no/mitiff/mitiff.html|mitiff]] - used for satellite and radar images
  * [[diana_code_doc|Developer Documentation]]
  * [[diana_bufr|BUFR observations in Diana]] 
  * [[diana_references|References]]  

==== Training ====

Some training screencasts are available here:
  * [[https://vimeo.com/507918421/e7cd528b33|Surface analysis]]
  * [[https://vimeo.com/508746318/4353d2505e|FM1 standard and wind]]
  * [[https://vimeo.com/508746726/ef7d4fa029|FM2 clouds]]
  * [[https://vimeo.com/508746771/418b0f0e6a|FM3 indexes]]
  * [[https://vimeo.com/533457908/068299b88f|FM4 Fog]]
  * [[https://vimeo.com/533457976/07e3fa6187|FM5 Jet stream]]
  * [[https://vimeo.com/533454714/d3d05fde86|FM6_Fields menu]]

===== Developers =====
  * [[diana_codestyle|Code style]]

===== Contact information =====
Email: diana@met.no