Capsule

class compas.geometry.Capsule(line, radius, **kwargs)[source]

Bases: compas.geometry.shapes._shape.Shape

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

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

  • radius (float) – The radius of the capsule.

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.

  • radius (float) – The radius 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)

Attributes

DATASCHEMA

The schema of the data of this object.

JSONSCHEMANAME

area

data

Returns the data dictionary that represents the capsule.

end

length

line

radius

The radius of the capsule.

start

volume

Inherited Attributes

JSONSCHEMA

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

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.

jsondefinitions

Reusable schema definitions.

jsonstring

The representation of the object data in JSON format.

jsonvalidator

JSON schema validator for draft 7.

name

The name of the object.

Methods

from_data

Construct a capsule from its data representation.

to_vertices_and_faces

Returns a list of vertices and faces.

transform

Transform this Capsule using a given transformation.

Inherited Methods

copy

Make an independent copy of the data object.

from_json

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

from_jsonstring

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

to_data

Convert an object to its native data representation.

to_json

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

to_jsonstring

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

transformed

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