Table of Contents


This chapter describes how to install Virtual NanoLab (VNL) and Atomistix ToolKit 2015.0 (ATK) on Windows and Linux.

The next chapter contains more information about how to manage license files and license servers.

If you experience any problems during the installation, see the troubleshooting section for links to useful resources.

[Note] Note

The first time you start VNL after installation, if you do not already have a license, the software will automatically download and install a demo license which gives unlimited access to all functionality in ATK and VNL for 14 days.

It is recommended to uninstall previous versions of VNL before installing a new version. This is mainly to avoid confusion; two versions can be installed alongside each other without problems, but you will have to take care which version you run.

Installing on Windows and Linux

The software is distributed as a binary installer on both Windows and Linux. The package includes both the graphical user interface Virtual NanoLab (VNL) and Atomistix ToolKit (ATK), the calculation engine.

  1. Download the installer for your platform (Windows/Linux, 32 or 64 bit).

  2. Run the downloaded file. On Linux, run it as ./VNL-ATK-2015.0-linux64.bin, or similar for 32-bit, in the directory where you saved the file. You may need to add the execute permission to the downloaded file by typing chmod +x ./VNL-ATK-2015.0-linux64.bin first. On Windows, just double-click the downloaded file (this often works on Linux too, but on some systems "bin" files are associated with a package manager).

  3. Follow the step-by-step instructions to approve the license agreement, choose the installation directory, and start the installation.

  4. From the final page of the installer, you can choose to launch Virtual NanoLab directly, and also open the Installation Guide with a bit more information about the license system.

    [Note] Note

    On Windows, you should allow VNL to access the network, when prompted.

Launching the program

The installer simplifies the process of launching VNL in several ways:

  • A shortcut is added to the Desktop which you can just double-click to start Virtual NanoLab.

  • On Windows, shortcuts are also placed in the Start Menu under QuantumWise > Virtual NanoLab 2015.0.

  • The binary directory for the ATK command-line interpreter (atkpython) and Virtual NanoLab (vnl) are added to the system PATH, so that you can issue these commands from anywhere on your system.

To verify that the software has been properly installed, and the license is correctly configured, start VNL e.g. by double-clicking the Desktop icon.

[Note] Note

On Linux, you need to log out and back in again for the desktop icon to work, if you make changes to the license configuration. Also, before you can start ATK from the command line, after the installation, you need to open a new terminal window.

[Tip] Tip

You execute a Python script with ATK like this:

atkpython > logfile.log

If, however, you start atkpython without any command line argument, you will enter interactive mode where you can issue commands directly on the command line (like, for instance, in Matlab). Press Ctrl+D to quit.

Note that the first time you run atkpython in interactive mode, it will display some configuration information.

Uninstalling ATK

To uninstall VNL on Linux, run the binary uninstall in the installation directory.

On Windows, VNL can be uninstalled via the Control Panel or by launching the uninstaller from the Start Menu, under QuantumWise > Virtual NanoLab 2015.0.

Troubleshooting installation problems

If you experience any problems during the installation, first search the FAQ and/or the User Forum to see if a solution is posted there. If not, please contact QuantumWise support.