Metadata-Version: 2.1
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
Platform: linux
Platform: windows

.. 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


