Personal tools
You are here: Home / Download / Installation notes

Installation notes

This page describes the installation procedure for version 2.3 of ARIA. For version 2.2, see this page.


System requirements

ARIA has been extensively tested on different Linux environments (RedHat, Centos, SuSE), and also runs on SGI and Mac OS X. The current version of ARIA supports only CNS as structure calculation engine. However, we plan to support other programs such as CYANA and XPLOR-NIH. Users are welcome to participate to these extensions: If you want to contribute to these efforts, please contact Michael Nilges.

Required software packages

ARIA requires the following third party software packages:

  • CNS 1.1 or 1.21 (not 1.3)

  • Python 2.4 or later

  • NumPy 1.0 or later

  • Tcl/Tk 8.3 or later

  • Tix 8.1.4 or later

  • CCPN Analysis 2.0.7 or later (Optional)
  • Matplotlib (Optional)


Academic users can obtain a free license for CNS from the CNS web site at Commercial users need to purchase a CNX license from Accelrys (MSI). In order to compile CNS with the ARIA extensions, please do the following:

  • The ARIA fortran sources are located in the subdirectory ./cns/src of the distribution (see section "Installing and running ARIA" below). Please copy all the files to the directory cns_solve_1.1/source of the unpacked cns_solve distribution (this will overwrite some files which is okay).

  • Edit the file "cns_solve_env" in the directory cns_solve_1.1 to define the location of the CNSsolve directory.

  • Go to directory cns_solve_1.1 and type "make install". This should start the compilation process.

Note for Mac OS X: CNS universal binaries are available from Logan Donaldson' Lab. But the specific aria routines (such as vean statements) are not running on MacIntel.



The latest version of Python can be downloaded from the Python homepage at Go to the "download" section and download the source tar-ball.The installation is straight forward for most UNIX systems (LINUX in particular). Follow the installation notes of the Python distribution and make sure that Tkinter support is enabled.

Note: In order to install Python with Tcl/Tk support, please make sure that both libraries are installed on your system. If any of the libraries is missing, please check and install the missing components prior to the installtion of Python.


Since maintenance has ceased for Numeric Python, ARIA 2.3 now only supports NumPy module.



The Python Numpy extension is obtainable from SourceForge at

. Go to "Download Numerical Python" and download the package "Numpy". Version 1.0 or later is required for ARIA 2.3. For installation, please follow instructions provided by the NumPy distribution.


Note: See here for a detail explanation on installing Numeric with ATLAS/LAPACK


CCPN distribution version 2

In order to use the CCPN data model for import/export or data conversion, you also need to install the CCPN data model, and the CCPNMR Analysis software in case you want to export restraint lists, NOE assignments, and analyses of the generated structures, e.g. the result of the violation analysis. The complete CCPN distribution including the API, the FormatConverter, and CCPNMR Analysis can be obtained at


Matplotlib is a python 2D plotting library. The mathplotlib library can be found at

.  Download the package "matplotlib" and follow the installation instructions.



Tcl/Tk and Tix

The Tcl/Tk libraries are obtainable from The Tix (Tk Interface eXtension) graphics library provides high-level widgets, extending the standard capabilities of Tk widgets. The latest Tix library can be obtained from SourceForge at Installing Tix also requires the sources of Tcl/Tk. Make sure that the Tcl/Tk version used during Tix installation matches the version installed on your system (if Python with Tkinter support is already installed, you can check the Tk version linked with Python by using the script ""). Please consult the installation notes for further instructions.


Installing and running ARIA

In order to install ARIA, unpack the ARIA distribution by using the following command:

tar xvzf aria-version_number.tar.gz

This creates the directory tree.

  • You find the source code of ARIA in the directory ./src of the distribution, Python modules are located in ./src/py and /src/py/gui.
  • The CNS protocols implementing, e.g., the simulated annealing protocol used to calculate a structure, are stored in ./cns/protocols. CNS analysis protocols can be found in the sub-directory, ./cns/protocols/analysis.
  • A working example can be found in ./example

Testing the software environment

Python is part of the default installtion of many modern LINUX distributions. If Python is already installed on your system, you can check whether your installation meets all of the requirements for running ARIA by executing the script "" which is located in the root directory of the ARIA distribution:

python <aria-installation-path>/

The script checks the Python version, whether the Numeric package and Tkinter/Tix is installed. Please note, that the script cannot check whether Tcl/Tk/Tix is working properly.

Environment variables

For convenience we suggest adding the following lines to your login script:

csh; edit ".cshrc"

setenv ARIA2 <aria-installation-path>
alias aria2 <Python-executable> -O $ARIA2/

bash; edit ".bashrc"

export ARIA2=<aria-installation-path>
alias aria2="<Python-executable> -O $ARIA2/" 

zsh; edit ".zshrc"

export ARIA2=<aria-installation-path>
alias aria2="<Python-executable> -O $ARIA2/"

Running ARIA

For running the graphical user inferface of ARIA, please use the following command:

aria2 -g

and for help, type

aria2 --help
« July 2024 »