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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
|
# -*- org -*-
* 5.1.4 2026-01-20
** Build system
- It is now possible to gives a CABALFLAGS on the command line.
The haskell code was instrumented to support a new option
useThreaded. This options is activated by default, but some
architecture do not supporte threading, so in order to allow
build and test on these architectures, is is possible to call
configure like this.
./configure CABALFLAGS="-f -useThreaded"
- remove old ICA files, used by the old maven build system.
** Binoculars (C-library)
- Added support for double images.
- Added the `hkl_binoculars_detectors_2d_img_load` in order to
load rigaku img files. For now only uint16_t images.
- Added the Rigaku XSPA 1M detector (RigakuXspa1M).
- fixed the polarisation correction.
- switch the photons array to float in order to deal with small corrections. (polarisation)
- limit the stereo projection to the north pole.
** Binoculars-ng (Haskell program)
- dispatcher.ncores = 0 mean: use all capabilities of the CPU hardware.
The default remains equal to `4` if this property is not defined.
- Projections
- 'q_thetax_phix' -> latitude and longitude of q with qx as reference.
- 'q_thetay_phiy' -> latitude and longitude of q with qy as reference.
- 'q_thetaz_phiz' -> latitude and longitude of q with qz as reference.
- DataSource
- better error message when we do not find the data's. It display
the faulty DataSourcePaths.
- When opening a datafile, display the real DataSource of the DataFrame.
- DataSource Image
- support for double image from hdf5 files.
- Added a constructor in order to read the Rigaku images.
`DataSourcePath'Image'Img (Detector Hkl DIM2) (DataSourcePath Attenuation) Text Scannumber`
- Added a new constructor for dummy images.
DataSourcePath'Image'Dummy.
this is usefull if you want to obtain a cube with the intensity
corrections (polarisation) . Just set all the image pixels
values to 1.0 and voilà.
** Documentation
- Updated thanks to Didier Weirmeille from the ESRF
** Hkl3D (Anticollision)
- switch from the g3d un-maintained library to assimp in order to
read model files.
- full rewrite of the configure file parser. (it should be more
robust now).
** Gui
- migrated from gtk3 to gtk4.
** Tests
- binoculars-ng detectors tests are using sha256 in order to check
mask and coordinates integrity. If you change a detector
definition you need to update the sha256 fingerprint in the
hkl-binoculars_t.c file.
example of a failure:
detector 9 fingerpring: 5c747478f67ad54485bc3502c825bff41c0934c94a0160179909c483d75f541a , expected: 49885be2c9cfea697b8f6a6e0c00f9dec687760a8b4cfdb4eda94af1014322ce
not ok 3 - mask_get
* 5.1.3 2025-01-15
** Lib binoculars
- it is now possible to mask a ring of n pixels around each module.
Most of the times these pixel's statistics are bad.
** Binoculars-ng
- Added float64 support for masks
- It is possible to define a fall back for mask location with this
syntax. `my_first_mask.npy | my_second_mask.npy`
* 5.1.0 2024-10-15
** General
- 5.x runtime can be co-installed with the 4.x series.
- hkl.h contain all the Public API.
- A clear separation between the public and private API was
achieved, in order to propose a Long Time Support of the
5.x series.
- c-tap-hardness library was embeded to provide the unit test
framework.
- gobject-instrospection provide the binding support. Look at this
[[https://gi.readthedocs.io/en/latest/][page]] for more informations.
- Documentation was generated with org-mode and asymptote for the figures.
- New diffractometers added
- APS POLAR thanks to Pete R. Jemian <jemian@anl.gov>.
- E4CH (eulerian 4 circles horizontal) geometry.
- MARS beamline (SOLEIL) eulerian 4 circles vertical geometry.
- SOLEIL SIRIUS KAPPA
- SOLEIL SIRIUS TURRET
- New Pseudo Axes engines.
- qper_qpar
- A not yet public hkl3d library used only by the gui allow to
compute (Bullet) and display (OpenGL) collision for model
described using the COLLADA file format.
- all private symbols are now hidden.
** Binoculars-ng
- Added this new program in order to project 2D Detectors images in
the hkl reciprocal space, qxqyqz, etc... It support for now a
bunch of Soleil beamlines experiments (all SIXS geometries, MARS,
CRISTAL and DIFFABS).
- make it compile with ghc 9.6
- Added support for mask per scan.
** Buildsystem
- add a --disable-hkl3d flag to avoid hkl3d library compilation.
- replace the --enable-ghkl with a --disable-gui.
- use ./configure --help for all the options
** Gui
- Rewriten using Gtk instead of Gtkmm, in order to minimise the
required dependencies.
- Added a 3D view to display diffractometers and collisions.
- Added the K6C 3D model.
** Bindings
- Provide the garantie via unit tests that the python API will be
stable during all the 5.x lifetime.
- For other languages look at [[https://gi.readthedocs.io/en/latest/users.html][here]].
* 4.0.4 UNRELEASED
* add the SOLEIL SIXS MED2+2 diffractometer
- engine: hkl
- mode: reflectivity.
- engine: qper_qpar
* add the SOLEIL MARS diffractometer
- engine: qper_qpar
* add the PETRA3 P09 EH2 diffractometer
- engine: qper_qpar
* modified E6C
- engine: qper_qpar
- add modes : hkl psi_constant_horizontal, constant_mu_horizontal
* K6C
- engine hkl:
- add the constant_incidence mode
- engine: qper_qpar
* add the sphinx documentation
* 4.0.3 06-06-2010
* remove the usage.c file to avoid a GPL2-GPL3+ incompatibility
* update the documentation
* fix warning catched by clang
* 4.0.2 01-06-2010
* add the ghkl manpage and .desktop file
* fix the ghkl quit menuitem bugs
* 4.0.1 10-05-2010
* fix a few ghkl bugs (.ui files installation)
* add a --enable-ghkl=[yes,no] flag to allow compiling the gui interface
* do not forgot to link ghkl against gsl.
* display by default the preference panel of ghkl.
* 4.0.0 14-04-2010
* add the autotools buildsystem and remove all other systems.
* add a GUI ghkl for testing purpose based on gtkmm.
* add the GNU info doc
* add the gtk-doc to document the api (work in progress)
* new structure for the HklDetector (prepare for 2D detectors)
* HklGeometryConfig shared between all equivalent HklGeometries.
* fix for 64 bits computers runtime error.
* add the GError class to report calculation errors (not yet used)
* new way to set the UB matrix of a sample (hkl_sample_set_UB).
* new ZAxis geometry
- mode zaxis
- mode reflectivity (mu = gamma)
* 3.0.1 23-10-2009
* add the psi_constant mode to the e4cv, e6c, k4cv and k6c geometries. (thanks teresa)
* upgrade the user guide to explain how to add a mode.
* the horizontal modes are also valid if omega = +-PI. (e6c, k6c)
* remove geometries with an invalid range from the list of solutions.
* 3.0.0 15-07-2009
* Rewrote from scratch in C with the GSL library.
- now most of pseudo axes modes are numeric.
So a 6 circles mode is now a real 6 circles mode.
* Eulerian 4 circles
- PseudoAxisEngine "hkl": "h", "k", "l"
* Mode "bissector"
* Mode "constant_omega"
* Mode "constant_chi"
* Mode "constant_phi"
* Mode "double_diffraction"
- PseudoAxisEngine "psi": "psi"
* Mode "psi"
* Kappa 4 circles
- PseudoAxisEngine "hkl": "h", "k", "l"
* Mode "bissector"
* Mode "constant_omega"
* Mode "constant_chi"
* Mode "constant_phi"
* Mode "double_diffraction"
- PseudoAxisEngine "psi": "psi"
* Mode "psi"
- PseudoAxisEngien "eulerians": "omega", "chi", "phi"
* mode "eulerians"
* Eulerian 6 circles
- PseudoAxisEngine "hkl": "h", "k", "l"
* Mode "bissector_vertical"
* Mode "constant_omega_vertical"
* Mode "constant_chi_vertical"
* Mode "constant_phi_vertical"
* Mode "double_diffraction_vertical"
* Mode "lifting_detector"
* Mode "bissector_horizontal"
* Mode "double_diffraction_horizontal"
- PseudoAxisEngine "psi": "psi"
* Mode "psi"
* Kappa 6 circles
- PseudoAxisEngine "hkl": "h", "k", "l"
* Mode "bissector_vertical"
* Mode "constant_omega_vertical"
* Mode "constant_chi_vertical"
* Mode "constant_phi_vertical"
* Mode "double_diffraction_vertical"
* Mode "lifting_detector"
* Mode "bissector_horizontal"
* Mode "constant_phi_horizontal"
* Mode "constant_kphi_horizontal"
* Mode "double_diffraction_horizontal"
- PseudoAxisEngine "psi": "psi"
* Mode "psi"
- PseudoAxisEngien "eulerians": "omega", "chi", "phi"
* mode "eulerians"
* 2.3.0 24-01-2007
* Refactoring of the sample part.
- It is now possible to create different kind of samples easily.
- MonoCrystal type.
* Diffractometers:
- Eulerian 6 Circles.
- kappa 4 Circles Vertical.
* Refactoring of the PseudoAxe part.
- Derived PseudoAxe can be created from an already existing PseudoAxe if the Geometry conversion exist.
- Better related PseudoAxes (ex Eulerians on a Kappa)
- The PseudoAxe is just a interface, computation is done by the PseudoAxeEngine.
- Eulerian 4 Circles Vertical
- "th2th" : derived from the twoC
- "q2th" : derived from the twoC
- "q" : derived from the twoC
- kappa 4 Circles Vertical
- "omega", "chi", "phi" : eulerian 4 circles Vertical pseudoAxes.
- "th2th" : derived from the twoC
- "q2th" : derived from the twoC
- "q" : derived from the twoC
- "psi" : derived from the Eulerian 4 Circlers Vertical.
- Eulerian 6 Circles:
- "tth" : 2 * theta
- "q" : 2 * tau * sin(theta) / lambda
- "psi" : derived from the Eulerian 4 Circlers Vertical.
- Kappa6C
- "omega", "chi", "phi" : derived from the Kappa 4 Circles Vertical.
- "tth" derived from the Eulerian6C.
- "q" derived from the Eulerian6C.
- "psi" : derived from the Eulerian 4 Circlers Vertical.
* Refactoring of the Modes.
- Derived Mode can be created from an already existing Mode if the Geometry conversion exist.
- all Eulerian 4 Circles on the kappa4C, Eulerian6c and Kappa6C diffractometers.
* 2.2.0 19-06-2006
* Diffractometers:
- twoC Vertical.
- Eulerian 4 Circles Vertical.
- Kappa 6 Circles.
* PseudoAxes
- twoC
- "th2th": omega - 2theta (domega = d2theta / 2)
- "q2th" : omega - 2theta (domega = d2theta / 2) but q2th = 2 tau sin(theta) / lambda
- "q" : 2 * tau * sin(theta) / lambda
- Eulerian 4 Circles Vertical
- "th2th": omega - 2theta (domega = d2theta / 2)
- "q2th" : omega - 2theta (domega = d2theta / 2) but q2th = 2 tau sin(theta) / lambda
- "q" : 2 * tau * sin(theta) / lambda
- "psi" : Rotation of the sample oaround the Q vector.
* Modes
- twoC
- "symetric" (omega = theta, 2theta = 2 * theta)
- "fix incidence" (omega = free, 2theta = 2 * theta)
- Eulerian 4 circles:
- "Bissector"
- "Delta Theta"
- "Constant Omega"
- "Constant Chi"
- 'Constant Phi"
- Kappa6C
- all Eulerian 4 Circles modes.
|
