Freac: edf-to-esperanto converter for the ID11 beamline ============================================================== .. toctree:: :maxdepth: 2 :caption: Contents: Information and requirements --------------------------------- | Freac is an open source program written in Python and C which converts ID11 EDF images into the packed ESPERANTO format accepted by Crysalis. It automatically recalculates all the needed angles into the :ref:`κ-geometry convention `. | The source code is is covered by the GPLv3 license and freely available at the mercurial repository: `https://hg.3lp.cx/id11tb `_. .. image:: /images/freac.png Download ---------------- The latest version ^^^^^^^^^^^^^^^^^^^^^ The latest version is 2018.6.5. :download:`All-in-one Windows x64 executable: freac.exe` | To run the compiled versions in Windows you may need to install the | `MS Visual C++ Redistributable for Visual Studio 2015 `_. Older versions ^^^^^^^^^^^^^^^^^^ * 2017.1.19 * :download:`All-in-one Windows x64 executable: freac.exe` Installation -------------------- If you have installed Python 3.4+ on your computer, you may install Freac just using pip:: pip install freac Beforehand you need to install PyQt5:: pip install PyQt5 | On Windows you may need the `MS Visual C++ Build Tools 2015 `_ to compile the C-extensions. Documentation ---------------- Parameter description ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ * Base dir is a directory where you have a set of multirun EDF frames. Every set is processed separately. * | Flood, spline and dark files. All of them are very much recommended, especially the spline file. Ask your local contact for them. * λ in Å, you should know that. * | φ. This option relies on the EDF header key 'hphi'. If there is no such key in the header, then φ is considered 0°. Leave the field empty if you want to process all the measured φ angles. If you are going to process just some angles, say 90° and 270° out of 0°, 90°, 180°, 270°, then put in the field 90 270 (the numbers should be space-separated). * κ = -60° if you use φ-axis in EH1. Otherwise κ = 0° (:ref:`see angle correspondence `). * | ω\ :sub:`0`\ and Δω. If you have Omega and OmegaStep keys in the EDF header, you do not need to worry about these parameters, just switch them off. If you do not have proper headers, you should specify these parameters yourself. * Pixel size of the detector in meters, it must be precise. * Sample-to-detector distance in meters, there is no need to make it precise, you will refine it in Crysalis. * x\ :sub:`0`\ and y\ :sub:`0`\ are the beam center, there is no need in precision. .. _angles: Angle correspondence and κ-geometry convention ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ * κ or χ * ID11 EH1 with φ-axis: χ\ :sub:`ID11`\ ∝ κ\ :sub:`Crysalis`\ = -60° * ID11 EH1 without φ-axis and EH3: κ = 0° * ω\ :sub:`Crysalis`\ = -ω\ :sub:`ID11`\ - 160°. * φ\ :sub:`Crysalis`\ = φ\ :sub:`ID11`\ . Change log ----------------- * 2018.6.5 * Minor bug fixes concerning omega step not equal to 1 degree;