PartInstance

Create an instance of a geometry part.

Syntax

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

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

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

model.geom(<tag>).feature(<ftag>).geom().geomSequenceMethod;

Description

This feature creates an instance of a geometry part with new values of its input parameters. Use model.geom(<tag>).feature(<ftag>).geom() to access its local copy of the part.

The following properties are available:

Table 3-79: Valid Property/value Pairs

Property	Values	Default	Description
part	String		Tag of part to call, or local to use a local part.
inputname	String[]		Names of the input parameters (read-only).
inputexpr	String[]		Expressions for the input parameters.

The default for part is the first part in model.geom(), or local if there is none.

In 3D, the following additional properties are available to control the positioning of the output objects:

Table 3-80: Valid Property/value Pairs in 3D

Property	Values	Default	Description
workplanepart	String	xyplane	Tag of work plane in the geometry part, or xyplane.
workplanesrc	String	this	Tag of PartInstance feature to take work plane from, or this to take it from this sequence.
workplane	String	xyplane	Tag of work plane to match, or xyplane.
displ	double[3]	{0,0,0}	Displacement vector.
axistype	x | y | z | Cartesian | spherical	z	Type of rotation axis specification.
axis	double[]	{0,0,1}	Direction of rotation axis. Vector has length 3 if axistype is Cartesian and length 2 if axistype is spherical.
rot	double	0	Rotation angle.

In 2D, the following additional properties are available to control the positioning of the output objects:

Table 3-81: Valid Property/value Pairs in 2D

Property	Values	Default	Description
displ	double[2]	{0,0}	Displacement vector.
rot	double	0	Rotation angle.

For each geometric entity level (object, domain, boundary, edge, and point) that exists in the geometry, there is in addition the following properties related to the output selections for that level:

Table 3-82: Valid Property/value Pairs for Output Selections

Property	Values	Default	Description
selkeepnoncontr	on | off	on	Keep all noncontributing selections.
seltaglevel	String[]		Tags of selections (read-only).
selnamelevel	String[]		Names of selections (read-only).
selcontributetolevel	String[]	all none	Tags of cumulative selections to contribute to, or none to not contribute.
selkeeplevel	String[] with on/off values	all off	Keep selection from part (only used when selkeepnoncontr is off).
selshowlevel	String[] with on/off values	all on	Show selection in physics, materials, and so on; in part instances; or in 3D from a plane geometry.

where level is obj, dom, bnd, edg, or pnt for geometry objects, domains, boundaries, edges, and points, respectively.

Compatibility

In version 5.1, the following properties are deprecated and replaced:

Table 3-83: Deprecated Properties

Previous Name	New Name in 5.1
arg	inputname
argexpr	inputexpr
argvalue	inputvalue
argdescr	inputdescr
subsequence	part
workplanesub	workplanepart

Example

Create a geometry part that makes a torus of revolution angle a, where a is an argument (default value: 90 degrees). Then add work planes for the two planar face to make it easy to position the result:

Code for use with Java

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

GeomSequence p = model.geom().create("part1", "Part", 3);

p.inputParam().set("a", 90);

p.create("tor1", "Torus");

p.feature("tor1").set("angle", "a");

p.run("tor1");

p.create("wp1", "WorkPlane");

p.feature("wp1").set("planetype", "faceparallel");

p.feature("wp1").selection("face").set("tor1", new int[]{1});

p.feature("wp1").set("reverse", "on");

p.create("wp2", "WorkPlane");

p.feature("wp2").set("planetype", "faceparallel");

p.feature("wp2").selection("face").set("tor1", new int[]{6});

Code for use with MATLAB

model = ModelUtil.create('Model1');

p = model.geom.create('part1', 'Part', 3);

p.inputParam.set('a', 90);

p.create('tor1', 'Torus');

p.feature('tor1').set('angle', 'a');

p.run('tor1');

p.create('wp1', 'WorkPlane');

p.feature('wp1').set('planetype', 'faceparallel');

p.feature('wp1').selection('face').set('tor1', 1);

p.feature('wp1').set('reverse', 'on');

p.create('wp2', 'WorkPlane');

p.feature('wp2').set('planetype', 'faceparallel');

p.feature('wp2').selection('face').set('tor1', 6);

Create two part instances of this geometry part. The first has a = 90 (the default value), and the second has a = 120. The objects are positioned so that the two circular faces match, with a rotation angle of 50 degrees.

Code for use with Java

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

g.create("pi1", "PartInstance");

g.create("pi2", "PartInstance");

g.feature("pi2").setIndex("inputexpr", 120, 0);

g.feature("pi2").set("workplanepart", "wp1");

g.feature("pi2").set("workplanesrc", "pi1");

g.feature("pi2").set("workplane", "wp2");

g.feature("pi2").set("rot", 50);

g.run("pi2");

Code for use with MATLAB

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

g.create('pi1', 'PartInstance');

g.create('pi2', 'PartInstance');

g.feature('pi2').setIndex('inputexpr', 120, 0);

g.feature('pi2').set('workplanepart', 'wp1');

g.feature('pi2').set('workplanesrc', 'pi1');

g.feature('pi2').set('workplane', 'wp2');

g.feature('pi2').set('rot', 50);

g.run('pi2');

See Also

If, ElseIf, Else, EndIf