Tangent

Create a tangent line segment to one or two 2D edges.

Syntax

model.geom(<tag>).create(<ftag>,"Tangent");

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

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

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

Description

Use model.geom(<tag>).create(<ftag>,"Tangent") to create a line segment tangent to two edges or tangent to one edge with a fixed end point. The following properties are available:

Table 3-100: Valid Property/Value Pairs for Tangent

Property	Value	Default	Description
edge	Selection		Edge in an geometry object to find tangent to.
start	double	0.5	Start guess for parameter value of point of tangency.
type	edge | point | coord	edge	Type of tangent.
selresult	on | off	off	Create selections of all resulting objects.
selresultshow	all | obj | bnd | edg | pnt | off	bnd	Show selections, if selresult is on, in physics, materials, and so on; in part instances; or in 3D from a plane geometry. obj is not available in a component’s geometry. dom, bnd, and edg are not available in all features.
contributeto	String	none	Tag of cumulative selection to contribute to.

If type is edge a common tangent line to two edges are constructed. Then, the following additional properties are available:

Table 3-101: Valid Property/Value Pairs

Property	Value	Default	Description
edge2	Selection		Second edge in some geometry object to find tangent to.
start2	double	0.5	Start guess for parameter value of point of tangency.

If type is point a tangent line through a given point is constructed. Then, the following additional property is available:

Table 3-102: Valid Property/Value Pairs

Property	Value	Default	Description
point	Selection		Point in some geometry object.

If type is coord a tangent line through a point with given coordinates are constructed. Then, the following additional property is available:

Table 3-103: Valid Property/Value Pairs

Property	Value	Default	Description
coord	double[]	{0,0}	Coordinates.

If a tangent cannot be found, a tangent to some adjacent edge is constructed, if possible.

For information about the selresult and contributeto properties, see Selections of Geometric Entities.

Compatibility

model.geom(gname).create(fname,"tangent") creates a Tangent feature.

The following properties are no longer supported:

Table 3-104: obsolete Property/Value Pairs

Property name	property Value	Default	Description
edim1	0 | 1	geometry dependent	Starting point element dimension: 0 for vertex, 1 for edge.
edim2	0 | 1	geometry dependent	Ending point element dimension: 0 for vertex, 1 for edge.
dom1	integer	1	Starting point entity number.
dom2	integer	1	Ending point entity number.
out	cell array of Strings	{}	Additional output data.
start1	double	0.5	Starting point parameter value on specified edge.

Example

The following sequence generates a tangent from the unit circle to the point (2, 0):

Code for use with Java

Model model = ModelUtil.create("Model1");

GeomSequence g = model.geom().create("geom1",2);

g.create("c1","Circle");

g.run("c1");

g.create("tan1","Tangent");

g.feature("tan1").set("type","coord");

g.feature("tan1").selection("edge").set("c1",3);

g.feature("tan1").set("coord","2 0");

g.run();

Code for use with MATLAB

model = ModelUtil.create('Model1');

g = model.geom.create('geom1',2);

g.create('c1','Circle');

g.run('c1');

g.create('tan1','Tangent');

g.feature('tan1').set('type','coord');

g.feature('tan1').selection('edge').set('c1',3);

g.feature('tan1').set('coord','2 0');

g.run;

The following sequence generates a common tangent between two circles:

Code for use with Java

Model model = ModelUtil.create("Model1");

GeomSequence g = model.geom().create("geom1",2);

g.create("c1","Circle");

g.create("c2","Circle");

g.feature("c2").set("pos", "2 2");

g.run("c2");

g.create("tan1","Tangent");

g.feature("tan1").selection("edge").set("c1",4);

g.feature("tan1").selection("edge2").set("c2",4);

g.run();

Code for use with MATLAB

model = ModelUtil.create('Model1');

g = model.geom.create('geom1',2);

g.create('c1','Circle');

g.create('c2','Circle');

g.feature('c2').set('pos', '2 2');

g.run('c2');

g.create('tan1','Tangent');

g.feature('tan1').selection('edge').set('c1',4);

g.feature('tan1').selection('edge2').set('c2',4);

g.run;

See Also

BezierPolygon