Metadata-Version: 1.2
Name: kmcos
Version: 0.0.2
Summary: kMC modeling on steroids
Home-page: https://github.com/kmcos/kmcos
Author: Max J. Hoffmann
Author-email: mjhoffmann@gmail.com
Maintainer: Aditya Savara
Maintainer-email: AdityaSavara2008@u.northwestern.edu
License: COPYING
Description: .. image:: https://travis-ci.org/mhoffman/kmos.png?branch=master
            :target: https://travis-ci.org/mhoffman/kmos
        .. image:: https://img.shields.io/badge/license-GPLv3-brightgreen.svg?style=flat-square)
            :target COPYING
        .. image:: https://readthedocs.org/projects/kmos/badge/?version=latest
            :target: http://kmos.readthedocs.org/en/latest/?badge=latest
            :alt: Documentation Status
        .. image:: https://badges.gitter.im/mhoffman/kmos.svg
           :alt: Join the chat at https://gitter.im/mhoffman/kmos
           :target: https://gitter.im/mhoffman/kmos?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
        
        kmos: kMC modelling on steroids
        =====================================
        *a vigorous attempt to make lattice kinetic Monte Carlo modelling more accessible.*
        
        Copyright (C) 2009-13 Max J. Hoffmann <mjhoffmann@gmail.com>
        
        This program is free software; you can redistribute it and/or modify it under
        the terms of the GNU General Public License as published by the Free Software
        Foundation; either version 3 of the License, or (at your option) any later
        version.
        
        This program is distributed in the hope that it will be useful, but WITHOUT
        ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
        FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
        
        You should have received a copy of the GNU General Public License along with
        this program; if not, see `http://www.gnu.org/licenses/ <http://www.gnu.org/licenses/>`_.
        
        QUICKSTART
        ##########
        
        Prepare a minimal input file with the following content and save it as ``mini_101.ini`` ::
        
            [Meta]
            author = Your Name
            email = you@server.com
            model_dimension = 2
            model_name = fcc_100
        
            [Species empty]
            color = #FFFFFF
        
            [Species CO]
            representation = Atoms("CO", [[0, 0, 0], [0, 0, 1.17]])
            color = #FF0000
        
            [Lattice]
            cell_size = 3.5 3.5 10.0
        
            [Layer simple_cubic]
            site hollow = (0.5, 0.5, 0.5)
            color = #FFFFFF
        
            [Parameter k_CO_ads]
            value = 100
            adjustable = True
            min = 1
            max = 1e13
            scale = log
        
            [Parameter k_CO_des]
            value = 100
            adjustable = True
            min = 1
            max = 1e13
            scale = log
        
            [Process CO_ads]
            rate_constant = k_CO_ads
            conditions = empty@hollow
            actions = CO@hollow
            tof_count = {'adsorption':1}
        
            [Process CO_des]
            rate_constant = k_CO_des
            conditions = CO@hollow
            actions = empty@hollow
            tof_count = {'desorption':1}
        
        In the same directory run ``kmos export mini_101.ini``. You should now have a folder ``mini_101_local_smart``
        in the same directory. ``cd`` into it and run ``kmos benchmark``. If everything went well you should see something
        like ::
        
            Using the [local_smart] backend.
            1000000 steps took 1.51 seconds
            Or 6.62e+05 steps/s
        
        In the same directory try running ``kmos view`` to watch the model run or fire up ``kmos shell``
        to interact with the model interactively. Explore more commands with ``kmos help`` and please
        refer to the documentation how to build complex model and evaluate them systematically. To test all bells and whistles try ``kmos edit mini_101.ini`` and inspect the model visually.
        
        DOCUMENTATION
        ##############
        
        Please refer to
        
        * https://www.th4.ch.tum.de/index.php?id=1321
        * http://mhoffman.github.io/kmos/
        * http://kmos.readthedocs.org/
        * https://github.com/jmlorenzi/intro2kmos
        
        or links therein for tutorials, user guide, reference, and troubleshooting hints.
        
        BUGS, ISSUES, TROUBLE
        #####################
        
        This code is research code for scientists by scientists. If you
        believe you have hit a bug, have a feature request get in touch
        with us either via the `mailing list <https://groups.google.com/forum/#!forum/kmos-users>`_, `Gitter <https://gitter.im/mhoffman/kmos?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge>`_, or open an `issue <https://github.com/mhoffman/kmos/issues/new>`_ .
        
        THANKS
        ######
        
        This project draws on several other great Python modules, which are in turn
        each free software and I would like to thank each of these projects for
        making their code freely avalaible, namely:
        
        * `Python <http://www.python.org>`_
        * `ASE <https://wiki.fysik.dtu.dk/ase/>`_
        * Numpy
        * `f2py <http://cens.ioc.ee/projects/f2py2e/>`_
        * `kiwi <http://www.async.com.br/projects/kiwi/>`_, gazpacho
        * lxml and in particular `ElementTree <http://www.effbot.org/>`_
        
        FILES
        #####
        | â”œâ”€â”€ COPYING                                      # Copy of GPLv3
        | â”œâ”€â”€ INSTALL.rst                                  # installation instructions
        | â”œâ”€â”€ README.rst                                   # This document
        | â”œâ”€â”€ TODO.rst                                     # Ideas for improvement and new features
        | â”œâ”€â”€ requirements.txt                             # Dependencies which can be installed via pip
        | â”œâ”€â”€ setup.py                                     # setuptools using setup script
        | â”œâ”€â”€ index.html                                   # landing website
        | â”œâ”€â”€ kmos/                                        # the core kmos python modules
        | â”‚Â Â  â”œâ”€â”€ cli.py                                   # the command line interface
        | â”‚Â Â  â”œâ”€â”€ config.py                                # configuration of some project wide paths
        | â”‚Â Â  â”œâ”€â”€ fortran_src/                             # static Fortran 90 source files
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ assert.ppc                           # assertion macro
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ base.f90                             # the default kMC solver
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ base_lat_int.f90                     # slightly modified kMC solver for lat_int backend
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ kind_values.f90                      # definition of project wide kind values
        | â”‚Â Â  â”‚Â Â  â””â”€â”€ main.f90                             # source template for standalone Fortran 90 clients
        | â”‚Â Â  â”œâ”€â”€ gui/                                     # kmos.gui module
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ forms.py                             # view definitions (MVC) of editor GUI
        | â”‚Â Â  â”‚Â Â  â””â”€â”€ __init__.py                          # controller definitions (MVC) of editor GUI
        | â”‚Â Â  â”œâ”€â”€ __init__.py                              # root import module
        | â”‚Â Â  â”œâ”€â”€ io.py                                    # conversion between format: contains main Code Generator
        | â”‚Â Â  â”œâ”€â”€ kmc_editor.glade                         # Glade XML definiton for form interfaces
        | â”‚Â Â  â”œâ”€â”€ kmc_project_v0.1.dtd                     # Document Type Definition file of kMC project v0.1
        | â”‚Â Â  â”œâ”€â”€ kmc_project_v0.2.dtd                     # Document Type Definition file of kMC project v0.2
        | â”‚Â Â  â”œâ”€â”€ run.py                                   # High-level API for compiled models
        | â”‚Â Â  â”œâ”€â”€ species.py                               # Convenient interface for some reaction intermediates
        | â”‚Â Â  â”œâ”€â”€ types.py                                 # The basic classes for building kMC models
        | â”‚Â Â  â”œâ”€â”€ units.py                                 # Definition of conversion factor (CODATA 2010)
        | â”‚Â Â  â”œâ”€â”€ utils/                                   # Utility function that didn't fit elsewhere
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ __init__.py
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ ordered_dict.py
        | â”‚Â Â  â”‚Â Â  â”œâ”€â”€ progressbar.py
        | â”‚Â Â  â”‚Â Â  â””â”€â”€ terminal.py
        | â”‚Â Â  â””â”€â”€ view.py                                  # The runtime GUI for compiled models
        | â”œâ”€â”€ doc/                                         # user guide, documentation, and reference
        | â”‚Â Â  â””â”€â”€ source/                                  # documentation source file for compilation with Sphinx
        | â”œâ”€â”€ examples/                                    # demoing non-standard features and useful idioms
        | â”‚Â Â  â”œâ”€â”€ AB_model.py                              # small demo file
        | â”‚Â Â  â”œâ”€â”€ benchmark_compilers_and_backends.sh      # demo file
        | â”‚Â Â  â”œâ”€â”€ crowded.xml                              # demo file
        | â”‚Â Â  â”œâ”€â”€ dreiD.xml                                # demo file for 3d model
        | â”‚Â Â  â”œâ”€â”€ dummy.xml                                # mininal model
        | â”‚Â Â  â”œâ”€â”€ model_Pt111_surface.py                   # demo file for non-rectangular lattice
        | â”‚Â Â  â”œâ”€â”€ multidentate.py                          # basic example for multidentate adsorption
        | â”‚Â Â  â”œâ”€â”€ render_bigcell.py                        # demo containing many sites
        | â”‚Â Â  â”œâ”€â”€ render_co_oxidation_ruo2.py              # demoing th CO Oxidation at RuO2(110) model
        | â”‚Â Â  â”œâ”€â”€ render_diffusion_model.py                # idioms for describing lateral interaction
        | â”‚Â Â  â”œâ”€â”€ render_einsD.py                          # simple 1-dimensional model
        | â”‚Â Â  â”œâ”€â”€ render_multispecies.py                   # render many species
        | â”‚Â Â  â”œâ”€â”€ render_pairwise_interaction.py           # idioms for describing lateral interaction
        | â”‚Â Â  â”œâ”€â”€ render_Pt_111.py                         # another non-rectangular lattice
        | â”‚Â Â  â”œâ”€â”€ render_sand_model.py                     # a neat diffusion model for non-trivial boundary conditions
        | â”‚Â Â  â”œâ”€â”€ run_in_multi_process.py                  # an example for parallelization over processes
        | â”‚Â Â  â”œâ”€â”€ run.py                                   # a high-level run script using the ModelRunner metaclass
        | â”‚Â Â  â”œâ”€â”€ ruptured_Pd.xml                          # a fcc(100) like surface with some sites missing
        | â”‚Â Â  â””â”€â”€ small.xml                                # demo file
        | â”œâ”€â”€ tests/                                       # Unit tests and test data
        | â””â”€â”€ tools                                        # Entry points for command line interface
        |     â”œâ”€â”€ kmos
        |     â”œâ”€â”€ kmos.bat
        |     â”œâ”€â”€ kmos-build-standalone
        |     â””â”€â”€ kmos-install-dependencies-ubuntu
        
Platform: linux
Platform: windows
