1D Meshing Hypotheses

Functions
def	ReversedEdgeIndices
	Transform a list of either edges or tuples (edge, 1st_vertex_of_edge) into a list acceptable to SetReversedEdges() of some 1D hypotheses. More...
def	LocalLength
	Defines "LocalLength" hypothesis to cut an edge in several segments with the same length. More...
def	MaxSize
	Defines "MaxSize" hypothesis to cut an edge into segments not longer than given value. More...
def	NumberOfSegments
	Defines "NumberOfSegments" hypothesis to cut an edge in a fixed number of segments. More...
def	Adaptive
	Defines "Adaptive" hypothesis to cut an edge into segments keeping segment size within the given range and considering (1) deflection of segments from the edge and (2) distance from segments to closest edges and faces to have segment length not longer than two times shortest distances to edges and faces. More...
def	Arithmetic1D
	Defines "Arithmetic1D" hypothesis to cut an edge in several segments with a length that changes in arithmetic progression. More...
def	GeometricProgression
	Defines "GeometricProgression" hypothesis to cut an edge in several segments with a length that changes in Geometric progression. More...
def	FixedPoints1D
	Defines "FixedPoints1D" hypothesis to cut an edge using parameter on curve from 0 to 1 (additionally it is neecessary to check orientation of edges and create list of reversed edges if it is needed) and sets numbers of segments between given points (default values are 1) More...
def	StartEndLength
	Defines "StartEndLength" hypothesis to cut an edge in several segments with increasing geometric length. More...
def	Deflection1D
	Defines "Deflection1D" hypothesis. More...
def	AutomaticLength
	Defines "AutomaticLength" hypothesis. More...
def	PythonSplit1D
	Defines "PythonSplit1D" hypothesis. More...

Detailed Description

Function Documentation

def ReversedEdgeIndices	(		self,
			reverseList
	)

Transform a list of either edges or tuples (edge, 1st_vertex_of_edge) into a list acceptable to SetReversedEdges() of some 1D hypotheses.

References smeshBuilder.FirstVertexOnCurve(), Mesh_Algorithm.mesh, Mesh.mesh, submeshProxy.mesh, meshEditor.mesh, and algoCreator.mesh.

def LocalLength	(		self,
			l,
			UseExisting = 0,
			p = 1e-07
	)

Defines "LocalLength" hypothesis to cut an edge in several segments with the same length.

Parameters

l	for the length of segments that cut an edge
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - creates a new one
p	precision, used for calculation of the number of segments. The precision should be a positive, meaningful value within the range [0,1]. In general, the number of segments is calculated with the formula: nb = ceil((edge_length / l) - p) Function ceil rounds its argument to the higher integer. So, p=0 means rounding of (edge_length / l) to the higher integer, p=0.5 means rounding of (edge_length / l) to the nearest integer, p=1 means rounding of (edge_length / l) to the lower integer. Default value is 1e-07.

Returns

an instance of StdMeshers_LocalLength hypothesis

References Mesh_Algorithm.Hypothesis(), and smeshBuilder.IsEqual().

def MaxSize	(		self,
			length = 0.0,
			UseExisting = 0
	)

Defines "MaxSize" hypothesis to cut an edge into segments not longer than given value.

Parameters

length	is optional maximal allowed length of segment, if it is omitted the preestimated length is used that depends on geometry size
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - creates a new one

Returns

an instance of StdMeshers_MaxLength hypothesis

References Mesh_Algorithm.Hypothesis().

def NumberOfSegments	(		self,
			n,
			s = [],
			reversedEdges = [],
			UseExisting = 0
	)

Defines "NumberOfSegments" hypothesis to cut an edge in a fixed number of segments.

Parameters

n	for the number of segments that cut an edge
s	for the scale factor (optional)
reversedEdges	is a list of edges to mesh using reversed orientation. A list item can also be a tuple (edge, 1st_vertex_of_edge)
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - create a new one

Returns

an instance of StdMeshers_NumberOfSegments hypothesis

References StdMeshersBuilder_Segment._compareNumberOfSegments(), Mesh_Algorithm.Hypothesis(), Mesh_Algorithm.MainShapeEntry(), and Mesh_Algorithm.ReversedEdgeIndices().

def Adaptive	(		self,
			minSize,
			maxSize,
			deflection,
			UseExisting = False
	)

Defines "Adaptive" hypothesis to cut an edge into segments keeping segment size within the given range and considering (1) deflection of segments from the edge and (2) distance from segments to closest edges and faces to have segment length not longer than two times shortest distances to edges and faces.

Parameters

minSize	defines the minimal allowed segment length
maxSize	defines the maximal allowed segment length
deflection	defines the maximal allowed distance from a segment to an edge
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - creates a new one

Returns

an instance of StdMeshers_Adaptive1D hypothesis

References Mesh_Algorithm.Hypothesis(), and smeshBuilder.IsEqual().

def Arithmetic1D	(		self,
			start,
			end,
			reversedEdges = [],
			UseExisting = 0
	)

Defines "Arithmetic1D" hypothesis to cut an edge in several segments with a length that changes in arithmetic progression.

Parameters

start	defines the length of the first segment
end	defines the length of the last segment
reversedEdges	is a list of edges to mesh using reversed orientation. A list item can also be a tuple (edge, 1st_vertex_of_edge)
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - creates a new one

Returns

an instance of StdMeshers_Arithmetic1D hypothesis

References Mesh_Algorithm.Hypothesis(), smeshBuilder.IsEqual(), Mesh_Algorithm.MainShapeEntry(), and Mesh_Algorithm.ReversedEdgeIndices().

def GeometricProgression	(		self,
			start,
			ratio,
			reversedEdges = [],
			UseExisting = 0
	)

Defines "GeometricProgression" hypothesis to cut an edge in several segments with a length that changes in Geometric progression.

Parameters

start	defines the length of the first segment
ratio	defines the common ratio of the geometric progression
reversedEdges	is a list of edges to mesh using reversed orientation. A list item can also be a tuple (edge, 1st_vertex_of_edge)
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - creates a new one

Returns

an instance of StdMeshers_Geometric1D hypothesis

References Mesh_Algorithm.Hypothesis(), smeshBuilder.IsEqual(), Mesh_Algorithm.MainShapeEntry(), and Mesh_Algorithm.ReversedEdgeIndices().

def FixedPoints1D	(		self,
			points,
			nbSegs = [1],
			reversedEdges = [],
			UseExisting = 0
	)

Defines "FixedPoints1D" hypothesis to cut an edge using parameter on curve from 0 to 1 (additionally it is neecessary to check orientation of edges and create list of reversed edges if it is needed) and sets numbers of segments between given points (default values are 1)

Parameters

points	defines the list of parameters on curve
nbSegs	defines the list of numbers of segments
reversedEdges	is a list of edges to mesh using reversed orientation. A list item can also be a tuple (edge, 1st_vertex_of_edge)
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - creates a new one

Returns

an instance of StdMeshers_FixedPoints1D hypothesis

References Mesh_Algorithm.Hypothesis(), Mesh_Algorithm.MainShapeEntry(), and Mesh_Algorithm.ReversedEdgeIndices().

def StartEndLength	(		self,
			start,
			end,
			reversedEdges = [],
			UseExisting = 0
	)

Defines "StartEndLength" hypothesis to cut an edge in several segments with increasing geometric length.

Parameters

start	defines the length of the first segment
end	defines the length of the last segment
reversedEdges	is a list of edges to mesh using reversed orientation. A list item can also be a tuple (edge, 1st_vertex_of_edge)
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - creates a new one

Returns

an instance of StdMeshers_StartEndLength hypothesis

References Mesh_Algorithm.Hypothesis(), smeshBuilder.IsEqual(), Mesh_Algorithm.MainShapeEntry(), and Mesh_Algorithm.ReversedEdgeIndices().

def Deflection1D	(		self,
			d,
			UseExisting = 0
	)

Defines "Deflection1D" hypothesis.

Parameters

d	for the deflection
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - create a new one

References Mesh_Algorithm.Hypothesis(), and smeshBuilder.IsEqual().

def AutomaticLength	(		self,
			fineness = 0,
			UseExisting = 0
	)

Defines "AutomaticLength" hypothesis.

Parameters

fineness	for the fineness [0-1]
UseExisting	if ==true - searches for an existing hypothesis created with the same parameters, else (default) - create a new one

References Mesh_Algorithm.Hypothesis(), and smeshBuilder.IsEqual().

def PythonSplit1D	(		self,
			n,
			func,
			UseExisting = 0
	)

Defines "PythonSplit1D" hypothesis.

Parameters

n	for the number of segments that cut an edge
func	for the python function that calculates the length of all segments
UseExisting	if ==true - searches for the existing hypothesis created with the same parameters, else (default) - creates a new one

References Mesh_Algorithm.Hypothesis().