Files
lammps/src/KIM/kim_property.cpp
2021-05-24 14:18:20 -04:00

456 lines
15 KiB
C++

// clang-format off
/* ----------------------------------------------------------------------
LAMMPS - Large-scale Atomic/Molecular Massively Parallel Simulator
https://www.lammps.org/, Sandia National Laboratories
Steve Plimpton, sjplimp@sandia.gov
Copyright (2003) Sandia Corporation. Under the terms of Contract
DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains
certain rights in this software. This software is distributed under
the GNU General Public License.
See the README file in the top-level LAMMPS directory.
------------------------------------------------------------------------- */
/* ----------------------------------------------------------------------
Contributing author: Yaser Afshar (UMN)
------------------------------------------------------------------------- */
/* ----------------------------------------------------------------------
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 2 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 <https://www.gnu.org/licenses>.
Linking LAMMPS statically or dynamically with other modules is making a
combined work based on LAMMPS. Thus, the terms and conditions of the GNU
General Public License cover the whole combination.
In addition, as a special exception, the copyright holders of LAMMPS give
you permission to combine LAMMPS with free software programs or libraries
that are released under the GNU LGPL and with code included in the standard
release of the "kim-api" under the CDDL (or modified versions of such code,
with unchanged license). You may copy and distribute such a system following
the terms of the GNU GPL for LAMMPS and the licenses of the other code
concerned, provided that you include the source code of that other code
when and as the GNU GPL requires distribution of source code.
Note that people who make modified versions of LAMMPS are not obligated to
grant this special exception for their modified versions; it is their choice
whether to do so. The GNU General Public License gives permission to release
a modified version without this exception; this exception also makes it
possible to release a modified version which carries forward this exception.
------------------------------------------------------------------------- */
/* ----------------------------------------------------------------------
Designed for use with the kim-api-2.1.0 (and newer) package
------------------------------------------------------------------------- */
#include "kim_property.h"
#include "comm.h"
#include "error.h"
#include "input.h"
#include "lmppython.h"
#include "variable.h"
#if LMP_PYTHON
#define PY_SSIZE_T_CLEAN
#include <Python.h> // IWYU pragma: export
#endif
using namespace LAMMPS_NS;
/* ---------------------------------------------------------------------- */
KimProperty::KimProperty(LAMMPS *lmp) : Pointers(lmp)
{
// one-time initialization of Python interpreter
python->init();
if (!python->has_minimum_version(3, 6))
error->all(FLERR, "Invalid Python version.\nThe kim-property Python "
"package requires Python 3 >= 3.6 support");
}
void KimProperty::command(int narg, char **arg)
{
#if LMP_PYTHON
#if PY_MAJOR_VERSION >= 3
if (narg < 2) error->all(FLERR, "Invalid 'kim property' command");
const std::string subcmd(arg[0]);
if ((subcmd != "create") && (subcmd != "destroy") && (subcmd != "modify") &&
(subcmd != "remove") && (subcmd != "dump")) {
std::string msg("Incorrect arguments in 'kim property' command.\n");
msg += "'kim property create/destroy/modify/remove/dump' is mandatory";
error->all(FLERR, msg);
}
input->write_echo("#=== kim property ====================================="
"======\n");
// Get the kim_str ptr to the data associated with a kim_property_str
// variable
char *kim_str = input->variable->retrieve("kim_property_str");
PyGILState_STATE gstate = PyGILState_Ensure();
// kim_property module
PyObject *kim_property = nullptr;
// import kim_property
{
PyObject *obj = PyUnicode_FromString("kim_property");
if (!obj) {
PyGILState_Release(gstate);
error->all(FLERR, "Failed to create a 'PyObject'");
}
kim_property = PyImport_Import(obj);
if (!kim_property) {
PyGILState_Release(gstate);
std::string msg("Unable to import Python kim_property module!");
msg += "\nkim-property Python package can be installed with pip:\n";
msg += "'pip install kim-property'\nSee the installation instructions ";
msg += "at\nhttps://github.com/openkim/kim-property#installing-kim-";
msg += "property\nfor detailed information";
error->all(FLERR, msg);
}
// Decrementing of the reference count
Py_XDECREF(obj);
}
// kim_property create 1 cohesive-potential-energy-cubic-crystal
if (subcmd == "create") {
if (narg != 3) {
PyGILState_Release(gstate);
error->all(FLERR, "Invalid 'kim property create' command");
}
int const ID = utils::inumeric(FLERR, arg[1], true, lmp);
Py_ssize_t const nSize = (kim_str ? 3 : 2);
// Python function
// This is the equivalent of the Python expression:
// kim_property.kim_property_create.
PyObject *pFunc =
PyObject_GetAttrString(kim_property, "kim_property_create");
if (!pFunc) {
PyGILState_Release(gstate);
std::string msg("Unable to get an attribute named ");
msg += "'kim_property_create' from a kim_property object";
error->all(FLERR, msg);
}
// Decrementing of the reference count
Py_XDECREF(kim_property);
// create Python tuple of input arguments
PyObject *pArgs = PyTuple_New(nSize);
if (!pArgs) {
PyGILState_Release(gstate);
error->all(FLERR, "Could not create Python function arguments");
}
// Python object to set the tuple
// Property ID
PyObject *pValue = PyLong_FromLong(ID);
PyTuple_SetItem(pArgs, 0, pValue);
// Property name
pValue = PyUnicode_FromString(arg[2]);
PyTuple_SetItem(pArgs, 1, pValue);
if (nSize == 3) {
pValue = PyUnicode_FromString(kim_str);
PyTuple_SetItem(pArgs, 2, pValue);
}
// call the Python kim_property_create function
// error check with one() since only some procs may fail
pValue = PyObject_CallObject(pFunc, pArgs);
if (!pValue) {
PyErr_Print();
PyGILState_Release(gstate);
std::string msg("Python 'kim_property_create' function ");
msg += "evaluation failed";
error->one(FLERR, msg);
}
// Python function returned a string value
const char *pystr = PyUnicode_AsUTF8(pValue);
if (kim_str) input->variable->set_string("kim_property_str", pystr);
else
input->variable->set(fmt::format("kim_property_str string '{}'", pystr));
Py_XDECREF(pArgs);
Py_XDECREF(pFunc);
Py_XDECREF(pValue);
} else if (subcmd == "destroy") {
if (narg != 2) {
PyGILState_Release(gstate);
error->all(FLERR, "Invalid 'kim property destroy' command");
}
if (!kim_str) {
PyGILState_Release(gstate);
return;
}
int const ID = utils::inumeric(FLERR, arg[1], true, lmp);
// Python function
// This is the equivalent of the Python expression
// kim_property.kim_property_destroy
PyObject *pFunc =
PyObject_GetAttrString(kim_property, "kim_property_destroy");
if (!pFunc) {
PyGILState_Release(gstate);
std::string msg("Unable to get an attribute named ");
msg += "'kim_property_destroy' from a kim_property object";
error->all(FLERR, msg);
}
// Decrementing of the reference count
Py_XDECREF(kim_property);
// create Python tuple of input arguments
PyObject *pArgs = PyTuple_New(2);
if (!pArgs) {
PyGILState_Release(gstate);
error->all(FLERR, "Could not create Python function arguments");
}
// Python object to set the tuple
PyObject *pValue = PyUnicode_FromString(kim_str);
PyTuple_SetItem(pArgs, 0, pValue);
pValue = PyLong_FromLong(ID);
PyTuple_SetItem(pArgs, 1, pValue);
// call the Python kim_property_destroy function
// error check with one() since only some procs may fail
pValue = PyObject_CallObject(pFunc, pArgs);
if (!pValue) {
PyErr_Print();
PyGILState_Release(gstate);
std::string msg("Python 'kim_property_destroy' function ");
msg += "evaluation failed";
error->one(FLERR, msg);
}
// Python function returned a string value
const char *pystr = PyUnicode_AsUTF8(pValue);
input->variable->set_string("kim_property_str", pystr);
Py_XDECREF(pArgs);
Py_XDECREF(pFunc);
Py_XDECREF(pValue);
} else if (subcmd == "modify") {
if (narg < 6) {
PyGILState_Release(gstate);
error->all(FLERR, "Invalid 'kim property modify' command");
}
if (!kim_str) {
PyGILState_Release(gstate);
error->all(FLERR, "There is no property instance to modify the content");
}
int const ID = utils::inumeric(FLERR, arg[1], true, lmp);
// Python function
// This is the equivalent of the Python expression
// kim_property.kim_property_modify
PyObject *pFunc =
PyObject_GetAttrString(kim_property, "kim_property_modify");
if (!pFunc) {
PyGILState_Release(gstate);
std::string msg("Unable to get an attribute named ");
msg += "'kim_property_modify' from a kim_property object";
error->all(FLERR, msg);
}
// Decrementing of the reference count
Py_XDECREF(kim_property);
// create Python tuple of input arguments
PyObject *pArgs = PyTuple_New(static_cast<Py_ssize_t>(narg));
if (!pArgs) {
PyGILState_Release(gstate);
error->all(FLERR, "Could not create Python function arguments");
}
// Python object to set the tuple
PyObject *pValue = PyUnicode_FromString(kim_str);
PyTuple_SetItem(pArgs, 0, pValue);
pValue = PyLong_FromLong(ID);
PyTuple_SetItem(pArgs, 1, pValue);
for (Py_ssize_t i = 2; i < static_cast<Py_ssize_t>(narg); ++i) {
pValue = PyUnicode_FromString(arg[i]);
PyTuple_SetItem(pArgs, i, pValue);
}
// call the Python kim_property_modify function
// error check with one() since only some procs may fail
pValue = PyObject_CallObject(pFunc, pArgs);
if (!pValue) {
PyErr_Print();
PyGILState_Release(gstate);
std::string msg("Python 'kim_property_modify' function ");
msg += "evaluation failed";
error->one(FLERR, msg);
}
// Python function returned a string value
const char *pystr = PyUnicode_AsUTF8(pValue);
input->variable->set_string("kim_property_str", pystr);
Py_XDECREF(pArgs);
Py_XDECREF(pFunc);
Py_XDECREF(pValue);
} else if (subcmd == "remove") {
if (narg < 4) {
PyGILState_Release(gstate);
error->all(FLERR, "Invalid 'kim property remove' command");
}
if (!kim_str) {
PyGILState_Release(gstate);
error->all(FLERR, "There is no property instance to remove the content");
}
int const ID = utils::inumeric(FLERR, arg[1], true, lmp);
// Python function
// This is the equivalent of the Python expression
// kim_property.kim_property_remove
PyObject *pFunc =
PyObject_GetAttrString(kim_property, "kim_property_remove");
if (!pFunc) {
PyGILState_Release(gstate);
std::string msg("Unable to get an attribute named ");
msg += "'kim_property_remove' from a kim_property object";
error->all(FLERR, msg);
}
// Decrementing of the reference count
Py_XDECREF(kim_property);
// create Python tuple of input arguments
PyObject *pArgs = PyTuple_New(static_cast<Py_ssize_t>(narg));
if (!pArgs) {
PyGILState_Release(gstate);
error->all(FLERR, "Could not create Python function arguments");
}
// Python object to set the tuple
PyObject *pValue = PyUnicode_FromString(kim_str);
PyTuple_SetItem(pArgs, 0, pValue);
pValue = PyLong_FromLong(ID);
PyTuple_SetItem(pArgs, 1, pValue);
for (Py_ssize_t i = 2; i < static_cast<Py_ssize_t>(narg); ++i) {
pValue = PyUnicode_FromString(arg[i]);
PyTuple_SetItem(pArgs, i, pValue);
}
// call the Python kim_property_remove function
// error check with one() since only some procs may fail
pValue = PyObject_CallObject(pFunc, pArgs);
if (!pValue) {
PyErr_Print();
PyGILState_Release(gstate);
std::string msg("Python 'kim_property_remove' function ");
msg += "evaluation failed";
error->one(FLERR, msg);
}
// Python function returned a string value
const char *pystr = PyUnicode_AsUTF8(pValue);
input->variable->set_string("kim_property_str", pystr);
Py_XDECREF(pArgs);
Py_XDECREF(pFunc);
Py_XDECREF(pValue);
} else if (subcmd == "dump") {
if (narg != 2) {
PyGILState_Release(gstate);
error->all(FLERR, "Invalid 'kim property dump' command");
}
if (!kim_str) {
PyGILState_Release(gstate);
error->all(FLERR, "There is no property instance to dump the content.");
}
// Python function
// This is the equivalent of the Python expression
// kim_property.kim_property_dump
PyObject *pFunc =
PyObject_GetAttrString(kim_property, "kim_property_dump");
if (!pFunc) {
PyGILState_Release(gstate);
std::string msg("Unable to get an attribute named ");
msg += "'kim_property_dump' from a kim_property object";
error->all(FLERR, msg);
}
// Decrementing of the reference count
Py_XDECREF(kim_property);
// create Python tuple of input arguments
PyObject *pArgs = PyTuple_New(2);
if (!pArgs) {
PyGILState_Release(gstate);
error->all(FLERR, "Could not create Python function arguments");
}
// Python object to set the tuple
PyObject *pValue = PyUnicode_FromString(kim_str);
PyTuple_SetItem(pArgs, 0, pValue);
pValue = PyUnicode_FromString(arg[1]);
PyTuple_SetItem(pArgs, 1, pValue);
if (comm->me == 0) {
// call the Python kim_property_dump function
// error check with one() since only some procs may fail
pValue = PyObject_CallObject(pFunc, pArgs);
if (!pValue) {
PyErr_Print();
PyGILState_Release(gstate);
std::string msg("Python 'kim_property_dump' function ");
msg += "evaluation failed";
error->one(FLERR, msg);
}
} else
pValue = nullptr;
// Destroy the variable
input->variable->set("kim_property_str delete");
Py_XDECREF(pArgs);
Py_XDECREF(pFunc);
Py_XDECREF(pValue);
}
PyGILState_Release(gstate);
#endif // PY_MAJOR_VERSION
#endif // LMP_PYTHON
}