This documentation page refers to a previous release of DIALS (1.14).
Click here to go to the corresponding page for the latest version of DIALS

dials.slice_sweep

Introduction

Slice a sweep to produce a smaller sweep within the bounds of the original. If experiments or datablocks are provided, modify the scan objects within these. If reflections are provided, remove reflections outside the provided image ranges. Each image_range parameter refers to a single experiment ID, counting up from zero. Any reflections with experiment ID not matched by a image_range parameter are removed.

Examples:

dials.slice_sweep experiments.json reflections.pickle "image_range=1 20"

dials.slice_sweep datablock.json "image_range=1 20"

# two experiments and reflections with IDs '0' and '1'
dials.slice_sweep experiments.json reflections.pickle     "image_range=1 20" "image_range=5 30"

Basic parameters

output {
  experiments_filename = None
  reflections_filename = None
  datablocks_filename = None
}
image_range = None
block_size = None

Full parameter definitions

output {
  experiments_filename = None
    .help = "The filename for output experimental models with sliced scans.
  "
            "            By default generated automatically from the input"
            "name"
    .type = str
  reflections_filename = None
    .help = "The filename for output reflections sliced to remove those"
            "outside the reduced image range. By default generated"
            "automatically from the input name"
    .type = str
  datablocks_filename = None
    .help = "The filename for the output datablock with sliced scans.
        "
            "      By default generated automatically from the input name"
    .type = str
}
image_range = None
  .help = "Range in images to slice a sweep. The number of arguments must be a"
          "factor of two. Each pair of arguments gives a range that follows C"
          "conventions (e.g. j0 <= j < j1) when slicing the reflections by"
          "observed centroid."
  .type = ints(size=2)
  .multiple = True
block_size = None
  .help = "Overrides image_range if present. This option splits each sweep"
          "into the nearest integer number of equal size blocks close to"
          "block_size degrees in width"
  .type = float(allow_none=True)