Tramonto Software
Sandia National Laboratories Tramonto

Tramonto 4.x User Guide

This page contains instructions for using Tramonto 4.0. Click the following links for archived user guides: Tramonto v3.x or Tramonto v2.1

Quick start

After completing installation, the following steps are recommended for the new user.

  • 1. Proceed to the directory Tramonto/Examples in your local copy of the software.
  • 2. Choose an example that is similar to a problem you are interested in. For help selecting a suitable example problem to study, see the short descriptions on the Tabulated Examples web page. Note that each example listed on the web site corresponds to an identically named directory in Tramonto/Examples. Within that directory all of the input files needed to run that particular case can be found.
  • 3. Run the example problem of your choice, and study the output files produced by Tramonto (use links below to intepret output files). Note that when compiled, the executable (called 'dft') is placed in the directory Tramonto/build_directory/src where the build_directory is specified by the user (see the Installation Guide for further instructions). The command needed to execute tramonto depends on the type of mpi libraries in use. A few possibilities are :
    • mpirun -np 16 ~/path_to_Tramonto/Tramonto/build_directory/src/dft
    • mpirun -np 16 ~/path_to_Tramonto/Tramonto/build_directory/src/dft your_input.dat (replace dft_input.dat with a file name of your choice)
    • mpiexec -n 16 ~/path_to_Tramonto/Tramonto/build_directory/src/dft
    • ~/path_to_Tramonto/Tramonto/build_directory/src/dft (single processor execute will work on most platforms)
  • 4. After running the problem of interest, have a look at the output files generated by your chosen example problem. You might want to plot the data in the output file dft_dens.dat.
  • 5. After running the problem of interest, have a look at the input files associated with your example problem. The links below describe various input parameters in detail.
  • 6. Finally modify the input file as needed to set up a calculation for a system of interest to you. Note that depending on the complexity of your problem you may need to use arc-length continuation algorithms to establish a suitable initial guess for your studies.
  • 7. If you need more information on the theories that have been implemented in the Tramonto software, please obtain a copy of the original references listed on the Tramonto/capabilities page. If you are interested in algorithms under the hood of Tramonto or would like to know about previous applications studied using the code, visit the Publications page.

    User's Guide: Reduced units in the Tramonto Code

    For more information on the details of dimensionless parameters in the input and/or output files of Tramonto calculations, see the Reduced Units web page.

    User's Guide: dft_input.dat

    The default primary input file for Tramonto is dft_input.dat. Various parameters are described in this section. Other input files that may be needed are listed below. Note that in dft_input.dat, all lines containing data begin with an @ symbol signaling the code to begin reading data. Arbitrary numbers of blank lines or comments may be inserted following the data since everything after the needed data is treated as a comment. Numerous comments are included in the templates provided in the Tramonto/Examples/* directories. These comments are meant to assist the user in setting up the input file. Note that the input procedure for dft_input.dat is based on the variables being entered in a preset order. So, all lines must be present even if some variables are not needed. The input data is split into different logical categories described in the links here.

    User's Guide: other input files

    • dft_surfaces.dat: define surface types, positions, and charge.
    • poly_file: define polymer connectivity.
    • Cr_file: direct correlation function file for CMS DFT calculations.

    User's Guide: Tramonto output files (principle output)

    A variety of files are generated by the Tramonto code. They can be split into two categories - principle output and debugging output. The latter are only printed when the code is operating in VERBOSE (see Iwrite parameter) mode for the purposes of debugging. The principle output files are dft_dens.dat, dft_output.dat, dft_out.lis, and dft_time.out. Various output files are described further below.