dials.export_bitmaps

Introduction

Export raw diffraction image files as bitmap images, optionally exporting images from intermediate spot-finding steps (local mean and variance maps, or sigma_b, sigma_s or threshold-filtered images). Appearance of the images can be altered via the brightness and colour_scheme parameters, and optionally binning of pixels can be used to reduce image sizes.

Examples:

dials.export_bitmaps image.cbf

dials.export_bitmaps models.expt

dials.export_bitmaps image.cbf display=variance colour_scheme=inverse_greyscale

Basic parameters

binning = 1
brightness = 100
colour_scheme = *greyscale rainbow heatmap inverse_greyscale
projection = lab *image
padding = 4
display = *image mean variance dispersion sigma_b sigma_s threshold \
          global_threshold
nsigma_b = 6
nsigma_s = 3
global_threshold = 0
kernel_size = 3,3
min_local = 2
gain = 1
saturation = 0
show_mask = False
resolution_rings {
  show = False
  number = 5
  d_spacings = None
  fontsize = 30
  fill = red
}
ice_rings {
  show = False
  fontsize = None
  fill = blue
}
png {
  compress_level = 1
}
jpeg {
  quality = 75
}
output {
  prefix = "image"
  directory = None
  file = None
  format = jpeg *png tiff
}

Full parameter definitions

binning = 1
  .type = int(value_min=1, allow_none=True)
brightness = 100
  .type = float(value_min=0, allow_none=True)
colour_scheme = *greyscale rainbow heatmap inverse_greyscale
  .type = choice
projection = lab *image
  .type = choice
padding = 4
  .type = int(value_min=0, allow_none=True)
imageset_index = None
  .help = "The index/indices from an imageset to export. The first image of "
          "the set is 1."
  .type = int(allow_none=True)
  .multiple = True
  .expert_level = 2
display = *image mean variance dispersion sigma_b sigma_s threshold \
          global_threshold
  .type = choice
nsigma_b = 6
  .type = float(value_min=0, allow_none=True)
nsigma_s = 3
  .type = float(value_min=0, allow_none=True)
global_threshold = 0
  .type = float(value_min=0, allow_none=True)
kernel_size = 3,3
  .type = ints(size=2, value_min=1)
min_local = 2
  .type = int(allow_none=True)
gain = 1
  .type = float(value_min=0, allow_none=True)
saturation = 0
  .type = int(allow_none=True)
show_mask = False
  .type = bool
resolution_rings {
  show = False
    .type = bool
  number = 5
    .type = int(value_min=1, allow_none=True)
  d_spacings = None
    .type = floats(value_min=0)
  fontsize = 30
    .optional = True
    .type = int(allow_none=True)
  fill = red
    .help = "Colour of the resolution rings and labels"
    .type = str
}
ice_rings {
  show = False
    .type = bool
  fontsize = None
    .optional = True
    .type = int(allow_none=True)
  unit_cell = 4.498,4.498,7.338,90,90,120
    .help = "The unit cell to generate d_spacings for powder rings."
    .type = unit_cell
    .expert_level = 1
  space_group = 194
    .help = "The space group used to generate d_spacings for powder rings."
    .type = space_group
    .expert_level = 1
  fill = blue
    .help = "Colour of the ice rings and labels"
    .type = str
}
png {
  compress_level = 1
    .help = "ZLIB compression level, a number between 0 and 9: 1 gives best "
            "speed, 9 gives best compression, 0 gives no compression at all."
    .type = int(value_min=0, value_max=9, allow_none=True)
}
jpeg {
  quality = 75
    .help = "The image quality, on a scale from 1 (worst) to 95 (best)"
    .type = int(value_min=1, value_max=95, allow_none=True)
}
format
  .help = "Options to pass to the Format class"
  .expert_level = 2
{
  dynamic_shadowing = auto
    .help = "Enable dynamic shadowing"
    .type = bool
  multi_panel = False
    .help = "Enable a multi-panel detector model. (Not supported by all"
            "detector formats)"
    .type = bool
}
output {
  prefix = "image"
    .type = str
  directory = None
    .type = path
  file = None
    .help = "Full name of the output file. Overrides 'prefix' and the default "
            "file extension. Only makes sense if a single file is written."
    .type = str
  format = jpeg *png tiff
    .type = choice
}