OCC.Geom2dAPI module¶

class
Geom2dAPI_ExtremaCurveCurve
(*args)¶ Bases:
object
 Computes the extrema between  the portion of the curve C1 limited by the two points of parameter (U1min,U1max), and  the portion of the curve C2 limited by the two points of parameter (U2min,U2max). Warning Use the function NbExtrema to obtain the number of solutions. If this algorithm fails, NbExtrema returns 0.
Parameters:  C1 (Handle_Geom2d_Curve &) –
 C2 (Handle_Geom2d_Curve &) –
 U1min (Quantity_Parameter) –
 U1max (Quantity_Parameter) –
 U2min (Quantity_Parameter) –
 U2max (Quantity_Parameter) –
Return type: 
Distance
()¶  Computes the distance between the end points of the extremum of index Index computed by this algorithm. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbExtrema ], where NbExtrema is the number of extrema computed by this algorithm.
Parameters: Index (int) – Return type: Quantity_Length

Extrema
()¶ Return type: Extrema_ExtCC2d

LowerDistance
()¶  Computes the distance between the end points of the shortest extremum computed by this algorithm. Exceptions  StdFail_NotDone if this algorithm fails.
Return type: Quantity_Length

LowerDistanceParameters
()¶  Returns the parameters U1 of the point on the first curve and U2 of the point on the second curve, which are the ends of the shortest extremum computed by this algorithm. Exceptions StdFail_NotDone if this algorithm fails.
Parameters:  U1 (Quantity_Parameter &) –
 U2 (Quantity_Parameter &) –
Return type:

NbExtrema
()¶  Returns the number of extrema computed by this algorithm. Note: if this algorithm fails, NbExtrema returns 0.
Return type: int

NearestPoints
()¶  Returns the points P1 on the first curve and P2 on the second curve, which are the ends of the shortest extremum computed by this algorithm. Exceptions StdFail_NotDone if this algorithm fails.
Parameters: Return type:

Parameters
()¶  Returns the parameters U1 of the point on the first curve and U2 of the point on the second curve, which are the ends of the extremum of index Index computed by this algorithm. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbExtrema ], where NbExtrema is the number of extrema computed by this algorithm.
Parameters:  Index (int) –
 U1 (Quantity_Parameter &) –
 U2 (Quantity_Parameter &) –
Return type:

Points
()¶  Returns the points P1 on the first curve and P2 on the second curve, which are the ends of the extremum of index Index computed by this algorithm. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbExtrema ], where NbExtrema is the number of extrema computed by this algorithm.
Parameters: Return type:

thisown
¶ The membership flag

class
Geom2dAPI_InterCurveCurve
(*args)¶ Bases:
object
 Create an empty intersector. Use the function Init for further initialization of the intersection algorithm by curves or curve.
Return type: None  Creates an object and computes the intersections between the curves C1 and C2.
Parameters:  C1 (Handle_Geom2d_Curve &) –
 C2 (Handle_Geom2d_Curve &) –
 Tol (float) – default value is 1.0e6
Return type:  Creates an object and computes selfintersections of the curve C1. Tolerance value Tol, defaulted to 1.0e6, defines the precision of computing the intersection points. In case of a tangential intersection, Tol also defines the size of intersection segments (limited portions of the curves) where the distance between all points from two curves (or a curve in case of selfintersection) is less than Tol. Warning Use functions NbPoints and NbSegments to obtain the number of solutions. If the algorithm finds no intersections NbPoints and NbSegments return 0.
Parameters:  C1 (Handle_Geom2d_Curve &) –
 Tol (float) – default value is 1.0e6
Return type: 
Init
()¶  Initializes an algorithm with the given arguments and computes the intersections between the curves C1. and C2.
Parameters:  C1 (Handle_Geom2d_Curve &) –
 C2 (Handle_Geom2d_Curve &) –
 Tol (float) – default value is 1.0e6
Return type:  Initializes an algorithm with the given arguments and computes the selfintersections of the curve C1. Tolerance value Tol, defaulted to 1.0e6, defines the precision of computing the intersection points. In case of a tangential intersection, Tol also defines the size of intersection segments (limited portions of the curves) where the distance between all points from two curves (or a curve in case of selfintersection) is less than Tol. Warning Use functions NbPoints and NbSegments to obtain the number of solutions. If the algorithm finds no intersections NbPoints and NbSegments return 0.
Parameters:  C1 (Handle_Geom2d_Curve &) –
 Tol (float) – default value is 1.0e6
Return type:

Intersector
()¶  return the algorithmic object from Intersection.
Return type: Geom2dInt_GInter

NbPoints
()¶  Returns the number of intersectionpoints in case of cross intersections. NbPoints returns 0 if no intersections were found.
Return type: int

NbSegments
()¶  Returns the number of tangential intersections. NbSegments returns 0 if no intersections were found
Return type: int

Point
()¶  Returns the intersection point of index Index. Intersection points are computed in case of cross intersections with a precision equal to the tolerance value assigned at the time of construction or in the function Init (this value is defaulted to 1.0e6). Exceptions Standard_OutOfRange if index is not in the range [ 1,NbPoints ], where NbPoints is the number of computed intersection points
Parameters: Index (int) – Return type: gp_Pnt2d

Segment
()¶  Use this syntax only to get solutions of tangential intersection between two curves. Output values Curve1 and Curve2 are the intersection segments on the first curve and on the second curve accordingly. Parameter Index defines a number of computed solution. An intersection segment is a portion of an initial curve limited by two points. The distance from each point of this segment to the other curve is less or equal to the tolerance value assigned at the time of construction or in function Init (this value is defaulted to 1.0e6). Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbSegments ], where NbSegments is the number of computed tangential intersections. Standard_NullObject if the algorithm is initialized for the computing of selfintersections on a curve.
Parameters:  Index (int) –
 Curve1 (Handle_Geom2d_Curve &) –
 Curve2 (Handle_Geom2d_Curve &) –
Return type:  Use this syntax to get solutions of tangential intersections only in case of a selfintersected curve. Output value Curve1 is the intersection segment of the curve defined by number Index. An intersection segment is a portion of the initial curve limited by two points. The distance between each point of this segment to another portion of the curve is less or equal to the tolerance value assigned at the time of construction or in the function Init (this value is defaulted to 1.0e6). Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbSegments ], where NbSegments is the number of computed tangential intersections.
Parameters:  Index (int) –
 Curve1 (Handle_Geom2d_Curve &) –
Return type:

thisown
¶ The membership flag

class
Geom2dAPI_Interpolate
(*args)¶ Bases:
object
 Tolerance is to check if the points are not too close to one an other It is also used to check if the tangent vector is not too small. There should be at least 2 points if PeriodicFlag is True then the curve will be periodic.
Parameters:  Points (Handle_TColgp_HArray1OfPnt2d) –
 PeriodicFlag (bool) –
 Tolerance (float) –
Return type:  if PeriodicFlag is True then the curve will be periodic Warning: There should be as many parameters as there are points except if PeriodicFlag is True : then there should be one more parameter to close the curve
Parameters:  Points (Handle_TColgp_HArray1OfPnt2d) –
 Parameters (Handle_TColStd_HArray1OfReal &) –
 PeriodicFlag (bool) –
 Tolerance (float) –
Return type: 
Curve
()¶  Returns the computed BSpline curve. Raises StdFail_NotDone if the interpolation fails.
Return type: Handle_Geom2d_BSplineCurve

IsDone
()¶  Returns true if the constrained BSpline curve is successfully constructed. Note: in this case, the result is given by the function Curve.
Return type: bool

Load
()¶  Assigns this constrained BSpline curve to be tangential to vectors InitialTangent and FinalTangent at its first and last points respectively (i.e. the first and last points of the table of points through which the curve passes, as defined at the time of initialization).
Parameters: Return type:  Assigns this constrained BSpline curve to be tangential to vectors defined in the table Tangents, which is parallel to the table of points through which the curve passes, as defined at the time of initialization. Vectors in the table Tangents are defined only if the flag given in the parallel table TangentFlags is true: only these vectors are set as tangency constraints.
Parameters:  Tangents (TColgp_Array1OfVec2d) –
 TangentFlags (Handle_TColStd_HArray1OfBoolean &) –
Return type:

Perform
()¶  Computes the constrained BSpline curve. Use the function IsDone to verify that the computation is successful, and then the function Curve to obtain the result.
Return type: None

thisown
¶ The membership flag

class
Geom2dAPI_PointsToBSpline
(*args)¶ Bases:
object
 Constructs an empty approximation algorithm. Use an Init function to define and build the BSpline curve.
Return type: None  Approximate a BSpline Curve passing through an array of Point. The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters:  Points (TColgp_Array1OfPnt2d) –
 DegMin (int) – default value is 3
 DegMax (int) – default value is 8
 Continuity (GeomAbs_Shape) – default value is GeomAbs_C2
 Tol2D (float) – default value is 1.0e6
Return type:  Approximate a BSpline Curve passing through an array of Point. Of coordinates : //! X = X0 + DX * (iYValues.Lower()) Y = YValues(i) //! With i in the range YValues.Lower(), YValues.Upper() //! The BSpline will be parametrized from t = X0 to X0 + DX * (YValues.Upper()  YValues.Lower()) //! And will satisfy X(t) = t //! The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters: Return type:  Approximate a BSpline Curve passing through an array of Point. The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters:  Points (TColgp_Array1OfPnt2d) –
 ParType (Approx_ParametrizationType) –
 DegMin (int) – default value is 3
 DegMax (int) – default value is 8
 Continuity (GeomAbs_Shape) – default value is GeomAbs_C2
 Tol2D (float) – default value is 1.0e3
Return type:  Approximate a BSpline Curve passing through an array of Point, which parameters are given by the array <Parameters>. The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters:  Points (TColgp_Array1OfPnt2d) –
 Parameters (TColStd_Array1OfReal &) –
 DegMin (int) – default value is 3
 DegMax (int) – default value is 8
 Continuity (GeomAbs_Shape) – default value is GeomAbs_C2
 Tol2D (float) – default value is 1.0e3
Return type:  Approximate a BSpline Curve passing through an array of Point using variational smoothing algorithm, which tries to minimize additional criterium: Weight1*CurveLength + Weight2*Curvature + Weight3*Torsion
Parameters: Return type: 
Curve
()¶  Returns the approximate BSpline Curve
Return type: Handle_Geom2d_BSplineCurve

Init
()¶  Approximate a BSpline Curve passing through an array of Point. The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters:  Points (TColgp_Array1OfPnt2d) –
 DegMin (int) – default value is 3
 DegMax (int) – default value is 8
 Continuity (GeomAbs_Shape) – default value is GeomAbs_C2
 Tol2D (float) – default value is 1.0e6
Return type:  Approximate a BSpline Curve passing through an array of Point. Of coordinates : //! X = X0 + DX * (iYValues.Lower()) Y = YValues(i) //! With i in the range YValues.Lower(), YValues.Upper() //! The BSpline will be parametrized from t = X0 to X0 + DX * (YValues.Upper()  YValues.Lower()) //! And will satisfy X(t) = t //! The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters: Return type:  Approximate a BSpline Curve passing through an array of Point. The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters:  Points (TColgp_Array1OfPnt2d) –
 ParType (Approx_ParametrizationType) –
 DegMin (int) – default value is 3
 DegMax (int) – default value is 8
 Continuity (GeomAbs_Shape) – default value is GeomAbs_C2
 Tol2D (float) – default value is 1.0e3
Return type:  Approximate a BSpline Curve passing through an array of Point, which parameters are given by the array <Parameters>. The resulting BSpline will have the following properties: 1 his degree will be in the range [Degmin,Degmax] 2 his continuity will be at least <Continuity> 3 the distance from the point <Points> to the BSpline will be lower to Tol2D
Parameters:  Points (TColgp_Array1OfPnt2d) –
 Parameters (TColStd_Array1OfReal &) –
 DegMin (int) – default value is 3
 DegMax (int) – default value is 8
 Continuity (GeomAbs_Shape) – default value is GeomAbs_C2
 Tol2D (float) – default value is 1.0e3
Return type:  Approximate a BSpline Curve passing through an array of Point using variational smoothing algorithm, which tries to minimize additional criterium: Weight1*CurveLength + Weight2*Curvature + Weight3*Torsion
Parameters: Return type:

thisown
¶ The membership flag

class
Geom2dAPI_ProjectPointOnCurve
(*args)¶ Bases:
object
 Constructs an empty projector algorithm. Use an Init function to define the point and the curve on which it is going to work.
Return type: None  Create the projection of a point <P> on a curve <Curve>
Parameters:  P (gp_Pnt2d) –
 Curve (Handle_Geom2d_Curve &) –
Return type:  Create the projection of a point <P> on a curve <Curve> limited by the two points of parameter Umin and Usup. Warning Use the function NbPoints to obtain the number of solutions. If projection fails, NbPoints returns 0.
Parameters:  P (gp_Pnt2d) –
 Curve (Handle_Geom2d_Curve &) –
 Umin (Quantity_Parameter) –
 Usup (Quantity_Parameter) –
Return type: 
Distance
()¶  Computes the distance between the point and its computed orthogonal projection on the curve. Index is a number of computed projected point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.
Parameters: Index (int) – Return type: Quantity_Length

Extrema
()¶  return the algorithmic object from Extrema
Return type: Extrema_ExtPC2d

Init
()¶  Initializes this algorithm with the given arguments, and computes the orthogonal projections of a point <P> on a curve <Curve>
Parameters:  P (gp_Pnt2d) –
 Curve (Handle_Geom2d_Curve &) –
Return type:  Initializes this algorithm with the given arguments, and computes the orthogonal projections of the point P onto the portion of the curve Curve limited by the two points of parameter Umin and Usup.
Parameters:  P (gp_Pnt2d) –
 Curve (Handle_Geom2d_Curve &) –
 Umin (Quantity_Parameter) –
 Usup (Quantity_Parameter) –
Return type:

LowerDistance
()¶  Computes the distance between the point and its nearest orthogonal projection on the curve. Exceptions StdFail_NotDone if this algorithm fails.
Return type: Quantity_Length

LowerDistanceParameter
()¶  Returns the parameter on the curve of the nearest orthogonal projection of the point. Exceptions StdFail_NotDone if this algorithm fails.
Return type: Quantity_Parameter

NearestPoint
()¶  Returns the nearest orthogonal projection of the point on the curve. Exceptions StdFail_NotDone if this algorithm fails.
Return type: gp_Pnt2d

Parameter
()¶  Returns the parameter on the curve of a point which is the orthogonal projection. Index is a number of a computed projected point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.
Parameters: Index (int) – Return type: Quantity_Parameter  Returns the parameter on the curve of a point which is the orthogonal projection. Index is a number of a computed projected point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points
Parameters:  Index (int) –
 U (Quantity_Parameter &) –
Return type:

Point
()¶  Returns the orthogonal projection on the curve. Index is a number of a computed point. Exceptions Standard_OutOfRange if Index is not in the range [ 1,NbPoints ], where NbPoints is the number of solution points.
Parameters: Index (int) – Return type: gp_Pnt2d

thisown
¶ The membership flag

class
SwigPyIterator
(*args, **kwargs)¶ Bases:
object

advance
()¶

copy
()¶

decr
()¶

distance
()¶

equal
()¶

incr
()¶

next
()¶

previous
()¶

thisown
¶ The membership flag

value
()¶


register_handle
(handle, base_object)¶ Inserts the handle into the base object to prevent memory corruption in certain cases