make_pixelmap: create pixelmap from CrystFEL geometry file


make_pixelmap [options] input.geom
make_pixelmap --help


make_pixelmap takes a CrystFEL geometry file as input, and produces an HDF5 "pixel map" as used by Cheetah and OnDA. The HDF5 file will contain three arrays, "/x", "/y" and "/z", containing the x, y and z coordinates for each pixel, respectively, in metres, in real space. The file will also contain "/res" and "/coffset", containing the resolution of the detector (one over the pixel size in metres) and the default coffset value for the detector (or that for the first panel, if there is no default value set).

make_pixelmap currently assumes that the file layout is "slabby", i.e. all of the image data appears in one "slab", with the fs and ss coordinates of each pixel being unique across the entire detector.

With --badmap, make_pixelmap will instead write a map of bad pixels according to the bad regions specified in the geometry file.


Create a bad pixel mask instead of a pixel geometry map. The values to use for good and bad pixels in this map are given by --good-pixel and --bad-pixel respectively. Note that CrystFEL also has other ways of specifying bad regions, e.g. by providing a separate mask. This program is only concerned with the regions specified using "bad_" in the geometry file.
Specify the values to use in the mask for good and bad pixels, respectively. The defaults are --good-pixel=1 and --bad-pixel=0.
-o output.h5
Set the output filename. The default is --output=pixelmap.h5.


This page was written by Thomas White.

Reporting bugs

Report bugs to

Copyright and Disclaimer

Copyright © 2015-2020 Deutsches Elektronen-Synchrotron DESY, a research centre of the Helmholtz Association.

Please read the AUTHORS file in the CrystFEL source code distribution for a full list of contributions and contributors.

CrystFEL is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

CrystFEL is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with CrystFEL. If not, see

See also

crystfel crystfel_geometry

If CrystFEL is installed on your computer, you can read this manual page offline using the command man list_events.