About the code

ALC_ART (Ada Lovelace Centre Analysis of Reactive Trajectories) offers an open-source tool to extract orientational anisotropies and transfer correlations from Molecular Dynamics (MD) simulations of reactive systems. By "reactive" we refer to systems in gas and condensed phase where the constituent atomic species change their chemistry composition along the trajectory, forming and breaking bonds, as it occurs in anion [1] and proton exchange membranes [2], for example. The implemented capabilities allow computing:

• the location of the changing chemical species along the trajectory,
• residence times,
• Transfer Correlation Functions (TCFs),
• Special Pair Correlation Functions (SPCFs),
• Orientational Correlation Functions (OCFs),
• Radial Distribution Functions (RDFs),
• Mean Square Displacements (MSDs)

all at once, thus offering a novel platform to analyse reactive systems where the changing chemical species play a decisive role. During the development of the code, our efforts were focused on designing a simple and flexible input structure to facilitate the definition and tracking of changing chemical species for different systems and chemical environments. Although the applicability of ALC_ART is general, its development and optimization have been focused to analyse systems within the size range of Density Functional Theory (DFT) simulations. It is also important to remark that ALC_ART also allows the computation of OCFs, RDFs and MSDs of non-reactive systems.

ALC_ART is a serial code written in Fortran, and the result of a collaboration with the CLF-ULTRA at the Science and Technology Facilities Council (STFC) funded by the ALC of the Scientific Computing Department (SCD). Its structure for development (and maintenance) follows the Continuous Integration (CI) practice and it is integrated within the GitLab DevOps of the STFC. In the root folder, the user will find several Markdown files, which are intended to provide help with the compilation and execution as well as guidance with the multiple available functionalities.

Disclaimer

The ALC does not fully guarantee the code is free of errors and assumes no legal responsibility for any incorrect outcome or loss of data.

Contributors

Original author: Ivan Scivetti (SCD, STFC)

Structure of files and folders

ALC_ART contains the following set of files and folders (in italic-bold):

• CI-tests: contains the tests files (in .tar format) needed for CI purposes. The user should execute the available scripts of the tools folder to run the test automatically and verify the code has been installed properly (see the build_code.md file for instructions).
• examples: example cases to help the user to become familiarised with the code. The SETTINGS files are described in detail.
• scripts: contains scripts for data processing.
• source: contains the source code. Files have the .F90 extension
• tools: shell files for building, compiling and testing the code automatically.
• .gitignore: instructs Git which file to ignore.
• CMakeList.txt: sets the framework for code building and testing with CMake.
• LICENSE: BSD 3-Clause License for ALC_ART.
• README.md: this file.
• build_code.md: steps to build, compile and run tests using the CMake platform.
• use_code.md: provides instructions for use together with a detailed description of the implemented capabilities.

Dependencies

The user must have access to the following software (locally):

• GNU-Fortran (11.4.0) or Intel-Fortran (ifx 2023.1.0)
• Cmake (3.16)
• Make (4.2.1)
• Git (2.34.1)

Information in parenthesis indicates the minimum version tested during the development of the code. The specification for the minimum versions is not fully rigorous but indicative, as there could be combinations of other minimum versions that still work.

Getting started

Obtaining the code

The user can clone the code locally by executing the following command with the SSH protocol

$ git clone git@github.com:stfc/alc_art.git

Instead, if the user wants to use the HTTPS protocol it must execute

$ git clone https://github.com/stfc/alc_art.git

Both ways generate the alc_art folder as the root directory. Alternatively, the code can be downloaded from any of the available assets.

Building and testing the code with CMake

Details can be found in file build_code.md

Making use of the software

Once the code has been installed and tested, the user should create a folder where to run the code from. In such folder, the MD trajectory must be copied to the TRAJECTORY file. The user also needs to provide the SETTINGS file with instructions for the type of analysis to execute. Instructions of the implemented capabilities can be found in the use_code.md file. The SETTINGS files in folder examples offer explanatory templates, which are intended to help new users in the setting of input directives for execution. In each of the directories, the user will also find the corresponding TRAJECTORY files.

Acknowledgements

• ALC for funding.
• Gilberto Teobaldi (SCD) and Paul Donaldson (CLF-ULTRA) for scientific discussions and support.
• The Innovation Department of the STFC for assistance with the licensing process.
• Lesley Mansfield for project management support.