aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorThomas White <taw@physics.org>2015-02-09 17:13:40 +0100
committerThomas White <taw@physics.org>2015-02-09 17:13:40 +0100
commitfaa45cdf126772d75dae76f73533b129ea3ff4bc (patch)
tree2756b1c1b81000e99993310c2ee6c66bdc0563b0
parent9bc8da473b500284f14f4dc8b3107cc6f6b8ad7c (diff)
whirligig: Update docs and options
-rw-r--r--doc/man/whirligig.154
-rw-r--r--src/whirligig.c10
2 files changed, 57 insertions, 7 deletions
diff --git a/doc/man/whirligig.1 b/doc/man/whirligig.1
new file mode 100644
index 00000000..e213a007
--- /dev/null
+++ b/doc/man/whirligig.1
@@ -0,0 +1,54 @@
+.\"
+.\" whirligig man page
+.\"
+.\" Copyright © 2015 Deutsches Elektronen-Synchrotron DESY,
+.\" a research centre of the Helmholtz Association.
+.\"
+.\" Part of CrystFEL - crystallography with a FEL
+.\"
+
+.TH WHIRLIGIG 1
+.SH NAME
+whirligig \- find rotation series
+.SH SYNOPSIS
+.PP
+\fBwhirligig \fR[\fIoptions\fR] \fIinput.stream
+.PP
+\fBwhirligig --help\fI
+
+.SH DESCRIPTION
+\fBwhirligig\fR takes a stream containing indexing results (e.g. from a previous run of \fBindexamajig\fR) and searches for runs of crystals in adjacent frames which have similar orientations and unit cell parameters. For each series found, a log file will be output with a filename in the form \fBseries-XX.log\fR, where \fBXX\fR is a number starting from zero, which contains the filenames, event IDs and crystal numbers for the frames concerned.
+.PP
+The program takes into account that the frames may not appear in the stream in chronological order (due, for example, to the use of \fBindexamajig -j\fR), and also that there may be multiple crystals per frame.
+
+.SH OPTIONS
+
+.IP \fB--output-dir=\fIfoldername\fR
+.PD
+Put the output log files in \fIfoldername\fR, instead of the working directory. The folder must exist before running \fBwhirligig\fR.
+
+.IP \fB--window-size=\fIn\fR
+.PD
+Set the size of the history buffer to \fIn\fR. The further apart adjacent frames can be in the input stream, for example the higher a number of parallel processes were used during indexing (see \fBindexamajig -j\fR), the larger the history buffer needs to be. \fBwhirligig\fR will print a warning if it seems the window is too small. Increasing the window size increases the amount of computation and memory required. The default is \fB--window-size=16\fR.
+
+.SH AUTHOR
+This page was written by Thomas White.
+
+.SH REPORTING BUGS
+Report bugs to <taw@physics.org>, or visit <http://www.desy.de/~twhite/crystfel>.
+
+.SH COPYRIGHT AND DISCLAIMER
+Copyright © 2015 Deutsches Elektronen-Synchrotron DESY, a research centre of the Helmholtz Association.
+.P
+whirligig, and this manual, are part of CrystFEL.
+.P
+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.
+.P
+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.
+.P
+You should have received a copy of the GNU General Public License along with CrystFEL. If not, see <http://www.gnu.org/licenses/>.
+
+.SH SEE ALSO
+.BR crystfel (7),
+.BR indexamajig (1),
+.BR crystfel_geometry (5)
diff --git a/src/whirligig.c b/src/whirligig.c
index 550404ef..b774f397 100644
--- a/src/whirligig.c
+++ b/src/whirligig.c
@@ -669,7 +669,9 @@ static void show_help(const char *s)
"\n"
" -h, --help Display this help message.\n"
" --version Print CrystFEL version number and exit.\n"
-" --no-polarisation Disable polarisation correction.\n");
+"\n"
+" --window-size=n History size for finding connected crystals.\n"
+" --output-dir=folder Put output files in <folder>.\n");
}
@@ -697,7 +699,6 @@ int main(int argc, char *argv[])
int n_images = 0;
/* Defaults */
- int polarisation = 1;
int default_window_size = 16;
char *outdir = ".";
int verbose = 0;
@@ -712,11 +713,6 @@ int main(int argc, char *argv[])
{"window-size", 1, NULL, 4 },
{"output-dir", 1, NULL, 5 },
- {"no-polarisation", 0, &polarisation, 0},
- {"no-polarization", 0, &polarisation, 0},
- {"polarisation", 0, &polarisation, 1}, /* compat */
- {"polarization", 0, &polarisation, 1}, /* compat */
-
{0, 0, NULL, 0}
};