Skip to content
brep-conformancegithub

curvature

Queries · api.md § curvature · all operations

curvature(s: Solid, points: list<Point3>) -> list<Number[2] or null>

Gives the principal curvatures [k1, k2] of the boundary, with k1 ≥ k2, in 1/mm. For each given point, the curvatures are taken at the point of the boundary nearest to it, so the given point need not lie on the boundary. A curvature is positive where the boundary bends away from its outward normal, as on a ball, and negative where the boundary bends toward its outward normal, as round a hole. Where the nearest point lies on a crease, the answer is null.

A plane has [0, 0]. A cylinder of radius r has [1/r, 0], a ball has [1/R, 1/R], and a hole has [0, −1/r]. A cone has [cos α/ρ, 0] at radius ρ, where its side leans α from its axis. A ring of radii R and r has 1/r and cos φ/(R + r cos φ) at angle φ round its tube.

Example. Solid 1 is a cylinder of radius 5 on the z axis.

> {"cmd": "curvature", "s": 1, "points": [[5, 0, 10]]}
< {"ok": [[0.2, 0.0]]}
FunctionFieldsReturns
volumesVolume
areasArea
classifys, pointslist<"in" or "on" or "out">
closests, pointslist<Point3>
normals, pointslist<Vector3 or null>
curvatures, pointslist<Number[2] or null>
checkslist<string>
centroidsPoint3 or null
inertiasNumber[3][3]
distancea, bLength
interferencea, b{volume: Volume, gap: Length}
bettisCount[3]
section_areas, origin, normalArea
sections, origin, normal, tolerancelist<list<Point3>>
projects, direction, tolerance{visible: list<list<Point2>>, hidden: list<list<Point2>>}
bounding_boxsPoint3[2]
splits, origin, normalSolid[2]
meshs, tolerance{positions: list<Point3>, triangles: list<Index[3]>}
displays, tolerance{faces: list<Face>, edges: list<list<Point3>>}
raycasts, origin, direction; or s, rayslist<Length>; or list<list<Length>>