Sphere

Create a solid ball or surface sphere in 3D.

Syntax

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

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

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

Description

Use model.geom(<tag>).create(<ftag>,"Sphere") to create a sphere. The following properties are available:

Table 3-94: Valid Property/Value Pairs

Property	Value	Default	Description
axis	double[]	{0,0,1}	Direction of the local z-axis. Vector has length 3 if axistype is cartesian, and length 2 if axistype is spherical.
axistype	x | y | z | cartesian | spherical	z	Coordinate system used for axis. The value is synchronized with axis.
layer	double[]		Thicknesses of layers.
pos	double[]	{0,0,0}	Center.
r	double	1	Radius.
rot	double	0	Rotational angle about axis.
type	solid | surface	solid	Object type.
selresult	on | off	off	Create selections of all resulting objects.
selresultshow	all | obj | dom | bnd | edg | pnt | off	dom	Show selections, if selresult is on, of resulting objects in physics, materials, and so on, or in part instances. 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.

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

Compatibility

model.geom(<tag>).create(<ftag>,"sphere3") creates a solid sphere.

model.geom(<tag>).create(<ftag>,"sphere2") creates a surface sphere.

The following properties are also available:

Table 3-95: Valid Property/Value Pairs

Property	Value	Default	Description
ax2	double[]	{0,0}	Alias for axis when axistype is spherical.
ax3	double[]	{0,0,1}	Alias for axis when axistype is cartesian.
x, y, z	double	0	Alias for pos.

The property const is no longer available.

Example

The following commands create a surface and solid sphere, where the position and radius are defined differently:

Code for use with Java

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

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

g.create("s2","Sphere");

g.feature("s2").set("type","surface");

g.feature("s2").set("pos","0 1 0");

g.create("s3","Sphere");

g.feature("s3").set("r",4);

g.run();

Code for use with MATLAB

model = ModelUtil.create('Model1');

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

g.create('s2','Sphere');

g.feature('s2').set('type','surface');

g.feature('s2').set('pos','0 1 0');

g.create('s3','Sphere');

g.feature('s3').set('r',4);

g.run;

See Also

 Ellipsoid