# Capsule

A capsule is defined by a line segment and a radius.

Parameters
Attributes
• line (compas.geometry.Line) – The axis line of the capsule.

• start (compas.geometry.Point) – The start point of the axis line. This is the base point of the capsule.

• end (compas.geometry.Point) – The end point of the axis line. This is the top of the capsule.

• length (read-only) (float) – The length of the capsule axis line.

• area (read-only) (float) – The surface area of the capsule.

• volume (read-only) (float) – The volume of the capsule.

Examples

>>> line = Line((1, 2, 3), (5, 3, 1))
>>> capsule = Capsule(line, 2.3)


Methods

 copy([cls]) Make an independent copy of the data object. from_data(data) Construct a capsule 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. 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, v, triangulated]) Returns a list of vertices and faces. transform(transformation) Transform this Capsule using a given transformation. transformed(transformation) Returns a transformed copy of this geometry. Validate the object's data against its data schema (self.DATASCHEMA). Validate the object's data against its json schema (self.JSONSCHEMA).