FleurinpModifier

Description

The FleurinpModifier class has to be used if you want to change anything in a stored FleurinpData. It will store and validate all the changes you wish to do and produce a new FleurinpData node after you are done making changes and apply them.

FleurinpModifier provides a user with methods to change the Fleur input. In principle a user can do everything, since he could prepare a FLEUR input himself and create a FleurinpData object from that input.

Note

In the open provenance model nodes stored in the database cannot be changed (except extras and comments). Therefore, to modify something in the inp.xml file one has to create a new FleurinpData which is not stored, modify it and store it again. However, this node would pop into existence unlinked in the database and this would mean we loose the origin from what data it comes from and what was done to it. This is the task of FleurinpModifier.

Usage

To modify an existing FleurinpData, a FleurinpModifier instance has to be initialised staring from the FleurinpData instance. Then a user can register certain modifications which will be cached and can be previewed. They can only be applied on a new FleurinpData object when the freeze method is executed. A code example:

from aiida_fleur.data.fleurinpmodifier import  FleurinpModifier

F = FleurinpData(files=['inp.xml', <other files>], node=<folder_data_pk>)
fm = FleurinpModifier(F)                                # Initialise FleurinpModifier class
fm.set_inpchanges({'dos' : True, 'Kmax': 3.9 })         # Add changes
fm.show()                                               # Preview
new_fleurinpdata = fm.freeze()                          # Apply

The figure below illustrates the work of the FleurinpModifier class.

../../_images/fleurinpmodifier.png

User Methods

General methods

Modification registration methods

The registration methods can be separated into two groups. First of all, there are XML methods that require deeper knowledge about the structure of an inp.xml file. All of them require an xpath input:

On the other hand, there are shortcut methods that already know some paths:

  • set_species(): Specific user-friendly method to change species parameters.
  • set_atomgr_att(): Specific method to change atom group parameters.
  • set_species_label(): Specific user-friendly method to change a specie of an atom with a certain label.
  • set_atomgr_att_label(): Specific method to change atom group parameters of an atom with a certain label.
  • set_inpchanges(): Specific user-friendly method for easy changes of attribute key value type.
  • set_nkpts(): Specific method to set the number of kpoints.

The figure below shows a comparison between the use of XML and shortcut methods.

../../_images/registration_methods.png