Metadata-Version: 2.1
Name: fodMC
Version: 1.0.7
Summary: Fermi-orbital descriptor Monte-Carlo
Home-page: https://github.com/pyflosic/fodMC
Author: Kai Trepte
Author-email: kai.trepte1987@gmail.com
License: APACHE2.0
Description: ![GitHub Logo](doc/images/logo_fodMC.png)
        
        # fodMC - Fermi-orbital descriptor Monte-Carlo 
        [![license](https://img.shields.io/badge/license-APACHE2-green)](https://www.apache.org/licenses/LICENSE-2.0)
        [![language](https://img.shields.io/badge/language-Fortran90-red)](https://www.fortran90.org/)
        [![language](https://img.shields.io/badge/language-Python3-blue)](https://www.python.org/)
        [![version](https://img.shields.io/badge/version-1.0.0-lightgrey)](https://github.com/pyflosic/fodMC/blob/master/README.md)
        
        Main developer:  
        
        *  Kai Trepte (KT, kai.trepte1987@gmail.com)    
        *  Sebastian Schwalbe (SS, theonov13@gmail.com)  
        
        Sidekicks:  
          
        * Alex Johnson (AJ, johns1ai@cmich.edu)   
        * Jakob Kraus (JaK, jakob.kraus@physik.tu-freiberg.de)   
        
        Coding language: FORTRAN, Python 
        
        ## Description
        The fodMC is a generator for Fermi-orbital descriptor (FOD) positions to be used in the Fermi-Löwdin orbital self-interaction correction (FLO-SIC) method.           
        There is a publication, explaining the underlying idea of this program; please see
        
        'Interpretation and automatic generation of Fermi-orbital descriptors', S. Schwalbe, K. Trepte, et al., Journal of Computational Chemistry, vol. 40, pp. 2843-2857, 2019
        
        ## Installation (simple pip) 
        
        ```bash 
        $ pip3 install fodmc 
        ```
        
        
        ## Installation (local)
        
        ```bash 
        $ git clone https://github.com/pyflosic/fodMC
        $ cd fodMC
        $ pip3 install -e .
        ```
        
        The Python module is called 'fodmc'. 
        
        There are examples to make you familiar with the execution. 
        You can either work at the FORTRAN level (see examples/fortran) or 
        use the Python-Overlay, see examples/python.
        
        
        
        
        # ATTENTION
        Initial FODs for transition metals and larger atoms may currently not be reliable.
        This is due to the fact that the spherical symmetry of the core FODs (with is strictly enforced)
        might not represent a good guess for such systems. Intensive research is needed to determine the 
        correct structural motifs for such systems.
        
        
        ## Tutorials
        
        There are several tutorial videos about the 
        usage and handling of the fodMC at youtube, 
        at the channel 'The extended Physiker Clan'.
        
        In addition, there is a publication summarizing essential findings regarding FODs, see 
        'Interpretation and automatic generation of Fermi-orbital descriptors', S. Schwalbe, K. Trepte, et al., Journal of Computational Chemistry, vol. 40, pp. 2843-2857, 2019
        
Platform: UNKNOWN
Description-Content-Type: text/markdown
