h5analysis.beamlines.REIXS.XEOLLoader

class h5analysis.beamlines.REIXS.XEOLLoader

Bases: XESLoader

Load and plot X-ray excited optical luminescence scan(s)

Methods

add(config, filename, detector, *args[, grid])	Add specified scans for selected streams.
background(config, filename, detector, *args)	Subtracts the defined data from all loaded data
compare(plot_object)	Loads data previously specified in a loader
export(filename[, split_files])	Export and write data to specified file.
exportWidgetStep()	Helper function for exporter widget.
exporter()	Interactive exporter widget.
fit(line, scans, center, amplitude, sigma[, ...])
get_data()	Make data available in memory as exported to file.
hline(pos, **kwargs)	Draw a horizontal line in the plot.
label(pos_x, pos_y, text, **kwargs)	Draw a text box in the plot.
load(config, filename, detector, *args[, grid])	Load one or multiple scan(s).
loadObj(obj, line)	Loads data previously specified in a loader
plot([linewidth, xlabel, ylabel, ...])	Plot all data assosciated with class instance/object.
plot_legend(pos)	Overwrite default legend position.
save_plot(fname, **kwargs)	Create a matplotlib plot window
show_fluorescence(element, siegbahn_symbol)	Draw a line in the plot for the requested fluorescence line.
stitch(config, filename, detector, *args[, grid])	Stitch specified scans for selected streams.
subtract(config, filename, detector, *args)	Subtract specified scans for selected streams.
vline(pos, **kwargs)	Draw a vertical line in the plot.
xlim(lower, upper)	Set x-axis limits applied to data stream.
ylim(lower, upper)	Set y-axis limits applied to data stream.

add(config, filename, detector, *args, grid=[None, None, None], **kwargs)

Add specified scans for selected streams.

Parameters:

• See loader function.

• Adds all scans specified in *args.

background(config, filename, detector, *args, grid=[None, None, None], **kwargs)

Subtracts the defined data from all loaded data

Parameters:

• config (dict) – REIXS beamline endstation configuration

• filename (string) – file name

• detector (string) – alias for MCA type detector

• *args (int) – scans

• **kwargs –

  norm: boolean

  normalizes to [0,1]

  xoffset: list

  fitting offset (x-stream)

  xcoffset: float

  constant offset (x-stream)

  yoffset: list

  fitting offset (y-stream)

  ycoffset: float

  constant offset (y-stream)

  grid: list

  grid data evenly with [start,stop,delta]

  savgol: tuple

  (window length,polynomial order,derivative)

  binsize: int

  puts data in bins of specified size

  legend_items: dict

  dict[scan number]=description for legend

compare(plot_object)

Loads data previously specified in a loader

Parameters:

plot_object (object) – name of the Loader object

export(filename, split_files=False)

Export and write data to specified file.

Parameters:

• filename (string)

• split_files (Boolean) – Sets whether scans are exported appended to one file (False), or separately (True)

exportWidgetStep()

Helper function for exporter widget.

exporter()

Interactive exporter widget.

get_data()

Make data available in memory as exported to file.

Returns:

• dfT (pandas DataFrame) – All loaded data.

• files (list) – List of all loaded files.

hline(pos, **kwargs)

Draw a horizontal line in the plot.

Parameters:

• pos (float)

• **kwargs (dict, optional) – See bokeh manual for available options.

label(pos_x, pos_y, text, **kwargs)

Draw a text box in the plot.

Parameters:

• pos_x (float)

• pos_y (float)

• text (string)

• **kwargs (dict, optional) – See bokeh manual for available options.

load(config, filename, detector, *args, grid=[None, None, None], **kwargs)

Load one or multiple scan(s).

Parameters:

• config (dict) – REIXS beamline endstation configuration

• filename (string) – file name

• detector (string) – alias for MCA type detector

• *args (ints) – scans,comma separated

• **kwargs –

  norm: boolean

  normalizes to [0,1]

  xoffset: list

  fitting offset (x-stream)

  xcoffset: float

  constant offset (x-stream)

  yoffset: list

  fitting offset (y-stream)

  ycoffset: float

  constant offset (y-stream)

  grid: list

  grid data evenly with [start,stop,delta]

  savgol: tuple

  (window length,polynomial order,derivative)

  binsize: int

  puts data in bins of specified size

  twin_y: boolean

  supports a second y-axis on the right-hand side

loadObj(obj, line)

Loads data previously specified in a loader

Parameters:

• obj (object) – name of the Loader object

• line (int) – Number of the load, add, subtract line (start indexing with 0)

plot(linewidth=2, xlabel='Wavelength [nm]', ylabel='Counts', ylabel_right='Counts', plot_width=900, plot_height=600, xprec=3, **kwargs)

Plot all data assosciated with class instance/object.

Parameters:

• linewidth (int,optional)

• title (string,optional)

• xlabel (string,optional)

• ylabel (string,optional)

• ylabel_right (string,optional)

• plot_height (int,optional)

• plot_width (int,optional)

• norm (boolean,optional) – Normalized plot output to [0,1]

• waterfall (float) – Normalizes plot output to [0,1] and applies offset specified

• xprec (int, optional) – Specifies the forced floating point X precision of the hover tool

• yprec (int, optional) – Specifies the forced floating point Y precision of the hover tool

• kwargs – all bokeh figure key-word arguments

plot_legend(pos)

Overwrite default legend position.

Parameters:

pos (string) – See bokeh manual for available options.

save_plot(fname, **kwargs)

Create a matplotlib plot window

fname: string

path and file name of the exported file

kwargs:

figsize: tuple

determines size of plot

x_minor_ticks: float

distance between minor ticks on primary axis

x_major_ticks: float

distance between major ticks on primary axis

y_minor_ticks: float

distance between minor ticks on secondary axis

y_major_ticks: float

distance between major ticks on secondary axis

top: Boolean

Display ticks on top of the plot

right: Boolean

Display ticks on the right of the plot

fontsize_axes: string or int

Set the fontsize of the axes ticks

fontsize_labels: string or int

Set fontsize of the axis labels

fontsize_title: string or int

Set fontsize of the title

title_pad: int

Padding between title and the top of the plot

xlabel: string

Label of the primary axis

ylabel: string

Label of the secondary axis

title: string

Title displayed at the top of the plot

xlim: tuple

Limits the visible x-range

ylim: tuple

Limits the visible y-range

legend: Boolean

Show/Hide plot legend

fontsize_legend: int

Fontsize of the legend entries

data_format: string, [pdf,svg,png]

Sets the output data format and matplotlib backend used

show_fluorescence(element, siegbahn_symbol, orientation='v', **kwargs)

Draw a line in the plot for the requested fluorescence line.

Parameters:

• element (string) – IUPAC element abbreviation

• siegbahn_symbol (string) – Siegbahn symbol for requested energy transition

• orientation ([‘v’,’h’]) – Determines if a vertical or horizontal line is drawn

• **kwargs (dict, optional) – See bokeh manual for available options.

stitch(config, filename, detector, *args, grid=[None, None, None], **kwargs)

Stitch specified scans for selected streams.

Parameters:

• See loader function.

• stitches all scans specified in *args.

subtract(config, filename, detector, *args, grid=[None, None, None], **kwargs)

Subtract specified scans for selected streams.

Parameters:

• See loader function.

• Subtracts all scans from the first element. May add scans in first element by specifying list of scans as first *arg.

vline(pos, **kwargs)

Draw a vertical line in the plot.

Parameters:

• pos (float)

• **kwargs (dict, optional) – See bokeh manual for available options.

xlim(lower, upper)

Set x-axis limits applied to data stream.

Parameters:

• lower (float)

• upper (float)

ylim(lower, upper)

Set y-axis limits applied to data stream.

Parameters:

• lower (float)

• upper (float)