WedgeAp

WedgeAp(
    positions,
    r_in,
    r_out,
    theta_in,
    dtheta_in,
    theta_out=None,
    dtheta_out=None,
    plot_samples=96,
    *,
    validate=True,
)

Annular wedge aperture in pixel coordinates.

A wedge is bounded by inner and outer circular arcs, with straight sides connecting the corresponding arc endpoints. Angles are in radians, measured counterclockwise from the positive image x axis. dtheta_* values are full angular widths. If theta_out or dtheta_out is None, the corresponding inner value is used, giving the constant-width annular sector used by wedge-photometry workflows.

Parameters

positions : tuple or array - like

Aperture center or centers as (x, y) pixel coordinates. Multiple centers are accepted as an (N, 2) array-like object. Coordinates are copied into owned, read-only float64 storage. Editing the input does not move the aperture; construct a new aperture to change centers. The positions attribute cannot be reassigned. C-order, Fortran-order, and strided inputs are accepted. Input (x, y) gives scalar sums; [(x, y)] gives length-one vector sums.

r_in : float

Inner and outer radii in pixels. r_out must be larger than r_in and r_in must be positive.

r_out : float

Inner and outer radii in pixels. r_out must be larger than r_in and r_in must be positive.

theta_in : float

Center angle and full angular width at r_in. dtheta_in must be in (0, 2*pi).

dtheta_in : float

Center angle and full angular width at r_in. dtheta_in must be in (0, 2*pi).

theta_out : float = None

Center angle and full angular width at r_out. dtheta_out must be in (0, 2*pi). Missing values default to the corresponding inner value.

dtheta_out : float = None

Center angle and full angular width at r_out. dtheta_out must be in (0, 2*pi). Missing values default to the corresponding inner value.

plot_samples : int = 96

Even number of samples used to draw the two circular arcs.

validate : bool = True

If False, skip input validation and assume finite, ordered geometry and finite positions with shape (2,) or (N, 2). Coordinates are still copied and converted to float64.

Attributes

Name	Description
area	Analytic wedge area, before image clipping or bad-pixel masking.