Ellipse

class compas.geometry.Ellipse(plane, major, minor, **kwargs)[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

copy([cls])

Make an independent copy of the data object.

from_data(data)

Construct a ellipse from its data representation.

from_json(filepath)

Construct an object from serialized data contained in a JSON file.

from_jsonstring(string)

Construct an object from serialized data contained in a JSON string.

to_data()

Convert an object to its native data representation.

to_json(filepath[, pretty])

Serialize the data representation of an object to a JSON file.

to_jsonstring([pretty])

Serialize the data representation of an object to a JSON string.

transform(T)

Transform the ellipse.

transformed(transformation)

Returns a transformed copy of this geometry.

validate_data()

Validate the object's data against its data schema (self.DATASCHEMA).

validate_json()

Validate the object's data against its json schema (self.JSONSCHEMA).