\(\renewcommand\AA{\unicode{x212B}}\)

CalFile

Summary

The CalFile is a calibration file originally created for use in the Ariel powder diffraction data reduction package.

Files using this format with the .cal extension are still used by several algorithms in Mantid.

File Format

The file is a simple text file with the following format

#  number  UDET  offset  select  group
   0        611  0.0000000  1    0
   1        612  0.0000000  1    0
   2        601  0.0000000  0    0
            ...
  19     101001 -0.0497075  1    2
  20     101002 -0.3515893  1    2
  21     101003 -0.2803879  0    2
            ...
 349     201001  0.0525040  1    3
 350     201002  0.0538936  1    3
 351     201003  0.0535027  1    3
            ...

• number: ignored

• UDET: detector ID

• offset: calibration offset used in AlignDetectors. Comes from the OffsetsWorkspace, or 0.0 if none is given.

• select: 1 if selected (use the pixel). Comes from the MaskWorkspace, or 1 if none is given.

• group: what group to focus to in DiffractionFocussing. Comes from the GroupingWorkspace, or 1 if none is given. Setting the group as 0 specifies the detector as not to be grouped, effectively masking it.

See here for information on CalFile in the greater context of time-of-flight powder diffraction calibration.

Related algorithms

In addition to algorithms mentioned in powder diffraction calibration there are some algorithms specifically for CalFiles.

Loading and saving CalFiles

• LoadCalFile will load the CalFile into separate offset, masking and grouping workspaces.

• SaveCalFile will save a CalFile from separate offset, masking and grouping workspaces.

• MaskWorkspaceToCalFile will save a mask workspace as a CalFile.

• ReadGroupsFromFile Reads the groups from a CalFile, and output a 2D workspace containing on the Y-axis the values of the Group each detector belongs to. This is used to visualize the grouping scheme for powder diffractometers.

Creating CalFiles

• CreateCalFileByNames will create a CalFile with the grouping column set according to a list of bank names.

• CreateDummyCalFile creates a CalFile from a workspace. All of the offsets will be zero, and the pixels will be all grouped into one group.

Merging CalFiles

• MergeCalFiles combines the data contained in two CalFiles, based on the selections offsets, selections and groups can be merged. The matching rows are determined by UDET. Any unmatched records are added at the end of the file.

Category: Calibration