DistanceMeasurement

Create parameters that measure the shortest Euclidean distance and vectorial distances between two points or between a point and an edge.

Syntax

model.component(<ctag>).geom(<tag>).create(<ftag>,"DistanceMeasurement");

model.component(<ctag>).geom(<tag>).feature(<ftag>).selection(property);

model.component(<ctag>).geom(<tag>).feature(<ftag>).set(property,<value>);

model.component(<ctag>).geom(<tag>).feature(<ftag>).getType(property);

model.component(<ctag>).geom(<tag>).feature(<ftag>).setAttribute(attribute,<value>);

model.component(<ctag>).geom(<tag>).feature(<ftag>).getAttribute(attribute);

Description

Use model.component(<ctag>).geom(<tag>).create(<ftag>,"DistanceMeasurement") to create parameters for distance and vectorial distance.

Use the following methods to specify the dimension of the second entity as well as selecting it:

model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("ent2").init()

model.component(<ctag>).geom(<tag>).feature(<ftag>).selection("ent2").set()

to select the end edge, boundary or point of the measurement. The default selection is empty.

Use double[] parvalues = model.component(<ctag>).geom(<tag>).feature(<ftag>).getDoubleArray("parvalvec"); to access the parameter values (similar for parval).

Table 3-65: Valid Property/Value Pairs.
Property	Value	Default	Description
ent1	Selection		Specify a vertex as first entity.
ent2	Selection		Specify a second entity. Dimension 0 and 1 supported.
extendent	on \| off	off	Extend a straight or circular edge specified in ent2.
parname	String		Parameter names for the Euclidean distance.
parnamevec	String[]		Parameter names for the vectorial distances. The array has the length of the space dimension, sdim
parval	double		To access parameter value of Euclidean distance (read-only).
parvalvec	double[]		To access parameter values of vectorial distances (read-only).