Welcome to TSMP documentation!

Danger

DEPRECATED: This documentation is deprecated and no longer maintained. Please refer to the updated documentation for current information.

• TSMP2: https://hpscterrsys.github.io/TSMP2

• TSMP-PDAF: https://hpscterrsys.github.io/pdaf

Introduction:

• Introduction to TSMP & TSMP-PDAF
  • TSMP
  • TSMP-PDAF
  • Web Resources
    • Issues
  • TSMP: Introduction from Website
  • Citing TSMP
  • Relevant publications
  • Contributors
  • Additional remark

Getting Started:

• Getting Started
  • General concept
  • The fully coupled pan-European EURO-CORDEX evaluation experiment with TSMP
    • Step 1: Dependencies
    • Step 2: Get the TSMP interface
    • Step 3: Get the component models for this experiment
    • Step 4: Retrieving the test case input data (EURO-CORDEX)
    • Step 5: Build TSMP, interface and component models
    • Step 6: Setup and configuration of the respective usage and test case
    • Step 7: Run the test case
    • Step 8: Simulation results

Technical Note TSMP:

• Coupling approaches
  • Coupling between COSMO and CLM
    • Update of transfer coefficients in COSMO based on CLM surface fluxes.
    • Coupling Time Step
    • Use of same grid between COSMO and CLM
    • Interpolation between COSMO and CLM grids
  • Coupling between CLM and ParFlow

Building TSMP:

• Obtaining the code
  • TSMP
  • TSMP-PDAF
  • Component Models
    • HPSC-TerrSys users
    • External users
• Building TSMP
  • Build script of TSMP
    • Building on GPU
  • Build Examples
    • TSMP Build Examples
    • TSMP-PDAF Build Examples
  • Patching the original source code
  • Automatic Porting of TSMP on x86 machines
• Structure of TSMP
  • Component model directories and PDAF directory
    • TSMP framework
    • TSMP component directory
    • OASIS3-MCT and PDAF directory
    • Example
  • Directory bldsva and subdirectories
    • data_oas3
    • intf_oas3
    • machines
    • setups
    • intf_DA
  • Shell Scripts in bldsva
    • supported_versions.ksh
  • Shell Scripts in subdirectories
    • intf_oas3/common_build_interface.ksh
    • intf_oas3/MODEL/arch/build_interface_MODEL.ksh
    • machines/ARCH/build_interface_ARCH.ksh
    • setups/SETUP/SETUP_setup.ksh
  • Shell script build_tsmp.ksh
    • Routines
    • Features
  • Shell script setup_tsmp.ksh
    • Routines
    • Feature
• Structure of DA inside TSMP
  • arch
  • framework
  • model
  • tsmp
• Structure of PDAF inside TSMP
  • TSMP-PDAF Preprocessor variables
    • Example for setting preprocessor variables
    • CLMSA
    • PARFLOW_STAND_ALONE
    • OBS_ONLY_PARFLOW
    • OBS_ONLY_CLM
    • WATSAT3D
    • CLMFIVE
    • OLD_TRUNCATE_SAT
    • PDAF_DEBUG
  • Call Graph for TSMP-PDAF
  • Important Functions of TSMP-PDAF
    • pdaf_terrsysmp (main program)
    • initialize_tsmp()
  • List of interesting variables of TSMP-PDAF
    • Model Communicator COMM_model
    • AMPS used by ParFlow in TSMP-PDAF
    • CMEM

Setting up TSMP:

• Setup Examples
  • Pan-European EURO-CORDEX
  • Heterogeneous Job using TSMP
  • NRW Test case
    • Retrieving the test case input data (NRW)
    • Setup and configuration of the NRW test case
  • IdealRTD (Idealized) Test case
    • Preprocessing of Input Data
  • IdealScal (Idealized) Test case
    • Running IdealScal Test case
  • Long time climate simulation
    • Implementation of non-const CO2 in TSMP
  • CLM5 in TSMP setup: nrw_5x
  • For ICON Users (HPSC-TerrSys users)
    • Step 0: JUDAC Storage Managment
    • Step 1: Dependencies
    • Step 2: Get the TSMP interface
    • Step 3: Get the component models for this experiment
    • Step 4: Build TSMP, interface and component models
    • Step 5: Setup and configuration of the respective usage and test case
    • Step 6: Run the test case
    • Step 7: Create own case (optional)
  • Setup TSMP-PDAF
  • Day4: Testcase FallSchool 2022
    • Build
  • Setups
    • Setup CORDEX test case for fully coupled TSMP on JUWELS with Oasis3-MCT
    • Setup NRW test case for ParFlow standalone on JURECA
    • Setup NRW test case for new CLM4.0 + Cosmo5.1 on JURECA
    • Setup NRW test case with 24h runtime, 3h wallclock time, latest(lets say 01.07.2016 00:00) Cosmo forcing, ParFlow and CLM restart, fully coupled on JURECA on $WORK
    • Setup NRW test case with 20 member ensemble (parflow) on JURECA, but only use members 10-15. perturbed namelists reside in a special folder
    • Setup NRW spinup with init date (lets say 01.01.2005 00:00) 1 month runtime, 24h wallclock time, restart from arbitrary date (lets say 01.03.2005 00:00) in indexed (3rd) rundir on JURECA
• Running TSMP-PDAF
  • Input files for CLM
  • Input files for ParFlow
  • Input files for COSMO
  • Input files for OASIS-MCT
  • Control file enkfpf.par
    • [PF]
    • [CLM]
    • [COSMO]
    • [DA]
    • Parameter Summary
  • Observation input
    • Observation files
    • Observation time flexibility
    • Specifying type of observation at compile time
  • Command line options
    • n_modeltasks
    • filtertype
    • subtype
    • obs_filename
    • rms_obs
    • delt_obs
    • screen
    • forget
    • locweight
    • cradius
    • sradius
    • Command Line Examples
• Setting up new cases
  • Supporting a new machine
  • Setting up a new experiment

Profiling TSMP:

• JUBE with TSMP

Debugging TSMP:

• Debug tips
  • Debug Tip 1: Skip component models in TSMP-PDAF build
  • Debug Tip 2: Building TSMP-PDAF after source code changes in component models
  • Debug Tip 3: Debugging OASIS3-MCT
  • Debug Tip 4: Debugging CLM (3.5)
  • Debug Tip 5: Debugging PDAF
    • PDAF Debugging Information
    • PDAF’s Timing and Memory output
• Debugging TSMP2-PDAF
  • Debug Tip 1: Build with debug version
  • Debug Tip 2: Building TSMP-PDAF after source code changes in component models
  • Debug Tip 3: Debugging OASIS3-MCT
  • Debug Tip 4: Debugging CLM (3.5)
  • Debug Tip 5: Debugging PDAF
    • Screen variables
    • PDAF Debugging Information
    • PDAF’s Timing and Memory output
• Debugging flags
  • More detailed information
• Debugging with TotalView

Feature Branches:

• CLM5-PDAF Starting instructions
  • 1. Install components
    • 1.1 TSMP-PDAF
    • 1.2 PDAF
    • 1.3 CLM5
    • 1.4 Build CLM5-PDAF
  • 2. File preparation
    • 2.1 Ensemble generation
    • 2.2 Case generation
  • 3. Running the simulation
  • 4. Post-processing the output
  • 5. Example case:

FAQ:

• Contributing to TSMP in general
• Contribute to TSMP documentation.
  • Option 1
  • Option 2
  • Option 3
  • MYST

Misc:

• Misc
  • Gitlab: TSMP-PDAF group
    • Repositories
  • Open loop compilation of (TSMP-)PDAF
  • Scripts and other resources