The Terrestrial System Modeling Platform (TSMP or TerrSysMP) is a scale-consistent, highly modular, massively parallel, fully integrated soil-vegetation-atmosphere modeling system.
TSMP implements a physically-based representation of transport processes of water, energy and momentum across scales down to sub-km resolution including explicit feedbacks between groundwater, the land surface and atmosphere with a focus on the terrestrial hydrological and energy cycles. TSMP currently comprises three component models: The Consortium for Small-scale Modeling (COSMO) atmospheric model, the Comunity Land Model (CLM), and the hydrologic model ParFlow ParFlow coupled with OASIS3-MCT coupler and data assimilation capabilities through the Parallel Data Assimilation Framework (PDAF).
TSMP is extensively used for idealized and real data process and sensitivity studies in water cycle research, for climate change simulations, data assimilation studies including reanalyses, as well as experimental real time forecasting and monitoring simulations, ranging from individual catchments to continental model domains.
TSMP provides all features of the respective component models and tries to follow ongoing component model developments continuously.
Initial presentation of the functionalities of the fully coupled TSMP The capabilities of the coupled in systems are presented through idealized studies on key hydrologic processes (runoff production at different hydrological modeling scales, water table changes through groundwater pumping) and their interplay with processes in the atmospheric boundary layer. First real data experiments over the Rur river catchment are also presented.
Groundwater-land surface-atmosphere feedbacks during the European 2003 heat wave This study applies TSMP for the first time over the 12km European EURO-CORDEX EUR-11 domain during the 2003 heat wave event in order to investigate the effects of various lower boundary conditions and physical groundwater representations (full 3D vs free drainage) on land-atmosphere coupling, i.e. soil moisture-temperature feedbacks specifically.
Implementation of PDAF data assimilation into TSMP A synthetic case study for a land surface–subsurface system (0.8 million unknowns) is used to demonstrate the effects of data assimilation in the integrated model TSMP and to assess the scaling behaviour of the data assimilation system.
Pan-European groundwater-to-atmosphere climatology This study provides the first simulated long-term (23 years), high-resolution terrestrial groundwater-to-atmosphere climatology, comprising all variables from groundwater across the land surface into the atmosphere. The data set offers an unprecedented opportunity to test hypotheses related to short- and long-range range feedback processes in space and time between different compartments of the terrestrial system. The dataset is available for download through the Data Publication Server Forschungszentrum Juelich. TSMP has been driven by ERA-Interim reanalysis on the EURO-CORDEX EUR-11 grid from 1989 to 2018, adhering to the simulation protocol of the EURO-CORDEX evaluation runs. Extensive postprocessed model outputs are available through the datapub repository of the Juelich Supercomputing Centre: https://datapub.fz-juelich.de/slts/cordex/index.html.
TSMP as a regional and continental monitoring and forecasting system In this study TSMP is implemented over a 1km convection permitting resolution model domain over North Rhine-Westphalia, Germany, and a second, European model domain at 12km. We document the complete monitoring and forecasting workflow. The experimental forecasting products provide complementary, additional variables, such as plant available soil water, groundwater table depth, and groundwater recharge and storage, which are usually not available.
TSMP is an open-source, community integrated model that is freely available GitHub. Starting in 2010, it was developed within the Collaborative Research Centre (TR32) project, funded by the German Research Foundation (DFG). Ever since then, TSMP development has been driven by groups within the Centre for High-Performance Scientific Computing in Terrestrial Systems, as part of the Geoverbund ABC/J, the geoscientific network of the University of Cologne, Bonn University, RWTH Aachen University, and the Research Centre Jülich. The current team is anchored in Jülich and Bonn.
TSMP is a coupled model, which connects independently developed component models via an external coupler. What we provide, due to licensing constraints and model system maintenance necessities, as the TSMP "model system" is essentially an interface, i.e., a complete built system, incl. all relevant scripts and software patches to retrieve the various component models, patch them to make them TSMP compatible and compile them into the TSMP model system including run control scripts and test setups. Only a limited number of model version combinations are supported, albeit featuring usually very recent if not the most recent component model versions. A complete table is to come soon. For example a very commonly used combination of component models in past studies with TSMP v1.1.0 has been COSMO v4.21, CLM v3.5, and ParFlow v3.1. Please note while we provide a scripting solution to retrieve the suitable versions of the respective component models, the users themselves have to take care of having the appropriate license.
TSMP is available as open source code for free from GitHub (https://github.com/HPSCTerrSys/TSMP), including documentation, pre- and post-processing tools, as well as example test cases that feature different model uses to get started.
Another way to obtain TSMP is through a Linux virtual machine, which contains a ready-to-run TSMP environment for a complex TSMP-PDAF data assimilation tutorial test case, available through the DataPub website at JSC (https://datapub.fz-juelich.de/slts/tsmp-vm/index.html).
TSMP is released under the MIT license.
If you use TSMP in a publication, please cite the these papers that describe the model's basic functionalities:
To report bugs, request features, or ask a question in relation to model implementation or usage, please send an e-mail to email@example.com. Please note that TSMP is a community supported research code and while we will attempt to answer questions your patience is appreciated.
The individual component models documentations are fully applicable as each component model still uses its own namelist, etc. Hence to use TSMP these manuals are an absolute requirement:
List of publications that use TSMP: