raman.loadFSRS

raman.loadFSRS(basename, wn=None, timesteps=None, excstr='exc*', filteroutliers=False)

Load and average all FSRS files matching the basename (e.g. using wildcards).

Parameters:
  • basename (mixed) – If basename is a str, use glob to load all matching files using wildcards. If basename is a list, use this list directly without wildcards (only works when no time steps are given).
  • wn (array) – If a wavenumber axis is given, the first column is interpolated over this axis (default = None).
  • timesteps (array) – If not None, load excited state data using the given time points. The time value is converted to a string and inserted into a %s tag in basename, or appended if no %s tag is found. Ground state data is not loaded.
  • excstr (str) – String that gets appended to the basename to indicate excited state spectra (default = ‘exc*’).
  • filteroutliers (bool) – If True, outliers, i.e., invalid data sets, are removed before averaging. An outlier is defined as a spectrum whose sum over amplitude squared deviates from the mean by more than two standard deviations.
Returns:

When no time steps are given, return the three columns of the FSRS file averaged over all input spectra, i.e. (Raman gain, probe with pump on, probe with pump off). When time steps are given, return three 2d arrays corresponding to the three columns with timesteps along axis 0 and data along axis 1.