Ellipse

class compas.geometry.Ellipse(plane, major, minor)[source]

Bases: compas.geometry.primitives._primitive.Primitive

A ellipse is defined by a plane and a major.

Parameters

  • plane (compas.geometry.Plane or tuple of point and normal) – The plane of the ellipse.

  • major (float) – The major of the ellipse.

Attributes

  • plane (compas.geometry.Plane) – The plane of the ellipse.

  • major (float) – The major.

  • minor (float) – The minor.

  • center (compas.geometry.Point) – The base point of the plane and center of the ellipse.

  • normal (compas.geometry.Vector) – The normal vector of the plane.

  • circumference (float, read-only) – The circumference of the ellipse.

  • area (float, read-only) – The area of the ellipse.

Examples

>>> from compas.geometry import Plane
>>> from compas.geometry import Ellipse
>>> plane = Plane([0, 0, 0], [0, 0, 1])
>>> ellipse = Ellipse(plane, 2, 1)

Methods

__init__(plane, major, minor)

Initialize self.

copy()

Makes a copy of this primitive.

from_data(data)

Construct a ellipse from its data representation.

from_json(filepath)

Construct a primitive from structured data contained in a json file.

to_data()

Returns the data dictionary that represents the primitive.

to_json(filepath)

Serialise the structured data representing the primitive to json.

transform(T)

Transform the ellipse.

transformed(transformation)

Returns a transformed copy of this primitive.

validate_data()

Validate the data of this object against its data schema (self.DATASCHEMA).

validate_json()

Validate the data loaded from a JSON representation of the data of this object against its data schema (self.DATASCHEMA).