GSoC/GCI Archive
Google Code-in 2013 BRL-CAD

Implement a surface area function for super ellipsoids (SUPERELL)

completed by: Peter Amidon

mentors: Sean

BRL-CAD provides more than two dozen types of geometry ''primitives'' such as ellipsoids, boxes, and cones. Every primitive is described by a collection of callback functions, for example rt_ell_bbox() returns the bounding box dimensions for an ellipsoid. Wikipedia, Wolfram Mathworld, and various other math sites (and research papers) around the web include the equations for most of our basic primitives while others are a little more tricky to compute.

References:

  • http://en.wikipedia.org/wiki/Surface_area
  • http://mathworld.wolfram.com/
  • http://www.dtic.mil/cgi-bin/GetTRDoc?AD=AD0274936
  • include/raytrace.h: See ft_surf_area callback defined in the rt_functab structure

Code:

  • src/librt/primitives/superell/superell.c (implement your function here)
  • src/librt/primitives/table.c (add a reference to your callback function here)

This task involves writing a new callback function that takes an rt_db_internal object and calculates the surface area (units are mm^2). There are numerous examples in our code where we compute surface area for other primitives. Submit a patch file the may be applied cleanly.

If you succeed, a follow-on task may be created to enable and validate your function.