Versions Compared

Version Old Version 53 New Version 54
Changes made by

Kaz Wanelik (Unlicensed)

Kaz Wanelik (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ItemParameter nameParameter formatExample(s)Comment(s)
Parameter valueEffect
1preview[ind_0, ind_1,... ind_(n-1)]


[ ]To select the entire n-dimensional dataset of sample projections, stored at location specified by the data_path parameter and accompanied by the image-key data supplied via the image_key_path parameter.
  1. The preview parameter provides a convenient mechanism for restricting the entire dataset to a desired subset.
  2. The default value of the preview parameter, [ ] (empty Python list), represents the entire dataset.
[:, :, :]To select the entire 3d dataset of sample projections, stored at location specified by the data_path parameter and accompanied by the image-key data supplied via the image_key_path parameter.
[:, s, :] To select from a given 3d dataset of sample projections (stored at the data_path location with the corresponding image keys at the image_key_path location) only a subset of data corresponding to the s-th sinogram.This particular interpretation applies if data are laid out in the (angle_enumeration, image_height, image_width) format.
[p, :, :]To select from a given 3d dataset of sample projections (stored at data_path location with the corresponding image keys at the image_key_path location) only a subset of data corresponding to the p-th sample projection.This particular interpretation applies if data are laid out in the (angle_enumeration, image_height, image_width) format.
[:, :, 123 12:-12334]To select from a given 3d dataset of sample projections (stored at the data_path location with the corresponding image keys at the image_key_path location) only a subset of data generated by cropping the width of each sample projection by 123 pixels on either 12 pixels from the left-hand side and 34 pixels from the right-hand side.This particular interpretation applies if data are laid out in the (angle_enumeration, image_height, image_width) format.
[:, mid - 1:mid + 1, :]To select from a given 3d dataset of sample projections (stored at the data_path location with the corresponding image keys at the image_key_path location) only a subset of data corresponding to the middle 2 sinograms.mid is one of Savu keywords (with an obvious meaning).

[0:end:2, :, :]

[::2, :, :]

To select from a given 3d dataset of sample projections (stored at the data_path location with the corresponding image keys at the image_key_path location) only a subset of data corresponding to every other sample projection.end is one of Savu keywords (with an obvious meaning).

[0:end:end, :, :]

[::end, :, :]

To select from a given 3d dataset of sample projections (stored at the data_path location with the corresponding image keys at the image_key_path location) only the first and the last sample projection.

[:, 0:end:2, :]

[:, ::2, :]

To select from a given 3d dataset of sample projections (stored at the data_path location with the corresponding image keys at the image_key_path location) only a subset of data corresponding to every other sinogram.
2

image_key_path




  1. Mandatory dataset.

  2. The values of image keys are as follows: 2 represents dark-field image; 1 represents flat-field image; 0 represents sample projection.

3

name


<any-string>With this choice of value for the name parameter, the reconstructed volume can be found at /entry/final_result_<any-string>/data in the principal output file, named <scan-number>_processed.nxs; TIFF images generated by TiffSaver can be found in a directory called TiffSaver-<any-string>, etc.
4

3d_to_4d





5

flat

[<path-to-NeXus-file>, <path-to-dataset>, <exposure-time-compensation-factor>][/dls/i13/data/2018/cm123-4/raw/5678.nxs, entry1/instrument/detector/pco1/data, 1.25]To select all flat-field images from the flats-only dataset located at entry1/instrument/detector/pco1/data inside a NeXus scan file, stored on the file system at /dls/i13/data/2018/cm123-4/raw/5678.nxs, and then to multiply their pixel values by 1.25 (to compensate for the flat-field exposure interval being 0.8 times shorter than the sample-projection exposure time).
  1. This parameter needs to be specified only if flats are not stored in the same dataset as sample projections.
  2. If <path-to-NeXus-file> is not None, then flats are loaded from a dataset found at <path-to-dataset> inside a NeXus file, located on the file-system at <path-to-NeXus-file>, and their pixel values are then multiplied by <exposure-time-compensation-factor>.
  3. No image-key information is required to accompany the flat dataset, and, if present (at the location specified by image_key_path), this information is ignored.
  4. Note that, if the flat-field dataset is integer-valued, then the multiplication by <exposure-time-compensation-factor> (even if the latter is equal to 1) changes this data type to the floating-point type, which in turn may be unsuitable as input for the immediately succeeding process, e.g. Dezinger (use DezingerSinogram instead).
6

data_path




Mandatory dataset.
7

dark

[<path-to-NeXus-file>, <path-to-dataset>, <exposure-time-compensation-factor>][/dls/i13/data/2018/cm123-4/raw/8765.nxs, entry1/instrument/detector/pco1/data, 1]To select all dark-field images from the darks-only dataset located at entry1/instrument/detector/pco1/data inside a NeXus scan file, stored on the file system at /dls/i13/data/2018/cm123-4/raw/8765.nxs, and then to multiply their pixel values by 1 (this trivial multiplication factor should be used whenever the dark-field exposure interval is the same as the sample-projection exposure interval, in which case no change to recorded intensities is, of course, necessary).
  1. This parameter needs to specified only if darks are not stored in the same dataset as sample projections.
  2. If <path-to-NeXus-file> is not None, then darks are loaded from a dataset found at <path-to-dataset> inside a NeXus file, located on the file-system at <path-to-NeXus-file>, and their pixel values are then multiplied by <exposure-time-compensation-factor>.
  3. No image-key information is required to accompany the dark dataset, and, if present (at the location specified by image_key_path), this information is ignored.
  4. Note that, if the dark-field dataset is integer-valued, then the multiplication by <exposure-time-compensation-factor> (even if the latter is equal to 1) changes this data type to the floating-point type, which in turn may be unsuitable as input for the immediately succeeding process, e.g. Dezinger (use DezingerSinogram instead).
8

angles


None (Python keyword)If the angles parameter is set to None, then this loader attempts to access values in a default dataset, located at entry1/tomo_entry/data/rotation_angle in the input NeXus scan file.
numpy.linspace(0,180,1801)

array([  0.00000000e+00,   1.00000000e-01,   2.00000000e-01, ...,

         1.79800000e+02,   1.79900000e+02,   1.80000000e+02])


9

ignore_flats

[ind_1, ind_2,... ind_m][1, r]To ignore the initial and the r-th batch in a given series of batches of flats (each containing however many individual flat-field images), stored in the same dataset as darks and sample projections.
  1. Useful for excluding compromised flats in combined datasets containing multiple batches of interspaced flats.
  2. In the ignore_flats list, batch indexing starts from 1 (not 0).

...