339 lines
14 KiB
C
339 lines
14 KiB
C
/* -*- c -*- ------------------------------------------------------------
|
|
LAMMPS - Large-scale Atomic/Molecular Massively Parallel Simulator
|
|
https://www.lammps.org/, Sandia National Laboratories
|
|
LAMMPS development team: developers@lammps.org
|
|
|
|
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.
|
|
------------------------------------------------------------------------- */
|
|
|
|
#ifndef LAMMPS_LIBRARY_H
|
|
#define LAMMPS_LIBRARY_H
|
|
|
|
/* C style library interface to LAMMPS which allows to create and
|
|
* control instances of the LAMMPS C++ class and exchange data with it.
|
|
* The C bindings are the basis for the Python and Fortran modules.
|
|
*
|
|
* If needed, new LAMMPS-specific functions can be added to expose
|
|
* additional LAMMPS functionality to this library interface. */
|
|
|
|
/* We follow the behavior of regular LAMMPS compilation and assume
|
|
* -DLAMMPS_SMALLBIG when no define is set. */
|
|
|
|
#if !defined(LAMMPS_BIGBIG) && !defined(LAMMPS_SMALLBIG)
|
|
#define LAMMPS_SMALLBIG
|
|
#endif
|
|
|
|
/* To allow including the library interface without MPI */
|
|
|
|
#if defined(LAMMPS_LIB_MPI)
|
|
#include <mpi.h>
|
|
#endif
|
|
|
|
#if defined(LAMMPS_BIGBIG) || defined(LAMMPS_SMALLBIG)
|
|
#include <stdint.h> /* for int64_t */
|
|
#endif
|
|
|
|
/** Data type constants for extracting data from atoms, computes and fixes
|
|
*
|
|
* Must be kept in sync with the equivalent constants in ``python/lammps/constants.py``,
|
|
* ``fortran/lammps.f90``, ``tools/swig/lammps.i``, ``src/lmptype.h``, and
|
|
*``examples/COUPLE/plugin/liblammpsplugin.h`` */
|
|
|
|
enum _LMP_DATATYPE_CONST {
|
|
LAMMPS_NONE = -1, /*!< no data type assigned (yet) */
|
|
LAMMPS_INT = 0, /*!< 32-bit integer (array) */
|
|
LAMMPS_INT_2D = 1, /*!< two-dimensional 32-bit integer array */
|
|
LAMMPS_DOUBLE = 2, /*!< 64-bit double (array) */
|
|
LAMMPS_DOUBLE_2D = 3, /*!< two-dimensional 64-bit double array */
|
|
LAMMPS_INT64 = 4, /*!< 64-bit integer (array) */
|
|
LAMMPS_INT64_2D = 5, /*!< two-dimensional 64-bit integer array */
|
|
LAMMPS_STRING = 6 /*!< C-String */
|
|
};
|
|
|
|
/** Style constants for extracting data from computes and fixes.
|
|
*
|
|
* Must be kept in sync with the equivalent constants in ``python/lammps/constants.py``,
|
|
* ``fortran/lammps.f90``, ``tools/swig/lammps.i``, and
|
|
* ``examples/COUPLE/plugin/liblammpsplugin.h`` */
|
|
|
|
enum _LMP_STYLE_CONST {
|
|
LMP_STYLE_GLOBAL = 0, /*!< return global data */
|
|
LMP_STYLE_ATOM = 1, /*!< return per-atom data */
|
|
LMP_STYLE_LOCAL = 2 /*!< return local data */
|
|
};
|
|
|
|
/** Type and size constants for extracting data from computes and fixes.
|
|
*
|
|
* Must be kept in sync with the equivalent constants in ``python/lammps/constants.py``,
|
|
* ``fortran/lammps.f90``, ``tools/swig/lammps.i``, and
|
|
* ``examples/COUPLE/plugin/liblammpsplugin.h`` */
|
|
|
|
enum _LMP_TYPE_CONST {
|
|
LMP_TYPE_SCALAR = 0, /*!< return scalar */
|
|
LMP_TYPE_VECTOR = 1, /*!< return vector */
|
|
LMP_TYPE_ARRAY = 2, /*!< return array */
|
|
LMP_SIZE_VECTOR = 3, /*!< return length of vector */
|
|
LMP_SIZE_ROWS = 4, /*!< return number of rows */
|
|
LMP_SIZE_COLS = 5 /*!< return number of columns */
|
|
};
|
|
|
|
/** Error codes to select the suitable function in the Error class
|
|
*
|
|
* Must be kept in sync with the equivalent constants in ``python/lammps/constants.py``,
|
|
* ``fortran/lammps.f90``, ``tools/swig/lammps.i``, and
|
|
* ``examples/COUPLE/plugin/liblammpsplugin.h`` */
|
|
|
|
enum _LMP_ERROR_CONST {
|
|
LMP_ERROR_WARNING = 0, /*!< call Error::warning() */
|
|
LMP_ERROR_ONE = 1, /*!< called from one MPI rank */
|
|
LMP_ERROR_ALL = 2, /*!< called from all MPI ranks */
|
|
LMP_ERROR_WORLD = 4, /*!< error on Comm::world */
|
|
LMP_ERROR_UNIVERSE = 8 /*!< error on Comm::universe */
|
|
};
|
|
|
|
/** Variable style constants for extracting data from variables.
|
|
*
|
|
* Must be kept in sync with the equivalent constants in ``python/lammps/constants.py``,
|
|
* ``fortran/lammps.f90``, ``tools/swig/lammps.i``, and
|
|
* ``examples/COUPLE/plugin/liblammpsplugin.h`` */
|
|
|
|
enum _LMP_VAR_CONST {
|
|
LMP_VAR_EQUAL = 0, /*!< compatible with equal-style variables */
|
|
LMP_VAR_ATOM = 1, /*!< compatible with atom-style variables */
|
|
LMP_VAR_VECTOR = 2, /*!< compatible with vector-style variables */
|
|
LMP_VAR_STRING = 3 /*!< return value will be a string (catch-all) */
|
|
};
|
|
|
|
/** Neighbor list settings constants
|
|
*
|
|
* Must be kept in sync with the equivalent constants in ``python/lammps/constants.py``,
|
|
* ``fortran/lammps.f90``, ``tools/swig/lammps.i``, and
|
|
* ``examples/COUPLE/plugin/liblammpsplugin.h`` */
|
|
|
|
enum _LMP_NEIGH_CONST {
|
|
LMP_NEIGH_HALF = 0, /*!< request (default) half neighbor list */
|
|
LMP_NEIGH_FULL = 1, /*!< request full neighbor list */
|
|
};
|
|
|
|
/* Ifdefs to allow this file to be included in C and C++ programs */
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Library functions to create/destroy an instance of LAMMPS
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
#if defined(LAMMPS_LIB_MPI)
|
|
void *lammps_open(int argc, char **argv, MPI_Comm comm, void **ptr);
|
|
#endif
|
|
void *lammps_open_no_mpi(int argc, char **argv, void **ptr);
|
|
void *lammps_open_fortran(int argc, char **argv, int f_comm);
|
|
void lammps_close(void *handle);
|
|
|
|
void lammps_mpi_init();
|
|
void lammps_mpi_finalize();
|
|
void lammps_kokkos_finalize();
|
|
void lammps_plugin_finalize();
|
|
void lammps_python_finalize();
|
|
|
|
void lammps_error(void *handle, int error_type, const char *error_text);
|
|
|
|
char *lammps_expand(void *handle, const char *line);
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Library functions to process commands
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
void lammps_file(void *handle, const char *file);
|
|
|
|
char *lammps_command(void *handle, const char *cmd);
|
|
void lammps_commands_list(void *handle, int ncmd, const char **cmds);
|
|
void lammps_commands_string(void *handle, const char *str);
|
|
|
|
/* -----------------------------------------------------------------------
|
|
* Library functions to extract info from LAMMPS or set data in LAMMPS
|
|
* ----------------------------------------------------------------------- */
|
|
|
|
double lammps_get_natoms(void *handle);
|
|
double lammps_get_thermo(void *handle, const char *keyword);
|
|
void *lammps_last_thermo(void *handle, const char *what, int index);
|
|
|
|
void lammps_extract_box(void *handle, double *boxlo, double *boxhi, double *xy, double *yz,
|
|
double *xz, int *pflags, int *boxflag);
|
|
void lammps_reset_box(void *handle, double *boxlo, double *boxhi, double xy, double yz, double xz);
|
|
|
|
void lammps_memory_usage(void *handle, double *meminfo);
|
|
int lammps_get_mpi_comm(void *handle);
|
|
|
|
int lammps_extract_setting(void *handle, const char *keyword);
|
|
int lammps_extract_global_datatype(void *handle, const char *name);
|
|
void *lammps_extract_global(void *handle, const char *name);
|
|
|
|
int lammps_extract_pair_dimension(void *handle, const char *name);
|
|
void *lammps_extract_pair(void *handle, const char *name);
|
|
|
|
int lammps_map_atom(void *handle, const void *id);
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Library functions to read or modify per-atom data in LAMMPS
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
int lammps_extract_atom_datatype(void *handle, const char *name);
|
|
int lammps_extract_atom_size(void *handle, const char *name, int type);
|
|
void *lammps_extract_atom(void *handle, const char *name);
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Library functions to access data from computes, fixes, variables in LAMMPS
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
void *lammps_extract_compute(void *handle, const char *id, int style, int type);
|
|
void *lammps_extract_fix(void *handle, const char *id, int style, int type, int nrow, int ncol);
|
|
void *lammps_extract_variable(void *handle, const char *name, const char *group);
|
|
int lammps_extract_variable_datatype(void *handle, const char *name);
|
|
int lammps_set_variable(void *handle, const char *name, const char *str);
|
|
int lammps_set_string_variable(void *handle, const char *name, const char *str);
|
|
int lammps_set_internal_variable(void *handle, const char *name, double value);
|
|
int lammps_variable_info(void *handle, int idx, char *buf, int bufsize);
|
|
double lammps_eval(void *handle, const char *expr);
|
|
|
|
void lammps_clearstep_compute(void *handle);
|
|
void lammps_addstep_compute_all(void *handle, void * nextstep);
|
|
void lammps_addstep_compute(void *handle, void * nextstep);
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Library functions for scatter/gather operations of data
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
void lammps_gather_atoms(void *handle, const char *name, int type, int count, void *data);
|
|
void lammps_gather_atoms_concat(void *handle, const char *name, int type, int count, void *data);
|
|
void lammps_gather_atoms_subset(void *handle, const char *name, int type, int count, int ndata,
|
|
int *ids, void *data);
|
|
void lammps_scatter_atoms(void *handle, const char *name, int type, int count, void *data);
|
|
void lammps_scatter_atoms_subset(void *handle, const char *name, int type, int count, int ndata,
|
|
int *ids, void *data);
|
|
|
|
void lammps_gather_bonds(void *handle, void *data);
|
|
void lammps_gather_angles(void *handle, void *data);
|
|
void lammps_gather_dihedrals(void *handle, void *data);
|
|
void lammps_gather_impropers(void *handle, void *data);
|
|
|
|
void lammps_gather(void *handle, const char *name, int type, int count, void *data);
|
|
void lammps_gather_concat(void *handle, const char *name, int type, int count, void *data);
|
|
void lammps_gather_subset(void *handle, const char *name, int type, int count, int ndata, int *ids,
|
|
void *data);
|
|
void lammps_scatter(void *handle, const char *name, int type, int count, void *data);
|
|
void lammps_scatter_subset(void *handle, const char *name, int type, int count, int ndata, int *ids,
|
|
void *data);
|
|
|
|
#if !defined(LAMMPS_BIGBIG)
|
|
int lammps_create_atoms(void *handle, int n, const int *id, const int *type, const double *x,
|
|
const double *v, const int *image, int bexpand);
|
|
#else
|
|
int lammps_create_atoms(void *handle, int n, const int64_t *id, const int *type, const double *x,
|
|
const double *v, const int64_t *image, int bexpand);
|
|
#endif
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Library functions for accessing neighbor lists
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
int lammps_find_pair_neighlist(void *handle, const char *style, int exact, int nsub, int request);
|
|
int lammps_find_fix_neighlist(void *handle, const char *id, int request);
|
|
int lammps_find_compute_neighlist(void *handle, const char *id, int request);
|
|
int lammps_request_single_neighlist(void *handle, const char *id, int flags, double cutoff);
|
|
int lammps_neighlist_num_elements(void *handle, int idx);
|
|
void lammps_neighlist_element_neighbors(void *handle, int idx, int element, int *iatom,
|
|
int *numneigh, int **neighbors);
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Library functions for retrieving configuration information
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
int lammps_version(void *handle);
|
|
void lammps_get_os_info(char *buffer, int buf_size);
|
|
|
|
int lammps_config_has_mpi_support();
|
|
int lammps_config_has_gzip_support();
|
|
int lammps_config_has_png_support();
|
|
int lammps_config_has_jpeg_support();
|
|
int lammps_config_has_ffmpeg_support();
|
|
int lammps_config_has_curl_support();
|
|
int lammps_config_has_exceptions();
|
|
|
|
int lammps_config_has_package(const char *);
|
|
int lammps_config_package_count();
|
|
int lammps_config_package_name(int, char *, int);
|
|
|
|
int lammps_config_accelerator(const char *, const char *, const char *);
|
|
int lammps_has_gpu_device();
|
|
void lammps_get_gpu_device_info(char *buffer, int buf_size);
|
|
|
|
int lammps_has_style(void *, const char *, const char *);
|
|
int lammps_style_count(void *, const char *);
|
|
int lammps_style_name(void *, const char *, int, char *, int);
|
|
|
|
int lammps_has_id(void *, const char *, const char *);
|
|
int lammps_id_count(void *, const char *);
|
|
int lammps_id_name(void *, const char *, int, char *, int);
|
|
|
|
int lammps_plugin_count();
|
|
int lammps_plugin_name(int, char *, char *, int);
|
|
|
|
/* ----------------------------------------------------------------------
|
|
* Utility functions
|
|
* ---------------------------------------------------------------------- */
|
|
|
|
#if !defined(LAMMPS_BIGBIG)
|
|
int lammps_encode_image_flags(int ix, int iy, int iz);
|
|
void lammps_decode_image_flags(int image, int *flags);
|
|
#else
|
|
int64_t lammps_encode_image_flags(int ix, int iy, int iz);
|
|
void lammps_decode_image_flags(int64_t image, int *flags);
|
|
#endif
|
|
|
|
#if defined(LAMMPS_BIGBIG)
|
|
typedef void (*FixExternalFnPtr)(void *, int64_t, int, int64_t *, double **, double **);
|
|
#else
|
|
typedef void (*FixExternalFnPtr)(void *, int64_t, int, int *, double **, double **);
|
|
#endif
|
|
|
|
void lammps_set_fix_external_callback(void *handle, const char *id, FixExternalFnPtr funcptr,
|
|
void *ptr);
|
|
double **lammps_fix_external_get_force(void *handle, const char *id);
|
|
void lammps_fix_external_set_energy_global(void *handle, const char *id, double eng);
|
|
void lammps_fix_external_set_energy_peratom(void *handle, const char *id, double *eng);
|
|
void lammps_fix_external_set_virial_global(void *handle, const char *id, double *virial);
|
|
void lammps_fix_external_set_virial_peratom(void *handle, const char *id, double **virial);
|
|
void lammps_fix_external_set_vector_length(void *handle, const char *id, int len);
|
|
void lammps_fix_external_set_vector(void *handle, const char *id, int idx, double val);
|
|
|
|
void lammps_flush_buffers(void *ptr);
|
|
|
|
void lammps_free(void *ptr);
|
|
|
|
int lammps_is_running(void *handle);
|
|
void lammps_force_timeout(void *handle);
|
|
|
|
int lammps_has_error(void *handle);
|
|
int lammps_get_last_error_message(void *handle, char *buffer, int buf_size);
|
|
int lammps_set_show_error(void *handle, const int flag);
|
|
|
|
int lammps_python_api_version();
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* LAMMPS_LIBRARY_H */
|
|
|
|
/* Local Variables:
|
|
* fill-column: 72
|
|
* End: */
|