liger_iris_sim.expose.ifu

Functions

expose_ifu(source_cube, itime, n_frames, ...)

liger_iris_sim.expose.ifu.expose_ifu(source_cube: ndarray, itime: float, n_frames: int, collarea: float, sky_emission_rate: ndarray, sky_transmission: ndarray, tput: float, read_noise: float, dark_current: float, num_detector_pixels: float = 2.0) → dict[source]
Parameters:

  • source_cube (np.ndarray) – Source cube (y, x, wave). Units are photons / sec / m^2 / wavebin.

  • itime (float) – Integration time (sec).

  • n_frames (int) – Number of frames to coadd together.

  • collarea (float) – Collimating area (m^2)

  • sky_emission (np.ndarray) – The 1D sky background emission spectrum sampled on wavebins in units of photons / sec / m^2 / wavebin. Sky emission is NOT modulated by sky_transmission.

  • sky_transmission (np.ndarray) – The 1D sky background transmission for each spectrum normalized to [0, 1] for each wavebin. Only affects the source spectrum.

  • tput (float) – Total throughput (convert photons -> photoelectrons, e-).

  • read_noise (float) – The read noise in e- RMS.

  • num_detector_pixels (float) – The average number of detector pixels that integrate to form a single voxel.

Returns:

The final simulation and intermediate/ancillary products. Entries are:

  • sim_rate (np.ndarray): The simulated rate in e- / sec / wavebin.

  • sim_tot (np.ndarray): The simulated total in e- / wavebin.

  • observed_rate (np.ndarray): The observed rate in e- / sec / wavebin.

  • observed_tot (np.ndarray): The observed total in e- / wavebin.

  • source_rate (np.ndarray): The source rate in e- / sec / wavebin.

  • source_tot (np.ndarray): The source total in e- / wavebin.

  • dark_rate (float): The dark rate in e- / sec.

  • dark_tot (float): The dark total in e-.

  • sky_emission_rate (np.ndarray): The sky emission rate in e- / sec / wavebin.

  • sky_emission_tot (np.ndarray): The sky emission total in e- / wavebin.

  • sky_transmission (np.ndarray): The normalized sky transmission.

  • snr (np.ndarray): The SNR of the simulation.

  • noise_rate (np.ndarray): The noise rate in e- / sec / wavebin.

  • noise_tot (np.ndarray): The noise total in e- / wavebin.

  • read_noise_tot (float): The read noise contribution in e-.

Return type:

dict