diff --git a/skimage/measure/_marching_cubes.py b/skimage/measure/_marching_cubes.py index 1a381c3c..fa91de07 100644 --- a/skimage/measure/_marching_cubes.py +++ b/skimage/measure/_marching_cubes.py @@ -7,8 +7,11 @@ from . import _marching_cubes_cy def marching_cubes(volume, level=None, spacing=(1., 1., 1.), gradient_direction='descent'): """ - Classic marching cubes algorithm to find surfaces in 3d volumetric data + Classic marching cubes algorithm to find surfaces in 3d volumetric data. + Note that the ``marching_cubes_lewiner()`` algorithm is recommended over + this algorithm, because it's faster and produces better results. + Parameters ---------- volume : (M, N, P) array of doubles @@ -106,7 +109,8 @@ def marching_cubes(volume, level=None, spacing=(1., 1., 1.), .. [1] Lorensen, William and Harvey E. Cline. Marching Cubes: A High Resolution 3D Surface Construction Algorithm. Computer Graphics (SIGGRAPH 87 Proceedings) 21(4) July 1987, p. 163-170). - + DOI: 10.1145/37401.37422 + See Also -------- skimage.measure.marching_cubes_lewiner diff --git a/skimage/measure/_marching_cubes_lewiner.py b/skimage/measure/_marching_cubes_lewiner.py index 5f1db597..2c6f1fd6 100644 --- a/skimage/measure/_marching_cubes_lewiner.py +++ b/skimage/measure/_marching_cubes_lewiner.py @@ -16,7 +16,7 @@ def marching_cubes_lewiner(volume, level=None, spacing=(1., 1., 1.), gradient_direction='descent', step_size=1, allow_degenerate=True, use_classic=False): """ - Lewiner marching cubes algorithm to find surfaces in 3d volumetric data + Lewiner marching cubes algorithm to find surfaces in 3d volumetric data. In contrast to ``marching_cubes()``, this algorithm is faster, resolves ambiguities, and guarantees topologically correct results. @@ -84,10 +84,11 @@ def marching_cubes_lewiner(volume, level=None, spacing=(1., 1., 1.), References ---------- - .. [1] Thomas Lewiner, Helio Lopes, Antonio Wilson Vieira and Geovan - Tavares. Efficient implementation of Marching Cubes' cases with - topological guarantees. Journal of Graphics Tools 8(2) - pp. 1-15 (december 2003). + .. [1] Thomas Lewiner, Helio Lopes, Antonio Wilson Vieira and Geovan + Tavares. Efficient implementation of Marching Cubes' cases with + topological guarantees. Journal of Graphics Tools 8(2) + pp. 1-15 (december 2003). + DOI: 10.1080/10867651.2003.10487582 See Also --------