1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
Eiger2CBF
=========
Purpose
-------
Convert a multiframe HDF5 Eiger data file into several CBF files.
Portable image converter based on FabIO library to export Eiger frames (``lima`` or ``eiger``)
to CBF which mimic the header of a Dectris Pilatus detector.
Usage:
------
eiger2cbf [-h] [-V] [-v] [--debug] [-o OUTPUT] [-m MASK] [-O OFFSET] [-D DUMMY] [--pilatus] [--dry-run] [-e ENERGY]
[-w WAVELENGTH] [-d DISTANCE] [-b BEAM BEAM] [--alpha ALPHA] [--kappa KAPPA] [--chi CHI] [--phi PHI]
[--omega OMEGA] [--rotation ROTATION] [--transpose] [--flip-ud] [--flip-lr]
[IMAGE ...]
Positional arguments:
+++++++++++++++++++++
IMAGE
File with input images
Options:
++++++++
**-h**, **--help**
show this help message and exit
**-V**, **--version**
output version and exit
**-v**, **--verbose**
show information for each conversions
**--debug**
show debug information
Main arguments:
+++++++++++++++
**-o** OUTPUT, **--output** OUTPUT
output directory and filename template:
``eiger2cbf/frame_{index:04d}.cbf``
**-m** MASK, **--mask** MASK
Read masked pixel from this file
**-O** OFFSET, **--offset** OFFSET
index offset, CrysalisPro likes indexes to start at 1,
Python starts at 0 (default)
**-D** DUMMY, **--dummy** DUMMY
Set masked values to this dummy value
**--pilatus**
Select an image shape similar to Pilatus detectors for compatibiliy
with Crysalis
Optional behaviour arguments:
+++++++++++++++++++++++++++++
**--dry-run**
do everything except modifying the file system
Experimental setup options:
+++++++++++++++++++++++++++
**-e** ENERGY, **--energy** ENERGY
Energy of the incident beam in keV
**-w** WAVELENGTH, **--wavelength** WAVELENGTH
Wavelength of the incident beam in Angstrom
**-d** DISTANCE, **--distance** DISTANCE
Detector distance in meters
**-b** BEAM BEAM, **--beam** BEAM BEAM
Direct beam in pixels x, y
Goniometer setup:
-----------------
**--alpha** ALPHA
Goniometer angle alpha value in deg.
Constant, angle between kappa and omega.
**--kappa** KAPPA
Goniometer angle kappa value in degrees or formula f(index)
``-80 + 2*index``
**--chi** CHI
Goniometer angle chi value in degres or formula f(index)
**--phi** PHI
Goniometer angle phi value (inner-most rotation) in degrees or formula f(index)
``-180+0.7*index``
**--omega** OMEGA
Goniometer angle omega value (outer-most rotation) in degrees or formula f(index)
``-180+0.5*index``
Image preprocessing:
++++++++++++++++++++
Images are patched onto the center of a square frame, and transformation are applied in this order:
**--rotation** ROTATION
Rotate the initial image by this value in degrees. Must be a multiple
of 90 degrees.
**--transpose**
Flip the x/y axis
**--flip-ud**
Flip the image upside-down
**--flip-lr**
Flip the image left-right
Return code:
++++++++++++
- 0 means a success.
- 1 means the conversion contains a failure,
- 2 means there was an error in the arguments
Nota:
-----
Images are made square, so the beam center found in the CBF-files differs from the one entered.
.. command-output:: eiger2cbf --help
:nostderr:
|
