2.AiiDA-Fleur input file.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "*please execute the cell below before starting the tutorial by selecting it and pressing Ctrl+Enter*"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# imports correct environment\n",
    "from aiida import load_profile\n",
    "load_profile()\n",
    "\n",
    "# imports load_node() \n",
    "from aiida.orm import load_node"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# AiiDA-Fleur input file"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Introduction"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "In previous tutorial, we learnt about AiiDA data types and found out how files and folders can be stored in the database. It makes sense to extend some of the AiiDA types to represent not a general file - but input files, specific for the Fleur code. There is a special class in AiiDA-Fleur to represent input files for Fleur which is called `FleurinpData`. It represents xml input files needed for a Fleur calculation and also contains some helpful methods to work with them.\n",
    "\n",
    "**NOTE** : Creation and usage of these data objects via the input generator (`inpgen`) are described in the notebook 4. For this tutorial we assume that we already have an `inp.xml` file."
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## FleurinpData"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`FleurinpData` is an AiiDA datastructure specific to the AiiDA-Fleur plugin. One can access this class using the `DataFactory` class provided by the `aiida.orm` module:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "from aiida.plugins import DataFactory\n",
    "FleurinpData = DataFactory('fleur.fleurinp') "
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "or importing it directly:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "from aiida_fleur.data.fleurinp import FleurinpData"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`FleurinpData` can be initialized with an absolute path to an ``inp.xml`` file or a\n",
    "`FolderData` node containing ``inp.xml``.\n",
    "Other files can also be added to a `FleurinpData` object that will be copied to the calculation folder."
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "# you need to modify this - replace /path/to/inp.xml\n",
    "inpxmlfile = 'path/to/inp.xml'\n",
    "fleurinp = FleurinpData(files = [inpxmlfile])\n",
    "print(fleurinp)   # not stored\n",
    "\n",
    "fleurinp.store() # to store the node in the database\n",
    "print('The PK of stored FleurinpData is {}'.format(fleurinp.pk))\n",
    "print('The FleruinpData contains a list of files: {}.'.format(fleurinp.files))"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`FleurinpData` stores the files in the repository and saves the input parameters of the\n",
    "``inp.xml`` file of FLEUR in the database as a python dictionary which can be accessed via:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "fleurinp.inp_dict"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "`FleurinpData` also provides the user with methods to extract some AiiDA object such as `StructureData` and `KpointsData` from an `inp.xml` file:"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "kpoints = fleurinp.get_kpointsdata()\n",
    "repr(kpoints)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": [
    "structure = fleurinp.get_structuredata()\n",
    "repr(structure)"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "Remember, most attributes of AiiDA nodes can not be changed after they\n",
    "had been stored in the database! Therefore, we can not change stored `FluerinpData` in-place. \n",
    "One has to use the `FleurinpModifier` class and its\n",
    "methods to change something in the ``inp.xml`` file. We will learn how to do it in next tutorial."
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 2",
   "language": "python",
   "name": "python2"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 2
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython2",
   "version": "2.7.16"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}