sep.sum_ellipann

sep.sum_ellipann(data, x, y, a, b, theta, rin, rout, err=None, var=None, mask=None, maskthresh=0.0, gain=None, subpix=5)

Sum data in elliptical annular aperture(s).

Parameters:

datandarray

2-d array to be summed.

x, yarray_like

Center coordinates and radius (radii) of aperture(s). x corresponds to the second (“fast”) axis of the input array and y corresponds to the first (“slow”) axis. x, y = (0.0, 0.0) corresponds to the center of the first element of the array. These inputs obey numpy broadcasting rules.

a, b, theta, rin, routarray_like

Elliptical annulus parameters. These inputs, along with x and y, obey numpy broadcasting rules. a is the semi-major axis, b is the semi-minor axis and theta is angle in radians between the positive x axis and the major axis. It must be in the range [-pi/2, pi/2]. It is also required that a >= b >= 0.0 and rout >= rin >= 0.0

err, varfloat or ndarray

Error or variance (specify at most one).

maskndarray, optional

Mask array. If supplied, a given pixel is masked if its value is greater than maskthresh.

maskthreshfloat, optional

Threshold for a pixel to be masked. Default is 0.0.

gainfloat, optional

Conversion factor between data array units and poisson counts, used in calculating poisson noise in aperture sum. If None (default), do not add poisson noise.

segmapndarray, optional

Segmentation image with dimensions of data and dtype np.int32. This is an optional input and corresponds to the segmentation map output by extract.

seg_idarray_like, optional

Array of segmentation ids used to mask additional pixels in the image. Dimensions correspond to the dimensions of x and y. The behavior differs depending on whether seg_id is negative or positive. If seg_id is positive, all pixels belonging to other objects are masked. (Pixel j, i is masked if seg[j, i] != seg_id and seg[j, i] != 0). If seg_id is negative, all pixels other than those belonging to the object of interest are masked. (Pixel j, i is masked if seg[j, i] != -seg_id). NB: must be included if segmap is provided.

subpixint, optional

Subpixel sampling factor. Default is 5.

Returns:

sumndarray

The sum of the data array within the aperture(s).

sumerrndarray

Error on the sum.

flagsndarray

Integer giving flags. (0 if no flags set.)