papyri
{ } Raw JSON

bundles / skimage 0.26.1rc0.dev0+git20260530.b607368ff / skimage / draw / draw / ellipse_perimeter

function

skimage.draw.draw:ellipse_perimeter

source: /dev/scikit-image/src/skimage/draw/draw.py :646

Signature

def   ellipse_perimeter ( r ,  c ,  r_radius ,  c_radius ,  orientation = 0 ,  shape = None )

Summary

Generate ellipse perimeter coordinates.

Parameters

r, c : int

Centre coordinate of ellipse.

r_radius, c_radius : int

Minor and major semi-axes. (r/r_radius)**2 + (c/c_radius)**2 = 1.

orientation : double, optional

Major axis orientation in clockwise direction as radians.

shape : tuple, optional

Image shape which is used to determine the maximum extent of output pixel coordinates. This is useful for ellipses that exceed the image size. If None, the full extent of the ellipse is used. Must be at least length 2. Only the first two values are used to determine the extent of the input image.

Returns

rr, cc : (N,) ndarray of int

Indices of pixels that belong to the ellipse perimeter. May be used to directly index into an array, e.g. img[rr, cc] = 1.

Examples

from skimage.draw import ellipse_perimeter
img = np.zeros((10, 10), dtype=np.uint8)
rr, cc = ellipse_perimeter(5, 5, 3, 4)
img[rr, cc] = 1
img
✓
Note that the positions of `ellipse` without specified `shape` can have also, negative values, as this is correct on the plane. On the other hand using these ellipse positions for an image afterwards may lead to appearing on the other side of image, because ``image[-1, -1] = image[end-1, end-1]`` 
rr, cc = ellipse_perimeter(2, 3, 4, 5)
img = np.zeros((9, 12), dtype=np.uint8)
img[rr, cc] = 1
img
✓

Aliases

  • skimage.draw.ellipse_perimeter

Referenced by

This package