1. Installation

1.1. TL;DR

Type the following in the MATLAB shell

cd src
makeRESCU -agreeToLicense y

and copy license.lic from the portal in $HOME/.nanoacademic/RESCU.

1.2. Walk-through

In this section, I describe the installation procedure of RESCU in the MATLAB environment. Start a MATLAB session and change the current directory to the root of the RESCU package. Before doing anything, I advise to save your current MATLAB path

savepath folderName/pathdef.m

and then clear the MATLAB path using the restoredefaultpath command as shown in Fig. 1.2.1.

Fig. 1.2.1 Clean MATLAB path.

This prevents name space conflicts with other codes. There are five directories in the RESCU package directory:

  1. bin RESCU binary.

  2. doc RESCU documentation.

  3. examples Input file examples.

  4. license License files.

  5. src RESCU source code.

Go to the src directory and type makeRESCU to install RESCU (as in Fig. 1.2.2).

Fig. 1.2.2 Build RESCU.

The End User License Agreement will be displayed and you will be prompted to accept the agreement. You can directly notify RESCU of your agreement by typing makeRESCU -agreeToLicense y.

Warning

makeRESCU will try to add RESCU permanently to the MATLAB path, but you may not have the permissions to do that. MATLAB path management is explained here or you can simply type addpath /path/to/rescu/src when launching MATLAB.

RESCU is now built and needs to be activated. To activate RESCU, sign up or sign in your account on the Nanoacademic portal. Go to the product section and click on RESCU. Then click on the Start Your Free Trial button and you should see a panel like Fig. 1.2.3

Fig. 1.2.3 Generate RESCU license.

Download the file license.lic by clicking the download link and copy it in the directory $HOME/.nanoacademic/RESCU. Alternatively, you may copy it anywhere and set the environment variable RESCU_LICENSE_PATH as, say

export RESCU_LICENSE_PATH=/home/vincentm/licenses/license.lic

You can finally check that RESCU works properly by running one of the input files in the examples directory. For example,

rescu -i al_lcao_scf.input

Warning

You may have to modify the input file to let RESCU know where are the required pseudopotential files.

Note

Instructions on more advanced configurations, including LAN and parallel installations are found in Advanced installation.