A software workflow for fingerprinting and visualizing defects in damaged crystal structures
Udo von Toussaint, F. J. Domı́nguez-Gutiérrez, Markus Rampp, Michele Compostella
Max-Planck-Institut für Plasmaphysik, Boltzmannstrasse 2, 85748 Garching, Germany
Max-Planck Computing and Data Facility, Giessenbachstrasse 2, 85748 Garching, Germany
Introduction
This repository contains the recipe to create a Docker container where users can test the workflow for fingerprinting and visualizing defects in damaged crystal structures.
Together with the required software, data for the analysis of point defects in a bcc Fe sample are provided. This dataset was obtained by performing MD simulations to emulate neutron bombardment at a primary-knock on-atom of 10 keV.
Requirements
In order to build the Docker image, the following software is required on the local machine:
- tar
- curl
- wget
- git
- docker
Important:
The workflow presented in this repository uses the GAP library for the software QUIP. When installing this software, you are accepting the GAP license agreement.
Installation
Clone this repository to your local machine with
git clone https://gitlab.mpcdf.mpg.de/mcompo/favad.git
After cloning this repository, run the following commands (note that building the Docker image requires root permission on the local machine) to create the Docker image
cd favad/
./build.sh
The entire build process may take several minutes.
The build.sh script accepts additional optional parameters in order to automatically accept the GAP license agreement:
./build.sh "I accept" "FULL NAME" "EMAIL ADDRESS" "ORGANIZATION"
If these optional parameters are not specified, the build process will ask for them during runtime.
How to run the Docker image
Once the Docker image has been created and the Docker daemon is running, you can create a local folder where the output files will be stored using, for example:
mkdir $HOME/favad_output/
Finally, shell into the Docker container mounting the created folder:
sudo docker run -t -i --volume $HOME/favad_output/:/home/favad/sample/output/ favad /bin/bash
Using the previous command, the ouput files generated inside the Docker container will be available in $HOME/faved_output/ of your local machine. Please note that the content of this folder will be overwritten, if the folder is not empty.
At this point you can run the workflow for fingerprinting and visualizing defects on the sample dataset inside the Docker container:
cd /home/favad/sample/
python3 FaVaD.py -p /home/favad/sample/parameters.txt
When the rendering is completed, you can log out the Docker container using
exit
and examine the output in the $HOME/faved_output/ folder.
Local Installation
In the 'assets' folder we provide a script for the installation of the entire software stack on a local machine (instead of inside a Docker container) running Ubuntu 18.04 LTS.
In this case, you can run the installer using
./assets/installer.sh /local_installation_path/ "FULL NAME" "EMAIL ADDRESS" "ORGANIZATION"
By running the installer, you are accepting the GAP license agreement.
How to run locally
If you installed the software stack locally, you can run the workflow for fingerprinting and visualizing defects on the sample dataset using
cd ./sample
python3 FaVaD.py -p ./parameters.txt
Note however that you are required to change the paths in the parameter.txt file to match the current location of the files and software executables.