NSMinDistance

Calculates the minimum distance from nodes to elements.

Inputs

from_id_list
List of IDs in from_sets to calculate distance from.
to_id_list
List of IDs in to_sets to calculate distance to.
from_coord
Coordinate table associated with from nodes.
to_coord
Coordinate table associated with to elements.
from_sets
Set table associated with from nodes.
to_sets
Set table associated with to elements.
display
String controlling output (byall = default, bymin, bymax).
elems
Element entity table.
pool_name
Name of the element pool in the set.
set_pool
Set pool name (typically “shell” or “ELEMENT_SHELL”).
max_depth
Spatialization depth (default=”7”, maximum=”12”).

Outputs

answer
A real nodal vector table.

Comments

  • NSMinDistance can compute inter-model distance (distance between nodes and elements in the same model) and cross-model distance (distance from nodes in one model to elements in another).
  • When calculating inter-model distance:
    • from_coord and to_coord can refer to the same coordinate table.
    • sets must be utilized in order to select a patch of nodes to compute distance from to a set of elements.
  • When calculating cross-model distance:
    • from_coord and to_coord must refer to the relevant coordinate tables in each model.
    • Sets can be empty, in which case the distance will be from all nodes in the “from” model to all elements in the “to” model.
  • Set ID lists can contain multiple entries. This is desirable when computing distance from multiple source and destination patches. The syntax is as follows:
    • Patches are separated by semi-colons.
    • from_id_list = "1,2,3" to_id_list = "4" – defines one patch to plot the distance from sets 1,2,3 to set id 4.
    • from_id_list = "1,2;3,4" to id_list="5;6" – defines two patches to plot the distance from sets 1 & 2 to set 5 and 3 & 4 to set 6.

Syntax

N/A

XML Example

<call name="NSMinDistance" 
from_id_list="1" to_id_list="3" from_coord="from_coords" to_coord="to_coords" 
elems="slems" from_sets="from_sets" 
to_sets="to_sets" 
answer="answer" max_depth="10" />