Set number of exposures

Set the number of exposures and HDR.multipliers in the instrument settings data structure. This value is by default missing, indicating a protocol in which one assumes constant illumination during an integration. If the light exposure is shorter than the integration time, we need to express the results per exposure, and consequently calculations done based on the number of exposure events during each integration. This is the case, for example, when measuring the spectral emission of a xenon flash.

Usage

set_num_exposures(
  acq.settings,
  num.exposures = rep(-1L, length(HDR.mult)),
  HDR.mult = 1,
  single.scan = num.exposures > -1L,
  verbose = TRUE
)

Arguments

acq.settings

list as returned by function acq_settings()

num.exposures,

integer Number exposures per integration, set to -1L for continuous illumination.

HDR.mult

a numeric vector with integ.time multipliers to be used for "bracketing".

single.scan,

logical Will we use a single integration, or average multiple scans. By default it is TRUE when multiple exposures are used, and FALSE otherwise.

verbose

a logical to enable or disable warnings

Value

a copy of the argument passed for acq.settings with the integ.time field of the settings data replaced by integ.time.

See also

Other acquisition-settings related functions: acq_settings(), set_integ_time(), set_linearized()