.. index:: pair: namespace; rgpot_tersoff_capi
.. _doxid-namespacergpot__tersoff__capi:

namespace rgpot_tersoff_capi
============================

.. toctree::
	:hidden:

Overview
~~~~~~~~

C entry point for the Tersoff potential. :ref:`More...<details-namespacergpot__tersoff__capi>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	
	namespace rgpot_tersoff_capi {

	// global functions

	integer(c_int) function, public :ref:`rgpot_tersoff_force<doxid-namespacergpot__tersoff__capi_1abada7e2216871484803965a4b1e55f2e>`(integer(c_int), intent(in), value natoms, real(c_double), dimension(3, natoms), intent(in) positions, real(c_double), dimension(3, 3), intent(in) cell, real(c_double), dimension(3, natoms), intent(out) forces, real(c_double), intent(out) energy);

	} // namespace rgpot_tersoff_capi
.. _details-namespacergpot__tersoff__capi:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

C entry point for the Tersoff potential.

Only ``bind(c)`` names leave this library; the physics module exports no external symbols of its own that C could collide with. The neighbour table lives here, saved across calls so vesin reuses its buffers.

Global Functions
----------------

.. index:: pair: function; rgpot_tersoff_force
.. _doxid-namespacergpot__tersoff__capi_1abada7e2216871484803965a4b1e55f2e:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	integer(c_int) function, public rgpot_tersoff_force(integer(c_int), intent(in), value natoms, real(c_double), dimension(3, natoms), intent(in) positions, real(c_double), dimension(3, 3), intent(in) cell, real(c_double), dimension(3, natoms), intent(out) forces, real(c_double), intent(out) energy)

Evaluate Tersoff forces and energy.

``positions`` and ``forces`` are ``3 * natoms`` doubles, x/y/z interleaved; ``cell`` is nine doubles, row-major, one cell vector per row. Returns zero on success, non-zero on failure with the message available through ``rgpot_fortran_last_error``.