This section teaches you how to mask out unwanted portions of your image, such as the beamstop and bad detector pixels. It assumes you have just done Part 1. If not, open RAW as in Step 1 and set your data folder as in Step 8 of Part 1.

A video version of this tutorial is available:

The written version of the tutorial follows.

  1. In the Files tab, select the water1_014_0001.tif file and click the show image button.

    • Tip: It’s usually best to make a mask on a water or buffer image. If you do it on instrument background, which can be quite low, it can be hard to tell where the edges of the beamstop are. If you do it on a bright image, like a silver behenate or glassy carbon, you can get fooled by a small amount of bleed onto the pixels at the edge of the beamstop and not make a large enough mask.
  2. Set the image upper limit to 30 on a linear scale.

  3. Open the masking panel by clicking “Masking” in the Tools menu.

  4. Zoom in around the beamstop.

    • Note: The beamstop is the blue bar in the upper right of the detector.
  5. Select the Pan tool and left click and drag the image to the left until you can see a blank (white) canvas to the left of the beamstop.


  6. Click on the circle mask drawing button and click on a point at the center of the circular part of the beamstop.

  7. Move the cursor until the red outline of the circle covers the beamstop. Click again to make the circle mask.

    • Tip: If you mess up drawing the mask, click on the masked region (shaded red) and click your backspace/delete key to remove it.
    • Tip: You can also resize a rectangle (or circle) mask my right clicking on it and selecting resize.
    • Tip: You can create a rectangle of defined position and size by entering the x and y coordiantes of the bottom left corner and the width and height of the rectangle then clicking ‘Create’.
  8. If the mask is not perfectly centered, click and drag it until it’s centere.d

  9. If the mask is too large or small once centered, right click and click resize. Then move the mouse pointer to resize the mask, and click once to set the new size.


  10. Click on the polygon mask drawing button. Click on a point circular part of the beamstop near the top right edge. Click again near the start of the bar. Click again just past the top of the bar in the white canvas. Click again in the white canvas just below the bottom of the bar. Click again near the start of the bar on the bottom side near the circular region. Click again in the circular part of the beamstop near the bottom edge. Right click to finish the map.

    • Tip: Each click in a polygon mask adds a new point, which defines a line segement between it and the previous point.


  11. Zoom back out to the full extent of the image.

  12. Next you need to mask out the bad pixels on the detector. On a Pilatus detector, bad pixels usually have a value of -2.

  13. In the automatic section of the Mask Drawing controls, set Mask All Pixels = -2 and click ‘Create’.

    • This control allows you to mask pixels at, above, or below a given threshold. It is particularly useful for things like bad pixels, where the value is known.


  14. Next we need to mask the gaps between detector panels. Verify that the “pilatus_1m” detector is selected in the “Mask detector” control. Then click “Create”.

    • This control automatically creates masks of panel gaps for any known detector type.


  15. In the masking panel, make sure that “Beamstop mask” is selected in the Mask Creation dropdown menu. Click the “Set” button to set the mask you just made as the beamstop mask.


  16. Click the OK button to exit the masking panel.

  17. If you wish to edit the current mask, reopen the Masking panel. Then click the “Show” button to show the current mask. From there you can make changes, then click “Set” again.

Additional Tips

  1. Don’t be confused by the “Save to File” and “Load from file” buttons. These save the mask to a separate file or load a mask from a separate file. These do not save or set the mask in RAW. To do that you need to use the “Set” button as described above. The mask is then saved with the settings.