COMSOL 6.3 - CreateEdges

Create geometrical edges of a selection of mesh edges or between two vertices.

model.component(<ctag>).mesh(<tag>).create(<ftag>,"CreateEdges");

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

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

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

Use model.component(<ctag>).mesh(<tag>).create(<ftag>,"CreateEdges") to create additional edges in a mesh that defines its own geometric model. For more information, see Geometric Model.

Choose between creating new meshed edges between vertices or converting existing mesh edges into edge elements. In the general case, converting mesh edges is most easily done by clicking in the Graphics window, as the midpoint coordinates must be exact.

When specifying start/end vertices, specify the size distribution in four different ways: by specifying the number of elements only, by specifying the maximum element size, by specifying the element distribution explicitly, or by specifying the number of elements together with properties determining the distribution of the elements. The property type determines which of the four alternatives you want to use.

The following properties are available:

Table 4-29: Available Properties for CreateEdges.
Property	Value	Default	Description
edgespec	vertices \| meshedge	vertices	Specifies how to create edges. Either give selections of start/end vertices, or give exact coordinates of a mesh edge’s midpoint.
start	Selection		Starting vertices to create edges from when edgespec is vertices.
end	Selection		End vertices to create edges to when edgespec is vertices.
type	size \| number \| explicit \| predefined	size	Size distribution type when edgespec is vertices.
coordsel	double[][]	{}	Enter exact midpoint coordinates of mesh edge when edgespec is meshedges.
groupcontang	on \| off	off	Specifies if a selection of a mesh edge is propagated to tangent edges. Used if edgespec is meshedge.
angletol	double	10	Specifies which mesh edges are considered tangent when groupcontang is on.
seldom	on \| off	off	Specifies if to create a selection of resulting small domains. Used in 2D.
seledg	on \| off	off	Specifies if to create a selection of resulting edges.
selfac	on \| off	off	Specifies if to create a selection of resulting small faces. Used in 3D.

Table 4-30: Available Additional Property When type is SET to size.
Property	Value	Default	Description
size	double	0.1*(size of bounding box) (3D); (size of bounding box) / 15 (2D)	Maximum element size.

Table 4-31: Available Additional Property when type is number.
Property	Value	Default	Description
numelem	integer	1	Number of elements.

Table 4-32: Available Additional Properties when type is explicit.
Property	Value	Default	Description
explicit	double[]	{0,1}	Specify the relative placement of vertices along the edge.
reverse	on \| off	on	Reverse the direction of the explicit distribution.

Table 4-33: Available Additional Properties when type is predefined.
Property	Value	Default	Description
elemcount	integer	5	Number of elements.
elemratio	double	1	Specify the ratio in size between the last element and first element along the edge.
method	arithmetic \| geometric	arithmetic	Specifies if the element size is linearly growing (arithmetic sequence) or exponentially growing (geometric sequence).
reverse	on \| off	off	Specify if the distribution is defined in the opposite edge direction for the edge in the selection with lowest index.
symmetric	on \| off	off	Specify if the distribution is made symmetric.

Table 4-34: Available Additional Property When seledg is SET to on.
Property	Value	Default	Description
seledgshow	on \| off	on	Show edge selection in physics, materials, and so on. For mesh parts, this option shows selection outside the part. Used if seledg is on.

Table 4-35: Available Additional Properties when selfac and seldom are set to ON.
Property	Value	Default	Description
colorcompl	none \| custom \| integer between 1 and the number of colors in the current theme	none	The color of the entity selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolorcompl property. Used if selcompl is on.
colorfac	none \| custom \| integer between 1 and the number of colors in the current theme	none	The color of the entity selection, either given as an integer indicating a color in the color theme, or as a custom color in the customcolorfac property. Used if selfac is on.
customcolorcompl	RGB-triplet	Next available theme color	The color to use. Active when colorcompl is set to custom.
customcolorfac	RGB-triplet	Next available theme color	The color to use. Active when colorfac is set to custom.
selareafraction	double	0.1	Maximum area of a small face (3D) or domain (2D) as a fraction of the total area of the input faces. Used when selfac or seldom, respectively, is on.
selcompl	on \| off	off	Specifies if to create a complement selection of resulting faces (3D) or domains (2D) when selfac or seldom, respectively, is on.
selcomplshow	on \| off	on	Show entity selection in physics, materials, and so on. For mesh parts, this option shows selection outside the part. Used if selcompl is on.
seldomshow	on \| off	on	Show domain selection in physics, materials, and so on. For mesh parts, this option shows selection outside the part. Used if seldom is on.
selfac	on \| off	off	Specifies if to create a selection of resulting small faces. Used in 3D.
selfacshow	on \| off	on	Show face selection in physics, materials, and so on. For mesh parts, this option shows selection outside the part. Used if selfac is on.