display_psf_difference¶

poppy.display_psf_difference(hdulist_or_filename1=None, HDUlist_or_filename2=None, ext1=0, ext2=0, vmin=None, vmax=0.0001, title=None, imagecrop=None, adjust_for_oversampling=False, crosshairs=False, cmap=None, colorbar=True, colorbar_orientation='vertical', print_=False, ax=None, return_ax=False, normalize=False, normalize_to_second=False)[source]¶

Display nicely the difference of two PSFs from given files

The two files may be FITS files on disk or FITS HDUList objects in memory. The two must have the same shape and size.

hdulist_or_filename1, HDUlist_or_filename2 : fits.HDUlist or string: FITS files containing images to difference
ext1, ext2 : int: FITS extension. default = 0
vmin, vmax : float: Image intensity scaling min and max.
title : string, optional: Title for plot.
imagecrop : float: Size of region to display (default is whole image).
adjust_for_oversampling : bool: Rescale to conserve surface brightness for oversampled PSFs? (Making this True conserves surface brightness but not total flux.) Default is False, to conserve total flux.
crosshairs : bool: Plot crosshairs over array center?
cmap : matplotlib.cm.Colormap instance or None: Colormap to use. If not given, use standard gray colormap.
colorbar : bool: Draw a colorbar on the image?
colorbar_orientation : ‘vertical’ (default) or ‘horizontal’: How should the colorbar be oriented? (Note: Updating a plot and changing the colorbar orientation is not supported. When replotting in the same axes, use the same colorbar orientation.)
print\_ : bool: Print RMS difference value for the images? (Default: False)
ax : matplotlib.Axes instance: Axes to display into.
return_ax : bool: Return the axes to the caller for later use? (Default: False) When True, this function returns a matplotlib.Axes instance, or a tuple of (ax, cb) where the second is the colorbar Axes.
normalize : bool: Display (difference image)/(mean image) instead of just the difference image. Mutually exclusive to normalize_to_second. (Default: False)
normalize_to_second : bool: Display (difference image)/(second image) instead of just the difference image. Mutually exclusive to normalize. (Default: False)