.. index:: pair: namespace; rgpot_sw_capi
.. _doxid-namespacergpot__sw__capi:

namespace rgpot_sw_capi
=======================

.. toctree::
	:hidden:

Overview
~~~~~~~~

C entry point for the Stillinger-Weber potential. :ref:`More...<details-namespacergpot__sw__capi>`


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

	
	namespace rgpot_sw_capi {

	// global functions

	integer(c_int) function, public :ref:`rgpot_sw_force<doxid-namespacergpot__sw__capi_1ae1b98f5cc973ec3dc3143b85a7db1955>`(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_sw_capi
.. _details-namespacergpot__sw__capi:

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

C entry point for the Stillinger-Weber 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_sw_force
.. _doxid-namespacergpot__sw__capi_1ae1b98f5cc973ec3dc3143b85a7db1955:

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

	integer(c_int) function, public rgpot_sw_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 Stillinger-Weber 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``.