Creating Basic Geometric Objects

Modules
	Creating Curves
Functions
def	geompy.MakeVertex
	Create point by three coordinates.
def	geompy.MakeVertexWithRef
	Create a point, distant from the referenced point on the given distances along the coordinate axes.
def	geompy.MakeVertexOnCurve
	Create a point, corresponding to the given parameter on the given curve.
def	geompy.MakeVertexOnCurveByCoord
	Create a point by projection give coordinates on the given curve.
def	geompy.MakeVertexOnCurveByLength
	Create a point, corresponding to the given length on the given curve.
def	geompy.MakeVertexOnSurface
	Create a point, corresponding to the given parameters on the given surface.
def	geompy.MakeVertexOnSurfaceByCoord
	Create a point by projection give coordinates on the given surface.
def	geompy.MakeVertexOnLinesIntersection
	Create a point on intersection of two lines.
def	geompy.MakeTangentOnCurve
	Create a tangent, corresponding to the given parameter on the given curve.
def	geompy.MakeTangentPlaneOnFace
	Create a tangent plane, corresponding to the given parameter on the given face.
def	geompy.MakeVectorDXDYDZ
	Create a vector with the given components.
def	geompy.MakeVector
	Create a vector between two points.
def	geompy.MakeLine
	Create a line, passing through the given point and parrallel to the given direction.
def	geompy.MakeLineTwoPnt
	Create a line, passing through the given points.
def	geompy.MakeLineTwoFaces
	Create a line on two faces intersection.
def	geompy.MakePlane
	Create a plane, passing through the given point and normal to the given vector.
def	geompy.MakePlaneThreePnt
	Create a plane, passing through the three given points.
def	geompy.MakePlaneFace
	Create a plane, similar to the existing one, but with another size of representing face.
def	geompy.MakePlane2Vec
	Create a plane, passing through the 2 vectors with center in a start point of the first vector.
def	geompy.MakePlaneLCS
	Create a plane, based on a Local coordinate system.
def	geompy.MakeMarker
	Create a local coordinate system.
def	geompy.MakeMarkerFromShape
	Create a local coordinate system from shape.
def	geompy.MakeMarkerPntTwoVec
	Create a local coordinate system from point and two vectors.

---

Function Documentation

def geompy.MakeVertex	(		self,
			theX,
			theY,
			theZ
	)

Create point by three coordinates.

Parameters:

theX	The X coordinate of the point.
theY	The Y coordinate of the point.
theZ	The Z coordinate of the point.

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeVertexWithRef	(		self,
			theReference,
			theX,
			theY,
			theZ
	)

Create a point, distant from the referenced point on the given distances along the coordinate axes.

Parameters:

theReference	The referenced point.
theX	Displacement from the referenced point along OX axis.
theY	Displacement from the referenced point along OY axis.
theZ	Displacement from the referenced point along OZ axis.

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeVertexOnCurve	(		self,
			theRefCurve,
			theParameter
	)

Create a point, corresponding to the given parameter on the given curve.

Parameters:

theRefCurve	The referenced curve.
theParameter	Value of parameter on the referenced curve.

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeVertexOnCurveByCoord	(		self,
			theRefCurve,
			theX,
			theY,
			theZ
	)

Create a point by projection give coordinates on the given curve.

Parameters:

theRefCurve	The referenced curve.
theX	X-coordinate in 3D space
theY	Y-coordinate in 3D space
theZ	Z-coordinate in 3D space

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeVertexOnCurveByLength	(		self,
			theRefCurve,
			theLength,
			theStartPoint = None
	)

Create a point, corresponding to the given length on the given curve.

Parameters:

theRefCurve	The referenced curve.
theLength	Length on the referenced curve. It can be negative.
theStartPoint	Point allowing to choose the direction for the calculation of the length. If None, start from the first point of theRefCurve.

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeVertexOnSurface	(		self,
			theRefSurf,
			theUParameter,
			theVParameter
	)

Create a point, corresponding to the given parameters on the given surface.

Parameters:

theRefSurf	The referenced surface.
theUParameter	Value of U-parameter on the referenced surface.
theVParameter	Value of V-parameter on the referenced surface.

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeVertexOnSurfaceByCoord	(		self,
			theRefSurf,
			theX,
			theY,
			theZ
	)

Create a point by projection give coordinates on the given surface.

Parameters:

theRefSurf	The referenced surface.
theX	X-coordinate in 3D space
theY	Y-coordinate in 3D space
theZ	Z-coordinate in 3D space

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeVertexOnLinesIntersection	(		self,
			theRefLine1,
			theRefLine2
	)

Create a point on intersection of two lines.

Parameters:

theRefLine1,theRefLine2

The referenced lines.

Returns:

New GEOM_Object, containing the created point.

Example

def geompy.MakeTangentOnCurve	(		self,
			theRefCurve,
			theParameter
	)

Create a tangent, corresponding to the given parameter on the given curve.

Parameters:

theRefCurve	The referenced curve.
theParameter	Value of parameter on the referenced curve.

Returns:

New GEOM_Object, containing the created tangent.

Example

def geompy.MakeTangentPlaneOnFace	(		self,
			theFace,
			theParameterU,
			theParameterV,
			theTrimSize
	)

Create a tangent plane, corresponding to the given parameter on the given face.

Parameters:

theFace	The face for which tangent plane should be built.
theParameterV	vertical value of the center point (0.0 - 1.0).
theParameterU	horisontal value of the center point (0.0 - 1.0).
theTrimSize	the size of plane.

Returns:

New GEOM_Object, containing the created tangent.

Example

def geompy.MakeVectorDXDYDZ	(		self,
			theDX,
			theDY,
			theDZ
	)

Create a vector with the given components.

Parameters:

theDX	X component of the vector.
theDY	Y component of the vector.
theDZ	Z component of the vector.

Returns:

New GEOM_Object, containing the created vector.

Example

def geompy.MakeVector	(		self,
			thePnt1,
			thePnt2
	)

Create a vector between two points.

Parameters:

thePnt1	Start point for the vector.
thePnt2	End point for the vector.

Returns:

New GEOM_Object, containing the created vector.

Example

def geompy.MakeLine	(		self,
			thePnt,
			theDir
	)

Create a line, passing through the given point and parrallel to the given direction.

Parameters:

thePnt	Point. The resulting line will pass through it.
theDir	Direction. The resulting line will be parallel to it.

Returns:

New GEOM_Object, containing the created line.

Example

def geompy.MakeLineTwoPnt	(		self,
			thePnt1,
			thePnt2
	)

Create a line, passing through the given points.

Parameters:

thePnt1	First of two points, defining the line.
thePnt2	Second of two points, defining the line.

Returns:

New GEOM_Object, containing the created line.

Example

def geompy.MakeLineTwoFaces	(		self,
			theFace1,
			theFace2
	)

Create a line on two faces intersection.

Parameters:

theFace1	First of two faces, defining the line.
theFace2	Second of two faces, defining the line.

Returns:

New GEOM_Object, containing the created line.

Example

def geompy.MakePlane	(		self,
			thePnt,
			theVec,
			theTrimSize
	)

Create a plane, passing through the given point and normal to the given vector.

Parameters:

thePnt	Point, the plane has to pass through.
theVec	Vector, defining the plane normal direction.
theTrimSize	Half size of a side of quadrangle face, representing the plane.

Returns:

New GEOM_Object, containing the created plane.

Example

def geompy.MakePlaneThreePnt	(		self,
			thePnt1,
			thePnt2,
			thePnt3,
			theTrimSize
	)

Create a plane, passing through the three given points.

Parameters:

thePnt1	First of three points, defining the plane.
thePnt2	Second of three points, defining the plane.
thePnt3	Fird of three points, defining the plane.
theTrimSize	Half size of a side of quadrangle face, representing the plane.

Returns:

New GEOM_Object, containing the created plane.

Example

def geompy.MakePlaneFace	(		self,
			theFace,
			theTrimSize
	)

Create a plane, similar to the existing one, but with another size of representing face.

Parameters:

theFace	Referenced plane or LCS(Marker).
theTrimSize	New half size of a side of quadrangle face, representing the plane.

Returns:

New GEOM_Object, containing the created plane.

Example

def geompy.MakePlane2Vec	(		self,
			theVec1,
			theVec2,
			theTrimSize
	)

Create a plane, passing through the 2 vectors with center in a start point of the first vector.

Parameters:

theVec1	Vector, defining center point and plane direction.
theVec2	Vector, defining the plane normal direction.
theTrimSize	Half size of a side of quadrangle face, representing the plane.

Returns:

New GEOM_Object, containing the created plane.

Example

def geompy.MakePlaneLCS	(		self,
			theLCS,
			theTrimSize,
			theOrientation
	)

Create a plane, based on a Local coordinate system.

Parameters:

theLCS	coordinate system, defining plane.
theTrimSize	Half size of a side of quadrangle face, representing the plane.
theOrientation	OXY, OYZ or OZX orientation - (1, 2 or 3)

Returns:

New GEOM_Object, containing the created plane.

Example

def geompy.MakeMarker	(		self,
			OX,
			OY,
			OZ,
			XDX,
			XDY,
			XDZ,
			YDX,
			YDY,
			YDZ
	)

Create a local coordinate system.

Parameters:

OX,OY,OZ	Three coordinates of coordinate system origin.
XDX,XDY,XDZ	Three components of OX direction
YDX,YDY,YDZ	Three components of OY direction

Returns:

New GEOM_Object, containing the created coordinate system.

Example

def geompy.MakeMarkerFromShape	(		self,
			theShape
	)

Create a local coordinate system from shape.

Parameters:

theShape

The initial shape to detect the coordinate system.

Returns:

New GEOM_Object, containing the created coordinate system.

Example

def geompy.MakeMarkerPntTwoVec	(		self,
			theOrigin,
			theXVec,
			theYVec
	)

Create a local coordinate system from point and two vectors.

Parameters:

theOrigin	Point of coordinate system origin.
theXVec	Vector of X direction
theYVec	Vector of Y direction

Returns:

New GEOM_Object, containing the created coordinate system.

Example