Describes an ellipse in 3D space To create an ellipse there are several ways: Part.Ellipse() Creates an ellipse with major radius 2 and minor radius 1 with the center in (0,0,0)
Part.Ellipse(Ellipse)
Create a copy of the given ellipse
Part.Ellipse(S1,S2,Center)
Creates an ellipse centered on the point Center, where
the plane of the ellipse is defined by Center, S1 and S2,
its major axis is defined by Center and S1,
its major radius is the distance between Center and S1, and
its minor radius is the distance between S2 and the major axis.
Part.Ellipse(Center,MajorRadius,MinorRadius)
Creates an ellipse with major and minor radii MajorRadius and
MinorRadius, and located in the plane defined by Center and
the normal (0,0,1)
The angle between the X axis and the major axis of the conic.
The axis direction of the circle
Deprecated -- use Location.
Content of the object in XML representation.
Returns the global continuity of the curve.
returns the eccentricity value of the conic e. e = 0 for a circle 0 < e < 1 for an ellipse (e = 0 if MajorRadius = MinorRadius) e > 1 for a hyperbola e = 1 for a parabola
Returns the value of the first parameter.
The focal distance of the ellipse.
The first focus is on the positive side of the major axis of the ellipse; the second focus is on the negative side.
Returns the value of the last parameter.
Location of the conic.
The major radius of the ellipse.
Memory size of the object in bytes.
The minor radius of the ellipse.
Module in which this class is defined
Returns a rotation object to describe the orientation for curve that supports it
Gives the tag of the geometry as string.
Is the type of the FreeCAD object with module domain
The X axis direction of the circle
The Y axis direction of the circle
Approximates a curve of any type to a B-Spline curve approximateBSpline(Tolerance, MaxSegments, MaxDegree, [Order='C2']) -> B-Spline curve
Vector = centerOfCurvature(float pos) - Get the center of curvature at the given parameter [First|Last] if defined
Create a clone of this geometry with the same Tag
Computes the continuity of two curves
Create a copy of this geometry
Float = curvature(pos) - Get the curvature at the given parameter [First|Last] if defined
Deletes all extensions of the indicated name.
Deletes all extensions of the indicated type.
Discretizes the curve and returns a list of points. The function accepts keywords as argument: discretize(Number=n) => gives a list of 'n' equidistant points discretize(QuasiNumber=n) => gives a list of 'n' quasi equidistant points (is faster than the method above) discretize(Distance=d) => gives a list of equidistant points with distance 'd' discretize(Deflection=d) => gives a list of points with a maximum deflection 'd' to the curve discretize(QuasiDeflection=d) => gives a list of points with a maximum deflection 'd' to the curve (faster) discretize(Angular=a,Curvature=c,[Minimum=m]) => gives a list of points with an angular deflection of 'a' and a curvature deflection of 'c'. Optionally a minimum number of points can be set which by default is set to 2.
Optionally you can set the keywords 'First' and 'Last' to define a sub-range of the parameter range of the curve.
If no keyword is given then it depends on whether the argument is an int or float. If it's an int then the behaviour is as if using the keyword 'Number', if it's float then the behaviour is as if using the keyword 'Distance'.
Example:
import Part c=Part.Circle() c.Radius=5 p=c.discretize(Number=50,First=3.14) s=Part.Compound([Part.Vertex(i) for i in p]) Part.show(s)
p=c.discretize(Angular=0.09,Curvature=0.01,Last=3.14,Minimum=100) s=Part.Compound([Part.Vertex(i) for i in p]) Part.show(s)
dumpContent(Compression=3) -> bytearray
Dumps the content of the object, both the XML representation and the additional data files required, into a byte representation.
Compression : int Set the data compression level in the range [0,9]. Set to 0 for no compression.
Returns all descendants
Returns the point of given parameter
Returns the point and first derivative of given parameter
Returns the point, first and second derivatives
Returns the point, first, second and third derivatives
Returns the n-th derivative
Gets the first geometry extension of the name indicated by the string.
Gets the first geometry extension of the type indicated by the string.
Returns a list with information about the geometry extensions.
Returns a boolean indicating whether a geometry extension with the name indicated as a string exists.
Returns a boolean indicating whether a geometry extension of the type indicated as a string exists.
Returns all intersection points and curve segments between the curve and the curve/surface.
arguments: curve/surface (for the intersection), precision (float)
Get intersection points with another curve lying on a plane.
Returns all intersection points between this curve and the given curve.
Returns all intersection points and curve segments between the curve and the surface.
Returns true if the curve is closed.
Returns true if given type is a father
Returns true if this curve is periodic.
Computes the length of a curve length([uMin,uMax,Tol]) -> Float
Make a ruled surface of this and the given curves
Performs the symmetrical transformation of this geometric object
Vector = normal(pos) - Get the normal vector at the given parameter [First|Last] if defined
Returns the parameter on the curve of the nearest orthogonal projection of the point.
Returns the parameter on the curve of a point at the given distance from a starting parameter. parameterAtDistance([abscissa, startingParameter]) -> Float the
Returns the period of this curve or raises an exception if it is not periodic.
Computes the projection of a point on the curve
projectPoint(Point=Vector,[Method="NearestPoint"]) projectPoint(Vector,"NearestPoint") -> Vector projectPoint(Vector,"LowerDistance") -> float projectPoint(Vector,"LowerDistanceParameter") -> float projectPoint(Vector,"Distance") -> list of floats projectPoint(Vector,"Parameter") -> list of floats projectPoint(Vector,"Point") -> list of points
restoreContent(obj) -> None
Restore the content of the object from a byte representation as stored by dumpContent.
It could be restored from any Python object implementing the buffer protocol.
obj : buffer Object with buffer protocol support.
Changes the direction of parametrization of the curve.
Returns the parameter on the reversed curve for the point of parameter U on this curve.
Rotates this geometric object at angle Ang (in radians) about axis
Applies a scaling transformation on this geometric object with a center and scaling factor
Sets a geometry extension of the indicated type.
Computes the tangent of parameter u on this curve
Converts a curve of any type (only part from First to Last) toBSpline([Float=First, Float=Last]) -> B-Spline curve
Converts a curve of any type (only part from First to Last) toNurbs([Float=First, Float=Last]) -> NURBS curve
Return the shape for the geometry.
Applies a transformation to this geometric object
Translates this geometric object
Returns a trimmed curve defined in the given parameter range trim([Float=First, Float=Last]) -> trimmed curve
Computes the point of parameter u on this curve
documentation index > API > Ellipse API