2. Taking Cuts¶
This page provides a more detailed explanation on taking cuts in MSlice.
2.1. Cutting from the GUI¶
The cut tab will be disabled by default, and enabled when you click on a cuttable workspace. This is either a loaded
non-PSD dataset (see PSD and non-PSD modes), or a PSD dataset for which you have done a
Projection (converted to an
MD Event type workspace).
To plot a single cut, fill in values for the cut axis, labelled
along, its limits (
to), and the step
size. For non-PSD datasets you also have to select the axes
over which to integrate, and the integration range.
One of the cut or integration axis must be energy transfer in this case. For a PSD dataset, the
step specifies the two axes already. The axis which is not selected to plot
along is implicitly used as the integration
If you type
0 in or leave the
step input box empty, the default step size, determined from the data will be used.
You must specify values for the cut limits and integration range, however.
Multiple cuts can be plotted from the same dataset simultaneously by specifying an integration
width. This will produce
cuts between the specified integration minimum and maximum with the specified width, with the last cut being the remainder.
For example, if
Plot will overplot 4 cuts which
integrate over [0,3], [3,6], [6,9] and [9,10] respectively.
Cuts with the same range from multiple datasets can be plotted by first selecting multiple workspaces in the left panel.
There are two different methods to compute cuts:
Integration, which can be selected from the
Cut Algorithm drop down menu. The difference between these methods are described in the Cutting Algorithms
section below and in more detail in the Mathematical Reference.
Clicking on the
Norm to 1 check box will cause the resulting cut data to be normalised such that the maximum of the data
of each cut is unity.
Plot Over button allows you to overplot data on the same figure window without first clearing the current data. Note
that no check is made about whether the cuts makes sense (e.g. it is possible to plot a Q cut over an energy cut or vice
Finally, the cut figures have the same
Make Current window management system introduced in the original
Matlab MSlice as the slices. Clicking
Plot will send data to the Current figure window, clearing whatever was
previously plotted there. Clicking
Plot Over sends data to the Current figure window but plotting over data already
there. If you wish to have a fresh plot but to keep the data in a particular plot figure window, click
Keep. To make
a Kept figure Current again (for example to use
Plot Over), click
See Keep / Make Current for more details.
You can edit the axes limits, scale and titles by double-clicking on the relevant axis in the plot window. Clicking on each plot line will also allow you to change its colour and symbol. These functionalities are also accessible from the options button (the cog symbol) in the plot figure toolbar.
2.2. Overplotting powder lines¶
To help with a “first look” data analysis, MSlice can overplot on the cuts the positions of powder reflections from common
sample environment materials (Aluminium, Copper, Niobium and Tantalum). These functionalities may be accessed from the
Information menu option as shown above.
Powder reflections from an arbitrary crystallographic information format (CIF) file can also be plotted but note that we use the PyCifRW package to read CIF files and that some files generated by FullProf or GSAS may not be readable. In these cases, please load the files in Vesta or OpenBabel and resave them.
2.3. Converting intensity information in displayed data in cuts¶
In addition to displaying the cut data as , the cut figure window can also display the data with intensity information converted.
The different options available are:
The dynamical susceptibility (chi)
The magnetic dynamical susceptibility (chi magnetic)
The cross-section (d2sigma)
The general (neutron weighted) density of states (GDOS)
More informaton regarding these conversions and their relation to the default can be found with reference to Converting intensity information in displayed data in slices.
To convert the intensity information of data displayed through an interactive cut, the intensity of the parent slice
must be changed. To change the intensity of an individual interactive cut, the
interactive cut option of the parent
slice figure window must be toggled off.
2.4. Saving cuts¶
Each time you click
Plot Over an
MD Histo type workspace is created, and can be accessed from the
corresponding tab. This workspace can be saved to Nexus (
nxs), Matlab (
mat) or ASCII (
MSlice is able to load previously saved Nexus or ASCII cuts from file, but you may only then plot or overplot these cuts
(further manipulation of the cuts is not allowed, although you may normalise the intensity to unity for the plots).
The ASCII format is a simple three column
e type format. For
mat files, three vectors
y (signal) and
e (uncertainties) are saved.
From the plot figure window, you can also save the workspace data to the same formats (
addition you can also save the figure as an image, either in
In order to save a cut from an Interactive Cuts, you can click the
Save icon (floppy disk) direct on the cut
window, or first click the
Save Cut to Workspace button to create an
MD Histo type workspace and then use the
Save button on
When MSlice is used as a Mantid interface
MD Histo type workspaces can also be saved to Mantid Workbench by clicking the
Save to Workbench button either on the
MD Histo or the
2.5. Cutting Algorithms¶
There are two different methods used to compute cuts:
Integrationsums the (signal bin width) in the integration range.
Rebinaverages the signal in the integration range.
The two methods are described in more detail in the Mathematical Reference, but in short, there is a bin-dependent conversion factor between the two types of cuts which depends on the data coverage in the integration range of that bin. That is, if the integration range does not include regions without data (e.g. due to kinematic constraints), then the two cuts will be equivalent except for a constant scaling factor (proportional to the integration range). However, if the integration range overlaps regions without data, then the two cuts will give markedly different results.
The default method is
Rebin and is more suitable for DOS-types cuts which
integrate over whilst if you are interested in cross-sections and
are integrating over energy transfer, it is recommended to use
There is an option in the
Cut tab to change the cut algorithm from
Integration or vice versa and this setting will be saved for subsequent
similar cuts on the same workspace.
You can also change the default using the
Cut algorithm default
entry. This will change the default cut algorithm for this session of MSlice
(the default algorithm will revert to
Rebin if you restart MSlice).