webbpsf_ext.image_manip.make_disk_image

webbpsf_ext.image_manip.make_disk_image(inst, disk_params, sp_star=None, pixscale_out=None, dist_out=None, shape_out=None)[source]

Rescale disk model flux to desired pixel scale and distance. If instrument bandpass is different from disk model, scales flux assuming a grey scattering model.

Returns image flux values in photons/sec.

Parameters

  • inst (mod::webbpsf_ext instrument class) – E.g. NIRCam_ext, MIRI_ext classes

  • disk_params (dict) –

    Arguments describing the necessary model information:

    • ‘file’ : Path to model file or an HDUList.

    • ‘pixscale’ : Pixel scale (arcsec/pixel).

    • ‘dist’ : Assumed model distance in parsecs.

    • ‘wavelength’ : Wavelength of observation in microns.

    • ‘units’ : String of assumed flux units (ie., MJy/arcsec^2 or muJy/pixel)

    • ‘cen_star’ : True/False. Is a star already placed in the central pixel?

    Will Convert from [M,m,u,n]Jy/[arcsec^2,pixel] to photons/sec/pixel

Keyword Arguments

  • sp_star (pysynphot.spectrum) – A pysynphot spectrum of central star. Used to adjust observed photon flux if filter differs from model input

  • pixscale_out (float) – Desired pixelscale of returned image. If None, then use instrument’s oversampled pixel scale.

  • dist_out (float) – Distance to place disk at. Flux is scaled appropriately relative to the input distance specified in disk_params.

  • shape_out (tuple, int, or None) – Desired size for the output array (ny,nx). If a single value, then will create a 2-element tuple of the same value.