Imaging

ska_sdp_func_python.imaging.base Module

Base Imaging functions.

Functions

advise_wide_field(vis[, delA, ...])

Advise on parameters for wide field imaging.

create_image_from_visibility(vis, **kwargs)

Make an empty Image from params and Visibility.

fill_vis_for_psf(svis)

Fill the visibility for calculation of PSF.

invert_awprojection(vis, im[, dopsf, ...])

Invert using convolutional degridding and an AW kernel.

normalise_sumwt(im, sumwt[, min_weight, ...])

Normalise out the sum of weights.

predict_awprojection(vis, model[, gcfcf])

Predict using convolutional degridding and an AW kernel.

shift_vis_to_image(vis, im[, tangent, inverse])

Shift visibility in place to the phase centre of the Image.

visibility_recentre(uvw, dl, dm)

Compensate for kernel re-centering - see w_kernel_function.

ska_sdp_func_python.imaging.dft Module

Functions that aid Fourier transform processing.

Functions

dft_cpu_looped(direction_cosines, ...)

CPU computational kernel for DFT, using explicit loop over components.

dft_gpu_raw_kernel(direction_cosines, ...)

CPU computational kernel for DFT, using CUDA raw code via cupy.

dft_kernel(direction_cosines, vfluxes, ...)

CPU computational kernel for DFT, choice dependent on dft_compute_kernel.

dft_skycomponent_visibility(vis, sc[, ...])

DFT to get the visibility from a SkyComponent, for Visibility.

extract_direction_and_flux(sc, vis)

Extract SkyComponent direction and flux to be consumed by DFT.

idft_visibility_skycomponent(vis, sc)

Inverse DFT a SkyComponent from Visibility.

ska_sdp_func_python.imaging.imaging Module

Functions for predicting visibility from a model image, and invert a visibility to make an (Image, sumweights) tuple. These redirect to specific versions.

Functions

invert_visibility(vis, im[, dopsf, ...])

Invert Visibility to make an (Image, sum weights) tuple.

predict_visibility(vis, model[, context, gcfcf])

Predict Visibility from an Image.

ska_sdp_func_python.imaging.imaging_helpers Module

Functions to aid operations on imaging results.

Functions

remove_sumwt(results)

Remove sumwt term in list of (image, sumwt) tuples.

sum_invert_results(image_list)

Sum a set of invert results with appropriate weighting.

sum_predict_results(results)

Sum a set of predict results of the same shape.

threshold_list(imagelist, threshold, ...[, ...])

Find actual threshold for list of results, optionally using moment 0.

ska_sdp_func_python.imaging.ng Module

Functions that implement prediction of and imaging from visibilities using the nifty gridder (DUCC version).

https://gitlab.mpcdf.mpg.de/mtr/ducc.git

This performs all necessary w term corrections, to high precision.

Note that nifty gridder doesn’t like some null data such as all w = 0 and do_wstacking=True. Also true of the visibilities.

Functions

invert_ng(bvis, model[, dopsf, normalise])

Invert using nifty-gridder module.

predict_ng(bvis, model, **kwargs)

Predict using convolutional degridding.

ska_sdp_func_python.imaging.weighting Module

Functions that aid weighting the visibility data prior to imaging.

There are two classes of functions:
  • Changing the weight dependent on noise level or sample density or a combination

  • Tapering the weight spatially to avoid effects of sharp edges or to emphasize a given scale size in the image

Functions

taper_visibility_gaussian(vis[, beam])

Taper the visibility weights.

taper_visibility_tukey(vis[, tukey])

Taper the visibility weights.

weight_visibility(vis, model[, weighting, ...])

Weight the visibility data.

ska_sdp_func_python.imaging.wg Module

Functions that implement prediction of and imaging from visibilities using the GPU-based w-stacking gridder from ska-sdp-func (which is compatible with the DUCC/nifty gridder).

Functions

invert_wg(bvis, model[, dopsf, normalise])

Invert using GPU-based w-stacking gridder module.

predict_wg(bvis, model, **kwargs)

Predict using GPU-based w-stacking degridder module.