COMSOL 6.4 - Sphere

Sphere

Create a solid ball, surface sphere, or bounding ball in 3D.

Syntax

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

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>,"Sphere") to create a sphere. The following properties are available:

Table 3-160: Valid Property/Value Pairs for Sphere.
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.
color	none \| custom \| integer between 1 and the number of colors in the current theme	none	The color of the selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolor property. Coloring is only available when selresult in active.
contributeto	String	none	Tag of cumulative selection to contribute to.
createpar	on \| off	off	Create parameters.
customcolor	RGB-triplet	Next available theme color	The color to use. Active when color is set to custom.
definedby	size \| bounding	size	Specify if the sphere is to be defined by its size and position or be a bounding ball. See Table 3-161 when definedby is bounding.
layer	double[]		Thicknesses of layers.
pos	double[]	{0,0,0}	Center.
postype	coord \| vertex	coord	Specify position type as coordinate or vertex.
posvertex	Selection		Vertex for position. Used when postype is vertex.
r	double	1	Radius.
rot	double	0	Rotational angle about axis.
sellayer	on \| off	off	Create layer selections.
sellayershow	on \| off	on	Show layer selections in physics/instances (used if sellayer is on)
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.
type	solid \| surface	solid	Object type.
workplanesrc	this \| part-instance feature	this	Part-instance feature to take the work plane from.
workplane	xyplane \| work-plane feature	xyplane	Work-plane feature that defines the coordinate system. The default, xyplane, is the global Cartesian coordinate system.

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

Table 3-161: Additional Properties when Definedby is BouNDING.
Property	Value	Default	Description
centerdef	manual \| centroid	centroid	Specify center definition.
input	Selection		Input objects or entities.
keep	on \| off	on	Keep input objects. Only used if input is an object selection.
margin	double	0	Margin around bounding ball.

The following attributes are available:

Table 3-162: Valid attributes
Name	Value	Default	Description
construction	on \| off	off	Designate the resulting objects as construction geometry.

Compatibility

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

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

The following properties are also available:

Table 3-163: 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.