Skip to main content

Rocky Solver SDK 2026 R1

Structure IRockyVicinityPair

Last update: 09.03.2026

#include <rocky_vicinity_pair_api.hpp>

The IRockyVicinityPair class models the vicinity between two distinct simulation entities (particles or triangles) and provide methods to allow the computation of vicinity conditions depending on the custom model that one is implementing.

Members

Public functions

Function get_home_particle

ROCKY_FUNCTIONS IRockyParticle IRockyVicinityPair::get_home_particle() const

Returns:

An IRockyParticle object representing the home particle. This object gives access to several instantaneous properties associated to that particle.

Return type: ROCKY_FUNCTIONS IRockyParticle

Function get_near_particle

ROCKY_FUNCTIONS IRockyParticle IRockyVicinityPair::get_near_particle() const

Returns:

An IRockyParticle object representing the near particle. This object gives access to several instantaneous properties associated to that particle.

Return type: ROCKY_FUNCTIONS IRockyParticle

Function get_near_triangle

ROCKY_FUNCTIONS IRockyGeometryTriangle IRockyVicinityPair::get_near_triangle() const

Returns:

An IRockyGeometryTriangle object representing the near triangle. This object gives access to several instantaneous properties associated to that triangle.

Return type: ROCKY_FUNCTIONS IRockyGeometryTriangle

Function is_particle_particle

ROCKY_FUNCTIONS bool IRockyVicinityPair::is_particle_particle() const

Returns:

True if the pair represents a particle-to-particle vicinity, false otherwise.

Return type: ROCKY_FUNCTIONS bool

Function is_particle_triangle

ROCKY_FUNCTIONS bool IRockyVicinityPair::is_particle_triangle() const

Returns:

True if the pair represents a particle-to-triangle vicinity, false otherwise.

Return type: ROCKY_FUNCTIONS bool

Function get_distance

ROCKY_FUNCTIONS double IRockyVicinityPair::get_distance() const

Returns:

The distance between the centroids of the two entities in the vicinity.

Return type: ROCKY_FUNCTIONS double

Function get_squared_distance

ROCKY_FUNCTIONS double IRockyVicinityPair::get_squared_distance() const

!> Attention
This method performs better than IRockyVicinityPair because it don't require a computational costly computation of a square root of the squared distance between entities centroids.

Returns:

The squared distance between the centroids of the two entities in the vicinity.

Return type: ROCKY_FUNCTIONS double

Connect with Ansys