SphericalSurface

class compas.geometry.SphericalSurface[source]

Bases: Surface

A spherical surface is defined by a radius and a frame.

Parameters:
radiusfloat

The radius of the sphere.

frameFrame

The frame of the sphere.

namestr, optional

The name of the surface.

Examples

>>> from compas.geometry import Frame
>>> from compas.geometry import SphericalSurface
>>> frame = Frame([0, 0, 0], [1, 0, 0], [0, 1, 0])
>>> sphere = SphericalSurface(1.0, frame)

Methods

from_plane_and_radius

Construct a sphere from a plane and a radius.

from_points

Construct the sphere that best fits a set of points in the least squares sense.

from_three_points

Construct a sphere from three points.

isocurve_u

Compute the isoparametric curve at parameter u.

isocurve_v

Compute the isoparametric curve at parameter v.

normal_at

Construct a normal vector at a point on the sphere.

point_at

Construct a point on the sphere.

Inherited Methods

ToString

Converts the instance to a string.

aabb

Compute the axis aligned bounding box of the surface.

boundary

Compute the boundary curves of the surface.

closest_point

Compute the closest point on the curve to a given point.

compute_aabb

Compute the axis-aligned bounding box of the geometry.

compute_obb

Compute the oriented bounding box of the geometry.

copy

Make an independent copy of the data object.

curvature_at

Compute the curvature at a point on the surface.

frame_at

Compute the local frame at a point on the curve.

from_json

Construct an object of this type from a JSON file.

from_jsonstring

Construct an object of this type from a JSON string.

from_native

Construct a parametric surface from a native surface geometry.

from_obj

Load a surface from an OBJ file.

from_step

Load a surface from a STP file.

intersections_with_curve

Compute the intersections with a curve.

intersections_with_line

Compute the intersections with a line.

intersections_with_plane

Compute the intersections with a plane.

obb

Compute the oriented bounding box of the surface.

pointgrid

Compute point locations corresponding to evenly spaced parameters over the surface domain.

rotate

Rotate the geometry.

rotated

Returns a rotated copy of this geometry.

scale

Scale the geometry.

scaled

Returns a scaled copy of this geometry.

sha256

Compute a hash of the data for comparison during version control using the sha256 algorithm.

space_u

Compute evenly spaced parameters over the surface domain in the U direction.

space_v

Compute evenly spaced parameters over the surface domain in the V direction.

to_brep

Convert the surface to a BREP representation.

to_json

Convert an object to its native data representation and save it to a JSON file.

to_jsonstring

Convert an object to its native data representation and save it to a JSON string.

to_mesh

Convert the surface to a mesh.

to_polyhedron

Convert the surface to a polyhedron.

to_quads

Convert the surface to a list of quads.

to_step

Write the surface geometry to a STP file.

to_triangles

Convert the surface to a list of triangles.

to_vertices_and_faces

Convert the surface to a list of vertices and faces.

transform

Transform the local coordinate system of the surface.

transformed

Returns a transformed copy of this geometry.

translate

Translate the geometry.

translated

Returns a translated copy of this geometry.

validate_data

Validate the data against the object's data schema.