list_events: generate event lists


list_events -i files.lst -o events.lst -g geometry.geom
list_events --help


list_events expands a list of filenames, where each file contains events in a multi-event format (e.g. the CXI format,, into a list of individual events. This might be useful if you need to sort or filter the event list prior to processing, rather than just processing all events.


-i filename
Read the list of input filenames from filename
-g filename
Read the data layout (and detector geometry) from filename.
-o filename
Write the list of events to filename.


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 indexamajig crystfel_geometry

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