Skip to contents

Interactively set sequential measurements

Source: R/acq-interactive-utils.R
set_seq_interactive.Rd

Enter settings defining a sequence of spectra to be measured as a time series.

Usage

set_seq_interactive(
  seq.settings = NULL,
  measurement.duration = 0,
  minimum.step.delay = measurement.duration,
  time.division = 0
)

check_seq_settings(seq.settings = NULL)

Arguments

seq.settings

named list with numeric members start.boundary, initial.delay, step.delay, step.multiplier and num.steps.

measurement.duration

numeric Duration of one measurement event (s).

minimum.step.delay

numeric Minimum duration of "step.delay" (s).

time.division

numeric The step is forced to be a multiple of this time duration, because spectrometers normally are constantly acquiring spectra and they return the most recently acquired one. Should be set to the integration time plus a very small overhead (s).

Value

A named numeric vector of length two.

Details

In a sequence, measurements share a single reference, filter and/or dark scan, and are acquired as a sequence. For "sequences" of any length, including single spectra, the initial delay or time unit boundary can be used to schedule the start of a sequence of measurements or a single measurement. Using a step multiplier, it is possible to automatically generate time steps that increase in length exponentialy.

Function set_seq_interactive() allows users to change values in the list seq.settings(), which to define a sequence of spectral acquisitions. These are the time unit boundary to synchronize to, the delay or duration of the time step between successive acquisitions and the number of acquisitions in the series. The measurement.time determines the minimum length for "step".

Function check_seq_interactive() checks the validity, fills incomplete list with defaults and expands the time steps into a sequence based on fields step.multiplier and num.steps, resetting step.multiplier = 1.

See also

Other interactive acquisition utility functions: choose_ch_interactive(), choose_sr_interactive(), f.trigger.message(), list_srs_interactive(), protocol_interactive(), set_attributes_interactive(), set_folder_interactive(), set_session_name_interactive(), set_user_name_interactive(), set_wlrange_interactive(), tune_interactive()