autogalaxy.profiles.light.standard.SersicMultipole#

class SersicMultipole[source]#

Bases: _LightProfileMultipoleMixin, Sersic

The elliptical Sersic light profile with m=3 and m=4 Fourier multipole perturbations on the eccentric radius.

Parameters:
  • centre (Tuple[float, float]) – The (y,x) arc-second coordinates of the profile centre.

  • ell_comps (Tuple[float, float]) – The first and second ellipticity components of the elliptical coordinate system. The multipole perturbation is applied to the eccentric radius and therefore follows this ellipticity.

  • intensity (float) – Overall intensity normalisation of the light profile.

  • effective_radius (float) – The circular radius containing half the light of this profile (in the unperturbed limit multipole_*_comps = (0, 0)).

  • sersic_index (float) – Controls the concentration of the profile.

  • multipole_3_comps (Tuple[float, float]) – The (cos, sin) components of the m=3 Fourier perturbation. Defaults to (0.0, 0.0) which reduces the profile to Sersic.

  • multipole_4_comps (Tuple[float, float]) – The (cos, sin) components of the m=4 Fourier perturbation. Defaults to (0.0, 0.0) which reduces the profile to Sersic.

Methods

angle

The position angle in degrees of the major-axis of the ellipse defined by profile, defined counter clockwise from the positive x-axis (0.0 > angle > 180.0).

angle_radians

The position angle in radians of the major-axis of the ellipse defined by profile, defined counter clockwise from the positive x-axis (0.0 > angle > 2pi).

angle_to_profile_grid_from

The angle between each angle theta on the grid and the profile, in radians.

axis_ratio

The ratio of the minor-axis to major-axis (b/a) of the ellipse defined by profile (0.0 > q > 1.0).

blurred_image_2d_from

Evaluate the light object's 2D image from a input 2D grid of coordinates and convolve it with a PSF.

eccentric_radii_grid_from

Convert a grid of (y,x) coordinates to an eccentric radius: :math: axis_ratio^0.5 (x^2 + (y^2/q))^0.5

elliptical_radii_grid_from

Convert a grid of (y,x) coordinates to their elliptical radii values: :math: (x^2 + (y^2/q))^0.5

has

Returns True if any attribute of this profile is an instance of the input class cls, else False.

image_2d_from

Returns the 2D image of the multipole-perturbed Sersic profile.

image_2d_via_radii_from

Returns the 2D Sersic image evaluated at the input radial values.

luminosity_integral

Routine to integrate the luminosity of an elliptical light profile.

luminosity_within_circle_from

Integrate the light profile to compute the total luminosity within a circle of specified radius.

padded_image_2d_from

Evaluate the light object's 2D image from a input 2D grid of padded coordinates, where this padding is sufficient to encapsulate all surrounding pixels that will blur light into the original image given the 2D shape of the PSF's kernel.

perturbed_radii_from

Returns the eccentric radii of grid perturbed by the m=3 and m=4 Fourier multipoles, as a raw backend array (numpy or jax.numpy).

radial_grid_from

Convert a grid of (y, x) coordinates, to their radial distances from the profile centre (e.g. :math: r = sqrt(x**2 + y**2)).

rotated_grid_from_reference_frame_from

Rotate a grid of (y,x) coordinates which have been transformed to the elliptical reference frame of a profile back to the original unrotated coordinate grid reference frame.

transformed_from_reference_frame_grid_from

Transform a grid of (y,x) coordinates from the reference frame of the profile to the original observer reference frame.

transformed_to_reference_frame_grid_from

Transform a grid of (y,x) coordinates to the reference frame of the profile.

unmasked_blurred_image_2d_from

Evaluate the light object's 2D image from a input 2D grid of coordinates and convolve it with a PSF, using a grid which is not masked.

visibilities_from

Evaluate the light object's 2D image from a input 2D grid of coordinates and transform this to an array of visibilities using a autoarray.operators.transformer.Transformer object and therefore a Fourier Transform.

Attributes

coefficient_tag

A short string tag used to label the intensity coefficient when this profile is used inside a Basis object (e.g. for multi-Gaussian expansion or shapelet decomposition).

elliptical_effective_radius

The effective_radius of a Sersic light profile is defined as the circular effective radius, which is the radius within which a circular aperture contains half the profile's total integrated light.

half_light_radius

The radius that contains half of the total light of the profile (the half-light radius).

sersic_constant

A parameter derived from Sersic index which ensures that effective radius contains 50% of the profile's total integrated light.

multipole_3_comps

multipole_4_comps

image_2d_via_radii_from(grid_radii, xp=<module 'numpy' from '/home/docs/checkouts/readthedocs.org/user_builds/pyautolens/envs/latest/lib/python3.12/site-packages/numpy/__init__.py'>, **kwargs)[source]#

Returns the 2D Sersic image evaluated at the input radial values.

Unlike Sersic.image_2d_via_radii_from, this override accepts a raw backend array (the output of perturbed_radii_from) rather than an autoarray-wrapped grid, since the perturbation step strips the wrapper.

image_2d_from(grid, xp=<module 'numpy' from '/home/docs/checkouts/readthedocs.org/user_builds/pyautolens/envs/latest/lib/python3.12/site-packages/numpy/__init__.py'>, operated_only=None, **kwargs)[source]#

Returns the 2D image of the multipole-perturbed Sersic profile.