compas.geometry.Cylinder

class compas.geometry.Cylinder(circle, height)[source]

Bases: compas.geometry.shapes._shape.Shape

A cylinder is defined by a circle and a height.

Parameters
  • circle (compas.geometry.Circle) – The circle of the cylinder.

  • height (float) – The height of the cylinder.

Attributes
  • plane (compas.geometry.Plane) – The plane containing the circle.

  • circle (compas.geometry.Circle) – The base circle of the cylinder.

  • radius (float) – The radius of the base circle.

  • height (float) – The height of the cylinder.

  • normal (read-only) (compas.geometry.Vector) – The normal of the base plane.

  • diameter (float) – The diameter of the cylinder.

Examples

>>> from compas.geometry import Plane
>>> from compas.geometry import Cylinder
>>> plane = Plane([0, 0, 0], [0, 0, 1])
>>> circle = Circle(plane, 5)
>>> cylinder = Cylinder(circle, 7)

Methods

copy([cls])

Make an independent copy of the data object.

from_data(data)

Construct a cylinder 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.

to_vertices_and_faces([u])

Returns a list of vertices and faces.

transform(transformation)

Transform the cylinder.

transformed(transformation)

Returns a transformed copy of this primitive.

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).

Attributes

DATASCHEMA

The schema of the data of this object.

JSONSCHEMA

The schema of the JSON representation of the data of this object.

area

The surface area of the cylinder.

center

The center of the cylinder.

circle

The circle of the cylinder.

data

Returns the data dictionary that represents the cylinder.

diameter

The diameter of the cylinder.

dtype

The type of the object in the form of a “2-level” import and a class name.

guid

The globally unique identifier of the object.

height

The height of the cylinder.

name

The name of the object.

normal

The normal of the cylinder.

plane

The plane of the cylinder.

radius

The radius of the cylinder.

volume

The volume of the cylinder.