LSST Applications g013ef56533+d2224463a4,g199a45376c+0ba108daf9,g19c4beb06c+9f335b2115,g1fd858c14a+2459ca3e43,g210f2d0738+2d3d333a78,g262e1987ae+abbb004f04,g2825c19fe3+eedc38578d,g29ae962dfc+0cb55f06ef,g2cef7863aa+aef1011c0b,g35bb328faa+8c5ae1fdc5,g3fd5ace14f+19c3a54948,g47891489e3+501a489530,g4cdb532a89+a047e97985,g511e8cfd20+ce1f47b6d6,g53246c7159+8c5ae1fdc5,g54cd7ddccb+890c8e1e5d,g5fd55ab2c7+951cc3f256,g64539dfbff+2d3d333a78,g67b6fd64d1+501a489530,g67fd3c3899+2d3d333a78,g74acd417e5+0ea5dee12c,g786e29fd12+668abc6043,g87389fa792+8856018cbb,g89139ef638+501a489530,g8d7436a09f+5ea4c44d25,g8ea07a8fe4+81eaaadc04,g90f42f885a+34c0557caf,g9486f8a5af+165c016931,g97be763408+d5e351dcc8,gbf99507273+8c5ae1fdc5,gc2a301910b+2d3d333a78,gca7fc764a6+501a489530,gce8aa8abaa+8c5ae1fdc5,gd7ef33dd92+501a489530,gdab6d2f7ff+0ea5dee12c,ge410e46f29+501a489530,geaed405ab2+e3b4b2a692,gf9a733ac38+8c5ae1fdc5,w.2025.41
LSST Data Management Base Package
|
Classes | |
class | MultiResolutionSupport |
Functions | |
np.ndarray | bspline_convolve (np.ndarray image, int scale) |
int | get_starlet_scales (Sequence[int] image_shape, int|None scales=None) |
np.ndarray | starlet_transform (np.ndarray image, int|None scales=None, int generation=2, Callable|None convolve2d=None) |
np.ndarray | multiband_starlet_transform (np.ndarray image, int|None scales=None, int generation=2, Callable|None convolve2d=None) |
np.ndarray | starlet_reconstruction (np.ndarray starlets, int generation=2, Callable|None convolve2d=None) |
np.ndarray | multiband_starlet_reconstruction (np.ndarray starlets, int generation=2, Callable|None convolve2d=None) |
MultiResolutionSupport | get_multiresolution_support (np.ndarray image, np.ndarray starlets, np.floating sigma, float sigma_scaling=3, float epsilon=1e-1, int max_iter=20, str image_type="ground") |
np.ndarray | apply_wavelet_denoising (np.ndarray image, np.floating|None sigma=None, float sigma_scaling=3, float epsilon=1e-1, int max_iter=20, str image_type="ground", bool positive=True) |
np.ndarray lsst.scarlet.lite.wavelet.apply_wavelet_denoising | ( | np.ndarray | image, |
np.floating | None | sigma = None, | ||
float | sigma_scaling = 3, | ||
float | epsilon = 1e-1, | ||
int | max_iter = 20, | ||
str | image_type = "ground", | ||
bool | positive = True ) |
Apply wavelet denoising Uses the algorithm and notation from Starck et al. 2011, section 4.1 Parameters ---------- image: The image to denoise sigma: The standard deviation of the image sigma_scaling: The threshold in units of sigma to declare a coefficient significant epsilon: Convergence criteria for determining the support max_iter: The maximum number of iterations. This applies to both finding the support and the denoising loop. image_type: The type of image that is being used. This should be "ground" for ground based images with wide PSFs or "space" for images from space-based telescopes with a narrow PSF. positive: Whether or not the expected result should be positive Returns ------- result: The resulting denoised image after `max_iter` iterations.
Definition at line 336 of file wavelet.py.
np.ndarray lsst.scarlet.lite.wavelet.bspline_convolve | ( | np.ndarray | image, |
int | scale ) |
Convolve an image with a bspline at a given scale. This uses the spline `h1d = np.array([1.0 / 16, 1.0 / 4, 3.0 / 8, 1.0 / 4, 1.0 / 16])` from Starck et al. 2011. Parameters ---------- image: The 2D image or wavelet coefficients to convolve. scale: The wavelet scale for the convolution. This sets the spacing between adjacent pixels with the spline. Returns ------- result: The result of convolving the `image` with the spline.
Definition at line 36 of file wavelet.py.
MultiResolutionSupport lsst.scarlet.lite.wavelet.get_multiresolution_support | ( | np.ndarray | image, |
np.ndarray | starlets, | ||
np.floating | sigma, | ||
float | sigma_scaling = 3, | ||
float | epsilon = 1e-1, | ||
int | max_iter = 20, | ||
str | image_type = "ground" ) |
Calculate the multi-resolution support for a dictionary of starlet coefficients. This is different for ground and space based telescopes. For space-based telescopes the procedure in Starck and Murtagh 1998 iteratively calculates the multi-resolution support. For ground based images, where the PSF is much wider and there are no pixels with no signal at all scales, we use a modified method that estimates support at each scale independently. Parameters ---------- image: The image to transform into starlet coefficients. starlets: The starlet dictionary used to reconstruct `image` with dimension (scales+1, Ny, Nx). sigma: The standard deviation of the `image`. sigma_scaling: The multiple of `sigma` to use to calculate significance. Coefficients `w` where `|w| > K*sigma_j`, where `sigma_j` is standard deviation at the jth scale, are considered significant. epsilon: The convergence criteria of the algorithm. Once `|new_sigma_j - sigma_j|/new_sigma_j < epsilon` the algorithm has completed. max_iter: Maximum number of iterations to fit `sigma_j` at each scale. image_type: The type of image that is being used. This should be "ground" for ground based images with wide PSFs or "space" for images from space-based telescopes with a narrow PSF. Returns ------- M: Mask with significant coefficients in `starlets` set to `True`.
Definition at line 243 of file wavelet.py.
int lsst.scarlet.lite.wavelet.get_starlet_scales | ( | Sequence[int] | image_shape, |
int | None | scales = None ) |
Get the number of scales to use in the starlet transform. Parameters ---------- image_shape: The 2D shape of the image that is being transformed scales: The number of scales to transform with starlets. The total dimension of the starlet will have `scales+1` dimensions, since it will also hold the image at all scales higher than `scales`. Returns ------- result: Number of scales, adjusted for the size of the image.
Definition at line 80 of file wavelet.py.
np.ndarray lsst.scarlet.lite.wavelet.multiband_starlet_reconstruction | ( | np.ndarray | starlets, |
int | generation = 2, | ||
Callable | None | convolve2d = None ) |
Reconstruct a multiband image. See `starlet_reconstruction` for a description of the remainder of the parameters.
Definition at line 220 of file wavelet.py.
np.ndarray lsst.scarlet.lite.wavelet.multiband_starlet_transform | ( | np.ndarray | image, |
int | None | scales = None, | ||
int | generation = 2, | ||
Callable | None | convolve2d = None ) |
Perform a starlet transform of a multiband image. See `starlet_transform` for a description of the parameters.
Definition at line 161 of file wavelet.py.
np.ndarray lsst.scarlet.lite.wavelet.starlet_reconstruction | ( | np.ndarray | starlets, |
int | generation = 2, | ||
Callable | None | convolve2d = None ) |
Reconstruct an image from a dictionary of starlets Parameters ---------- starlets: The starlet dictionary used to reconstruct the image with dimension (scales+1, Ny, Nx). generation: The generation of the starlet transform (either ``1`` or ``2``). convolve2d: The filter function to use to convolve the image with starlets in 2D. Returns ------- image: The 2D image reconstructed from the input `starlet`.
Definition at line 183 of file wavelet.py.
np.ndarray lsst.scarlet.lite.wavelet.starlet_transform | ( | np.ndarray | image, |
int | None | scales = None, | ||
int | generation = 2, | ||
Callable | None | convolve2d = None ) |
Perform a starlet transform, or 2nd gen starlet transform. Parameters ---------- image: The image to transform into starlet coefficients. scales: The number of scale to transform with starlets. The total dimension of the starlet will have `scales+1` dimensions, since it will also hold the image at all scales higher than `scales`. generation: The generation of the transform. This must be `1` or `2`. convolve2d: The filter function to use to convolve the image with starlets in 2D. Returns ------- starlet: The starlet dictionary for the input `image`.
Definition at line 105 of file wavelet.py.