TITAN2D

Description

From the TITAN2D manual: TITAN2D was developed for the purpose of simulating granular flows (primarily geological mass flows such as debris avalanches and landslides) over digital elevation models of natural terrain. The code is designed to help scientists and civil protection authorities assess the risk of, and mitigate, hazards due to dry debris flows and avalanches. TITAN2D combines numerical simulations of a flow with digital elevation data of natural terrain supported through a Geographical Information System (GIS) interface.

Version

  • 2.0.1b

Authorized Users

  • CIRCE account holders
  • SC account holders

Platforms

  • CIRCE cluster
  • SC cluster

Modules

TITAN2D requires the following module file to run:

  • apps/titan/2.0.1b

Running TITAN2D on CIRCE/SC

The TITAN2D user guide is essential to understanding the application and making the most of it. The guide and this page should help you to get started with your simulations. Please refer to the Documentation section for a link to the guide.

  • Note on CIRCE: Make sure to run your jobs from your $WORK directory!
  • Note: Scripts are provided as examples only. Your SLURM executables, tools, and options may vary from the example below. For help on submitting jobs to the queue, see our SLURM User’s Guide.

TITAN2D can run well on most types of hardware on the cluster. For the vast majority of cases, memory is not as big an issue as CPU time and the program is parallel “enough” to ensure that it runs reasonably well over GigE. The code currently simulates granular flows. It runs in parallel with mesh refinement and unrefinement. The maximum refinement level is set by the user when specifying the Number of Computational Cells Across Smallest !Pile/Flux-Source. Mesh repartitioning is also used to maintain a good load-balance. A python script is included to organize the preprocessing and launching of jobs on different computers.

Running TITAN2D on CIRCE/SC - Interactively

Establishing a GUI connection to CIRCE/SC

To use TITAN2D, you will need to connect to CIRCE/SC with GUI redirection, either using:

  • CIRCE/SC Desktop Environment
  • SSH with X11 redirection
    • If connecting from OSX or Linux via SSH, please ensure that you use one of the following commands to properly redirect X11:
      • [user@localhost ~]$ ssh -X circe.rc.usf.edu
        or
      • [user@localhost ~]$ ssh -X sc.rc.usf.edu

Once connected to CIRCE/SC, you can open TITAN2D using the steps below:

[user@login0 ~]$ module add apps/titan/2.0.1
[user@login0 ~]$ titan_gui.py

If you have properly configured an X11 session, a GUI will come up and ask for certain info. There are several pop-up windows that will open, depending on the information you provide. The GUI will create several input files in a job directory that you specify. Next step is to create a submit script for SLURM.

Running TITAN2D on CIRCE/SC - Batch Submission

If, for example, you have your TITAN2D input files located in your job directory, you would set up a submit script like this:

  • The script below (for testing, name it “titan2d-test.sh”) can be copied into your job directory (the folder with your input files) and modified so that you can submit batch processes to the queue.
#!/bin/bash
#
#SBATCH --comment=titan2d-test
#SBATCH --ntasks=4
#SBATCH --job-name=titan2d-test
#SBATCH --output=output.%j.titan2d-test
#SBATCH --time=01:00:00

#### SLURM 4 processor TITAN2D test to run for 1 hour.

module add apps/titan/2.0.1b

mpirun titan

 
Next, you can change to your job’s directory, and run the sbatch command to submit the job:

[user@login0 ~]$ cd my/jobdir
[user@login0 jobdir]$ sbatch ./titan2d-test.sh
  • You can view the status of your job with the “squeue -u <username>” command

Documentation

Home Page, User Guides, and Manuals

Benchmarks, Known Tests, Examples, Tutorials, and Other Resources

  • TITAN2D Examples
    • /opt/apps/titan/example

More Job Information

See the following for more detailed job submission information:

Reporting Bugs

Report bugs with TITAN2D to the IT Help Desk: rc-help@usf.edu