liger_iris_sim.expose.imager

Functions

expose_imager(source_image[, itime, ...])

expose_imager(source_image: ndarray, itime: float = 1.0, n_frames: int = 1, collarea: float = 1.0, sky_emission_rate: float = 0.0, sky_trans_mean: float = 1.0, tput: float = 1.0, read_noise: float = 0.0, dark_current: float = 0.0) → dict[source]
Parameters:

  • source_image (np.ndarray) – The source image with the correct shape and scale as the final image, in units of photons / sec / m^2.

  • itime (float) – The exposure time in seconds. Default is 1.0 sec.

  • n_frames (int) – The total number of frames to coadd, each inducing a read noise. Default is 1.

  • collarea (float) – The telescope collimating area in units of m^2. Default is 1.0 m^2.

  • sky_emission_rate (float) – The background sky emission rate in units of photons / sec / m^2 / pixel. Default is 0.0.

  • sky_trans_mean (float) – The mean sky transmission. Default is 1.0.

  • tput (float) – The total throughput of the system. Default is 1.0.

  • read_noise (float) – The read noise in units of e- RMS. Default is 0.0.

  • dark_current (float) – The dark current rate in units of e- / sec / pixel. Default is 0.0.

Returns:

output (dict) –

The exposure components. Keys are:

  • ‘sim_rate’: 2D numpy array of the simulated image rate, noise free (e- / s)

  • ‘sim_tot’: 2D numpy array of the simulated image total, noise free (e-)

  • ‘observed_rate’: 2D numpy array of the observed image rate, with noise (e- / s)

  • ‘observed_tot’: 2D numpy array of the observed image total, with noise (e-)

  • ‘source_rate’: 2D numpy array of the source signal rate, noise free (e- / s)

  • ‘source_tot’: 2D numpy array of the source signal total, noise free (e-)

  • ‘dark_rate’: Value (scalar) of the dark current rate (e- / s)

  • ‘dark_tot’: Value (scalar) of the dark current total (e-)

  • ‘sky_em_rate’: Value (scalar) of the sky emission rate (e- / s)

  • ‘sky_em_tot’: Value (scalar) of the sky emission total (e-)

  • ‘snr’: 2D numpy array of the SNR for each pixel

  • ‘noise_rate’: 2D numpy array of the noise rate (e- / s)

  • ‘noise_tot’: 2D numpy array of the noise total (e-)

  • ‘read_noise_tot’: 2D numpy array of the read noise total (e-)