General¶
Introduction¶
QuantumATK packages a powerful set of tools for calculating properties of nano-scale systems. These atomic-scale calculators are based on density functional theory, semi-empirical tight binding, and classical potentials. The non-equilibrium Green’s function method is a unique feature of QuantumATK; it allows simulations on nano-scale devices and interfaces, including support for non-zero bias between the electrode leads and device components such as electrostatic gates and dielectrics. More information may be found at the QuantumATK website.
ATK is controlled using ATK-Python, which is an extension to the well-established Python scripting language. Setting up and executing QuantumATK calculations is therefore done in an ATK-Python script or directly from the command line in an interactive Python shell.
The main purpose of this manual is to document all QuantumATK functionality. The QuantumATK Reference Manual therefore gives a detailed summary of all input and output parameters, as well as notes on relevant theory and usage examples.
We also provide a thorough exposition of the theoretical background for the atomic-scale simulators implemented in QuantumATK (see Atomic-Scale Calculators), and a detailed introduction to Python scripting and using ATK-Python to control QuantumATK (see Python in QuantumATK).
For tutorials on how to use QuantumATK we refer to the Tutorials website.
New in QuantumATK V-2023.12¶
The V-2023.12 release of QuantumATK introduces a range of new features and performance improvements and an overview is given here: Release Overview. For a comprehensive list, see the full release notes, which can be found on the SolvNet portal.
Tip
For the full list of changes, see the release notes for the feature release, i.e. V-2023.12. The release notes for a service pack release will only list the changes relative to the feature release.
Installing and running the software¶
The QuantumATK binary installer is available for registered users at the SolvNet software portal. Access to a valid QuantumATK license is also needed. Detailed instructions are given in the Installation Guide. Note that a license is required and if your institution does not already have a license, you can request an evaluation license via the Synopsys Eval Portal.
When QuantumATK has been installed on your machine you can run it from the command line
using the atkpython executable and
a QuantumATK Python script. The executable should be in your PATH
and is available here: .../QuantumATK-VERSION/bin/atkpython
.
For more information on using the software, see the Getting started with QuantumATK category in the tutorials section.
Parallel execution
ATK supports multi-level parallelism, using the
Message Passing Interface (MPI)
available on most supercomputing clusters for distributed memory parallelism,
and OpenMP for shared memory parallelism. QuantumATK ships with Intel MPI, which you can find here: .../QuantumATK-VERSION/mpi/bin/mpiexec.hydra
How to read this manual¶
This manual is typeset using in-line references to QuantumATK Python objects and functions, and contains several script examples. The following style conventions are used:
All QuantumATK objects and functions appear as links, e.g.
MoleculeConfiguration
. The link will take you to the relevant section of the QuantumATK Reference Manual, where a detailed description of the object “MoleculeConfiguration” is provided.References to particular chapters and sections are also links. For example, the links For-loops and Tuples direct you to specific sections in the chapter Python in QuantumATK.
Boldface letters are used to highlight specific words, e.g. atkpython, while in-line names of Python variables, functions, parameters, and methods are in general typeset using a monospace serif, e.g.
list_of_atoms
for a Python variable andcartesianCoordinates()
for a method of theMoleculeConfiguration
object.In-line names of files and directories are also typeset using a monospace serif, e.g.
file.txt
and$HOME/QuantumATK/
.Python structures are visually enclosed in a box and typeset using a monospaced serif:
# This is a comment for i in range(3): print(i)
Scripts can often be downloaded by following a link, e.g.
example_code.py
.Instructions for using the command line are indicated by the
$
prefix:$ atkpython script.py
while instructions for using an interactive Python session is indicated by the
>>>
prefix:>>> myList = [1, 2, 3, 4, 5] >>> print(myList) [1, 2, 3, 4, 5] >>> print(len(myList)) 5