Skip to content

A UCSF Chimera plugin for Tetr - a pre-processing tool for DFT codes such as CP2K


Notifications You must be signed in to change notification settings


Folders and files

Last commit message
Last commit date

Latest commit



39 Commits

Repository files navigation

This repository contains plugins for UCSF Chimera that interfaces it with the
command line utilities Tetr and Lev00.

Tetr is an interactive menu-driven program which allows the creation and 
modification of input files for codes such as VASP, SIESTA, CASTEP etc.
This plugin allows the user to visualise the current model being constructed
in Chimera, whilst allowing the user to select atoms using the GUI and send
that selection into Tetr.

Lev00 is an interactive menu-driven program for post-processing results from DFT
codes, and produces cube files of the charge, spin total and partial densities. These
can be visualised with Chimera.

More information on Tetr and Lev00 can be found at:

With manuals at


*** Tetr and Lev00 only work with UNIX-based operating systems, not MS Windows ****

For these plugins, you require UCSF Chimera, which can be downloaded here:
and Tetr and Lev00, which can both be downloaded here:

Tetr and Lev00 must be compiled in order to be used. To do this, in the source 
directories of each code, go into the Makefile and alter the line beginning "FCOMPL=" 
to contain the Fortran compiler of your choice (e.g. gfortran, ifort etc...). For
Tetr, set the environment variable HOME_TETR in your shell (e.g. inside your .bashrc)
to point to the Tetr source directory.

Finally, the plugin's directory (tetr_lev00_Chimera_plugin) must be placed inside the 
"share" directory within the Chimera directory tree. In Linux this will be kept in:
Whilst on MacOS this will be located in


Once installed (see above), the Tetr and Lev00 plugins should be visible in the 
Tools -> Utilities menu in the Chimera GUI.

Upon first launch, the plugins may prompt for the path to the Tetr/Lev00
executable (unless the HOME_TETR environment variable is set). This will be
cached in $HOME/.Tetr/tetr_root.dat and $HOME/.Lev00/lev0_root.dat so you should
not be prompted again.

The plugins will then ask you the path to the working directory you wish
to use.

If changing the version of Tetr/Lev00 that is used (e.g. upgrading to a new version) you will have to delete the tetr_root.dat and/or lev00_root.dat files in ~/.Tetr or ~/.Lev00.


We would like to thank EPSRC for funding, grant EP/K038583/1. 
The plugin was written by Gordon Gibb, Jeremy Nowell and Iain Bethune from EPCC (Edinburgh, U.K.). 


A UCSF Chimera plugin for Tetr - a pre-processing tool for DFT codes such as CP2K







No releases published


No packages published