#
# CDDL HEADER START
#
# The contents of this file are subject to the terms of the Common Development
# and Distribution License Version 1.0 (the "License").
#
# You can obtain a copy of the license at
# http://www.opensource.org/licenses/CDDL-1.0.  See the License for the
# specific language governing permissions and limitations under the License.
#
# When distributing Covered Code, include this CDDL HEADER in each file and
# include the License file in a prominent location with the name LICENSE.CDDL.
# If applicable, add the following below this CDDL HEADER, with the fields
# enclosed by brackets "[]" replaced with your own identifying information:
#
# Portions Copyright (c) [yyyy] [name of copyright owner]. All rights reserved.
#
# CDDL HEADER END
#

#
# Copyright (c) 2012,   Institute for Theoretical and Applied Physics
#      			University of Stuttgart, D-70550 Stuttgart, Germany.
# 			All rights reserved.

#
# Contributors:
#    Daniel Schopf
#

This directory (IMD_EAM) contains a Model Driver written in C for
EAM potentials in IMD format. It reads tabulated potentials and calculates
forces and energies by interpolating between these values.

The format is described on the IMD homepage:

http://imd.itap.physik.uni-stuttgart.de/userguide/eam2.html

Currently the computation of 'energy', 'forces, 'particleEnergy' and 'process_dEdr' are
supported.

Updates:
_002 : Fixed problem of occasional crashes in KIM_API_getm_compute_by_index

To create a KIM Model from this Model Driver, a parameter file and the three potential
files are required.

The parameter files, in order are:
- the pair potential file (IMD parameter core_potential_file)
- the electron density file (IMD parameter atomic_e-density_file)
- the embedding function file (IMD parameter embedding_energy_file)

The following files are in this directory:

Makefile
    makefile to compile and build executables with GNU or Intel compilers

README
    This file

IMD_EAM.c
    C file containing the implementation of the IMD EAM potential Model Driver

IMD_EAM.h
    Header file containing prototypes and macro definitions

IMD_EAM.kim.tpl
    Template KIM descriptor file containing all variables and methods that are
    exposed by the driver through the KIM API interface.  This file will be
    used (by the make system) to generate a KIM descriptor file for each KIM
    Model based on this Model Driver.