add_objects_to_image

romanisim.image.add_objects_to_image(image, objlist, xpos, ypos, psf, flux_to_counts_factor, bandpass=None, filter_name=None, rng=None, seed=None)

Add sources to an image.

Note: this includes Poisson noise when photon shooting is used (i.e., for chromatic source profiles), and otherwise is noise free.

Parameters:
imagegalsim.Image

Image to which to add sources with associated WCS.

objlistlist[CatalogObject]

Objects to add to image

xpos, yposarray_like

x & y positions of sources (pixel) at which sources should be added

psfgalsim.Profile

PSF for image

flux_to_counts_factorfloat

physical fluxes in objlist (whether in profile SEDs or flux arrays) should be multiplied by this factor to convert to total counts in the image

bandpassgalsim.Bandpass

bandpass in which image is being rendered. This is used only in cases where chromatic profiles & PSFs are being used.

filter_namestr

filter to use to select appropriate flux from objlist. This is only used when achromatic PSFs and sources are being rendered.

rnggalsim.BaseDeviate

random number generator to use

seedint

seed to use for random number generator

Returns:
outinfonp.ndarray

Array structure containing rows for each source. The columns give the total number of counts from the source entering the image and the time taken to render the source.