| 1 |
# |
| 2 |
# KIM-API: An API for interatomic models |
| 3 |
# Copyright (c) 2013--2022, Regents of the University of Minnesota. |
| 4 |
# All rights reserved. |
| 5 |
# |
| 6 |
# Contributors: |
| 7 |
# Ryan S. Elliott |
| 8 |
# Andrew Akerson |
| 9 |
# |
| 10 |
# SPDX-License-Identifier: LGPL-2.1-or-later |
| 11 |
# |
| 12 |
# This library is free software; you can redistribute it and/or |
| 13 |
# modify it under the terms of the GNU Lesser General Public |
| 14 |
# License as published by the Free Software Foundation; either |
| 15 |
# version 2.1 of the License, or (at your option) any later version. |
| 16 |
# |
| 17 |
# This library is distributed in the hope that it will be useful, |
| 18 |
# but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 19 |
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| 20 |
# Lesser General Public License for more details. |
| 21 |
# |
| 22 |
# You should have received a copy of the GNU Lesser General Public License |
| 23 |
# along with this library; if not, write to the Free Software Foundation, |
| 24 |
# Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
| 25 |
# |
| 26 |
|
| 27 |
|
| 28 |
This directory (LennardJones612__MD_414112407348_003) contains a Lennard-Jones |
| 29 |
Driver which reads a parameter file containing the parameters for up to 139 |
| 30 |
species. It supports shifted and non-shifted energy behavior. The driver is |
| 31 |
written in C++. This Model Driver expects one parameter file as decribed |
| 32 |
below. |
| 33 |
|
| 34 |
The model driver implements the functional form: |
| 35 |
|
| 36 |
phi_{ij}(r) = 4 * epsilon_{ij} * |
| 37 |
[ (sigma_{ij}/r)^12 - (sigma_{ij}/r)^6 ] + shift_{ij}, |
| 38 |
|
| 39 |
where i, j = 0, 1, 2, ..., N-1, and N is the number of supported species. |
| 40 |
|
| 41 |
|
| 42 |
The format of the parameter file is as follows: |
| 43 |
|
| 44 |
* Blank lines and lines beginning with the `#' character are ignored. |
| 45 |
|
| 46 |
* Line 0 : N, shift |
| 47 |
- N : integer number of distinct particle species |
| 48 |
- shift : integer value: 0-for no shift; 1-for shifts. |
| 49 |
All shift values are computed at run time |
| 50 |
* Lines 1,2,...: species_i, species_j, cutoff, epsilon, sigma |
| 51 |
- species_i : A valid KIM API particle species string |
| 52 |
- species_j : A valid KIM API particle species string |
| 53 |
- cutoff : double cutoff distance value (in Angstroms) for phi_{ij}(r) |
| 54 |
- epsilon : double energy value (in eV) for epsilon_{ij} |
| 55 |
- sigma : double sigma distance value (in Angstroms) for sigma_{ij} |
| 56 |
|
| 57 |
|
| 58 |
The parameter file must contain all "like-like" parameter sets (i.e., lines |
| 59 |
where species_i and species_j are identical) for each species which occurs in |
| 60 |
the file. The model driver uses the Lorentz-Berthelot rules to generate any |
| 61 |
"cross-interaction" parameter sets which are not provided. The model driver |
| 62 |
sets the `influcenceDistance' argument to max_{ij}(cutoff_{ij}). The model |
| 63 |
driver uses this same influenceDistance as its NeighborListCutoff value. |