Welcome to the Masci-tools’s documentation!

This package was developed in the process of developing the AiiDA-FLEUR and AiiDA_KKR plugins to AiiDA. It contains helper functions that can help with common pre- and postprocessing steps of the FLEUR and KKR codes developed at the Forschungszentrum Jülich (see also the juDFT website for more information).

If you use this package please cite: …

Requirements to use this code:

• lxml

• h5py

• numpy

• matplotlib

• bokeh (optional)

• seaborn

• ase

• mendeleev

• click

• click-completion

• PyYAML

• tabulate

• deepdiff

• humanfriendly

• more_itertools

Installation Instructions:

Install from pypi the latest release

pip install masci-tools

or from the masci-tools source folder any branch

pip install .
# or which is very useful to keep track of the changes (developers)
pip install -e .

Acknowledgments:

We acknowledge partial support from the EU Centre of Excellence “MaX – Materials Design at the Exascale” (http://www.max-centre.eu). (Horizon 2020 EINFRA-5, Grant No. 676598) We thank the AiiDA team for their help and work. Also the vial exchange with developers of AiiDA packages for other codes was inspiring.

User’s Guide

• User guide
  • Using the Fleur input/output parsers
    • Parser for the Fleur inp.xml file
    • Parser for the Fleur out.xml file
    • XML getter functions
    • Using the schema_dict_util functions
  • FleurXMLModifier
    • Description
    • Usage
    • User Methods
      • General methods
      • Modification registration methods
    • Modifying the density matrix for LDA+U calculations
  • General HDF5 file reader
    • Basic Usage
    • Structure of recipes for the reader.HDF5Reader
  • Plotting Fleur DOS/bandstructures
    • Reading banddos.hdf files
    • Bandstructures
      • Standard bandstructure
      • Bandstructure with weights
      • Plotting options for bandstructure plots
    • Density of States
      • Standard density of states plot
      • Plotting options for DOS plots
  • Plotting KKR DOS/bandstructures
    • Density of states
    • Bandstructure
      • Fermi surface
  • General Plotting routines
    • Available Routines
    • Providing Data
    • Customizing Plots
      • Single plots
      • Setting user defaults
      • Multiple plots

Developer’s Guide

• Developers Guide
  • Test suite of masci-tools
    • Installation
    • Running the tests
    • Regenerating test files
  • Updating or adapting the Fleur Parsers
    • Adding/modifying a Fleur Schema:
    • Adapting the outxml_parser:
    • Migrating the parsing tasks
  • Using the Plotter class
    • Description
    • Writing a plotting function
      • Local instance
      • Global/Module level instance
      • Function defaults
      • Passing keyword arguments directly to plot calls
      • Multiple plotting calls
      • Custom function specific parameters
      • Nested plotting functions
  • Using the PlotData class
    • Description
    • Initializing PlotData without a mapping
    • Available routines on PlotData

Reference

• Reference
  • Changelog
  • Source code documentation

Indices and tables

• Index

• Module Index

• Search Page