:allow_comments: False .. _doc_about_intro: Introduction ============ .. figure:: ./figs/Rautenhaus_etAl_2015_04.webp :figwidth: 30% :align: right :alt: Figure from Rautenhaus et al. (2015) .. figure:: ./figs/Rautenhaus_etAl_2015_02.webp :figwidth: 30% :align: right :alt: Figure from Rautenhaus et al. (2015) Welcome to the documentation of Met.3D, the **open-source visualization research software** for **interactive, three-dimensional visual analysis** of **gridded atmospheric data**. Before you start ---------------- The :doc:`/02_getting_started/index` page is the best place to start if you are new to Met.3D. You will find :doc:`/02_getting_started/installation/index` instructions and a tutorial for :doc:`/02_getting_started/first_steps`. .. note:: The documentation you are reading is **work in progress**. We are adding bits and pieces whenever we find time. If you don't find the information you are looking for, please `contact us `_. If you like to contribute to the documentation, please let us know as well! About Met.3D ------------ Met.3D is being developed as a research effort to improve visual analysis of 3-D meteorological data in research and forecasting. The software is implemented in `C++`_ and `OpenGL 4`_ and runs on standard commodity hardware. Its only "special" requirement is an OpenGL 4.3 capable graphics card. Met.3D currently runs under Linux. It has originally been designed for weather forecasting during atmospheric research field campaigns, however, is not restricted to this application anymore. Besides being used as a visualization tool, Met.3D is intended to serve as a framework to implement and evaluate new 3-D and ensemble visualization techniques for the atmospheric sciences. Met.3D development is lead by the `Visual Data Analysis Group`_ at the `Hub of Computing and Data Science`_ of the `University of Hamburg`_ (UHH), Germany. Previously, development was also done within the `Computing Graphics & Visualization Group`_ of the `Technical University of Munich`_ (TUM), Germany. We much acknowledge funding we have received from the German Research Foundation (DFG), from 2015 until 2024 within the Collaborative Research Centre SFB/TRR 165 `Waves to Weather`_ (both at UHH and TUM), and ongoing within the UHH Cluster of Excellence `CLICCS`_. Previously, development at TUM was also partly funded by the European Union under the ERC Advanced Grant 291372 SaferVis and the ERC Proof-of-Concept Grant "Vis4Weather". Met.3D research and development is led by `Marc Rautenhaus`_, UHH (previously TUM). Organization of the documentation --------------------------------- The documentation for Met.3D is organized into the following sections: * The :doc:`/02_getting_started/index` section provides :doc:`/02_getting_started/installation/index` instructions, and a tutorial for :doc:`/02_getting_started/first_steps`. * Read the *User Manual* if you are a user (e.g., an atmospheric researcher, meteorology student, interested lay person). It provides information about :doc:`supported data `, :doc:`user interface components `, and :doc:`visualization modules ` of Met.3D. * The *Contributing* section provides information on how to contribute to Met.3D. Please carefully read the information about the GIT workflow and about our coding conventions. * Finally, the *Developer Manual* contains information about the internal structure of Met.3D, including system modules, data pipeline, and actors. Conceptual descriptions of the architecture of selected features in Met.3D are provided in :doc:`/05_developer_manual/architecture_overview`. Note that large parts of the Met.3D source code have been documented with the `Doxygen`_ code documentation system. A `Doxygen`_ configuration file is available in the `Met.3D repository`_ (in the ``doc/doxygen`` subdirectory). Please run `Doxygen`_ locally to build the corresponding documentation. .. _Doxygen: http://www.stack.nl/~dimitri/doxygen/ .. _Met.3D repository: https://gitlab.com/wxmetvis/met.3d/ In addition to this documentation, you may also want to take a look at the reference publication. Also, Marc's PhD thesis contains additional details. * Rautenhaus, M., Kern, M., Schäfler, A., and Westermann, R.: **Three-dimensional visualization of ensemble weather forecasts -- Part 1: The visualization tool Met.3D (version 1.0)**, `Geosci. Model Dev., 8, 2329-2353`_, doi:10.5194/gmd-8-2329-2015, 2015. * Rautenhaus, M.: **Interactive 3D visualization of ensemble weather forecasts**, `Ph.D. thesis`_, Technical University of Munich, Munich, Germany, 195pp., 2015. Credits ------- The Met.3D core development team currently consists of: * `Marc Rautenhaus`_, UHH * `Thorwin Vogt`_, UHH * `Christoph Fischer`_, UHH * Maximilian Hartz, UHH student We acknowledge the following individuals for their contribution: * Andreas Beckert, UHH (former core member - many thanks!) * Susanne Fuchs, UHH (former core member - many thanks!) * Kamesh Modali, UHH (former core member - many thanks!) * Justus Jakobi, UHH student * Alexander Klassen, UHH student * Jonas Lefert, UHH student * Marcel Meyer, UHH * Michael Kern, TUM (former core member - many thanks!) * Alexander Kumpf, TUM (former core member - many thanks!) * Bianca Tost, TUM (former core member - many thanks!) * Mathias Kanzler, TUM * Florian Ferstl, TUM * Fabian Schöttl, TUM student * Christoph Heidelmann, TUM student * Florian Hauer, TUM student * Max Bandle, TUM student * Jessica Blankenburg, TUM student * Raphael Kriegmair, LMU student * Philipp Kaiser, TUM student * Theresa Diefenbach, LMU student * Robert Redl, LMU * Alexander Thole, TUM student We acknowledge support from `ECMWF `_, in particular by Tim Hewson and Stephan Siemen and his group. Access to ECMWF data for our work has been kindly provided in the context of the ECMWF special project "Support Tool for HALO Missions". .. _C++: https://isocpp.org/ .. _OpenGL 4: https://www.opengl.org/ .. _Geosci. Model Dev., 8, 2329-2353: http://www.geosci-model-dev.net/8/2329/2015/gmd-8-2329-2015.html .. _Geosci. Model Dev., 8, 2355-2377: http://www.geosci-model-dev.net/8/2355/2015/gmd-8-2355-2015.html .. _ECMWF Newsletter, vol. 138 (Winter 2014): http://www.ecmwf.int/en/elibrary/14581-newsletter-no138-winter-2013/14 .. _Visual Data Analysis Group: https://www.hcds.uni-hamburg.de/en/research/1fg-vda.html .. _Hub of Computing and Data Science: https://www.hcds.uni-hamburg.de/en.html .. _University of Hamburg: https://www.uni-hamburg.de/en.html .. _Computing Graphics & Visualization Group: https://www.cs.cit.tum.de/cg/cover-page/ .. _Technical University of Munich: https://www.tum.de/ .. _Waves to Weather: http://www.wavestoweather.de/ .. _CLICCS: https://www.cliccs.uni-hamburg.de/research/computing/visualization.html .. _Marc Rautenhaus: https://www.hcds.uni-hamburg.de/en/research/1fg-vda/people/rautenhaus.html .. _Ph.D. thesis: http://mediatum.ub.tum.de/?id=1253343 .. _Thorwin Vogt: https://www.hcds.uni-hamburg.de/en/research/1fg-vda/people/vogt.html .. _Christoph Fischer: https://www.hcds.uni-hamburg.de/en/research/1fg-vda/people/fischer.html