Files
Jungfraujoch/common/DiffractionGeometry.h
T
leonarski_fandClaude Opus 4.8 acd2025676 azint: tilt-correct solid-angle correction; honour imported rot3 in refinement
The azimuthal-integration solid-angle correction used cos^3(2*theta), where
2*theta is the true scattering angle (from LabCoord, including detector tilt).
The solid angle of a flat pixel actually depends on the incidence angle to the
detector normal, cos(alpha) = det_distance / |detector-frame position|, which is
invariant under detector tilt (rot1/rot2/rot3). Only for an untilted detector do
the two agree. Switch CalcAzIntSolidAngleCorr(x,y) to the tilt-invariant form,
matching PyFAI solidAngleArray and MAX IV azint. Drop the q-only overload (it can
only ever be the untilted approximation and was used only in tests) and move its
test onto the (x,y) form; add a tilt-invariance test.

XtalOptimizer's residual reconstructed each spot's lab position from rot1/rot2
only, hardcoding rot3 = 0, while the rest of the pipeline (and its own spot
selection) used the full PONI rotation. An imported non-zero rot3 was therefore
silently dropped during refinement. Bake rot3 into the residual as a fixed
Rz(-rot3) so refinement stays consistent (no-op when rot3 == 0).

Polarization and azimuthal binning already honoured rot3 via the full PONI
rotation (Phi_rad), validated against PyFAI chi() by the existing rot3 phi tests.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-11 11:34:11 +02:00

67 lines
2.8 KiB
C++

// SPDX-FileCopyrightText: 2024 Filip Leonarski, Paul Scherrer Institute <filip.leonarski@psi.ch>
// SPDX-License-Identifier: GPL-3.0-only
#pragma once
#include "JFJochException.h"
#include "Coord.h"
#include "GoniometerAxis.h"
class DiffractionGeometry {
float beam_x_pxl = 0.0;
float beam_y_pxl = 0.0;
float det_distance_mm = 100.0;
float pixel_size_mm = 0.075;
float wavelength_A = 1.0;
float poni_rot_1 = 0.0f;
float poni_rot_2 = 0.0f;
float poni_rot_3 = 0.0f;
RotMatrix poni_rot;
std::optional<GoniometerAxis> axis;
void UpdatePoniRotMatrix();
public:
DiffractionGeometry &BeamX_pxl(float input);
DiffractionGeometry &BeamY_pxl(float input);
DiffractionGeometry &DetectorDistance_mm(float input);
DiffractionGeometry &PixelSize_mm(float input);
DiffractionGeometry &Wavelength_A(float input);
DiffractionGeometry &PoniRot1_rad(float input);
DiffractionGeometry &PoniRot2_rad(float input);
DiffractionGeometry &PoniRot3_rad(float input);
DiffractionGeometry &Rotation(const std::optional<GoniometerAxis> &input);
[[nodiscard]] float GetBeamX_pxl() const;
[[nodiscard]] float GetBeamY_pxl() const;
[[nodiscard]] float GetDetectorDistance_mm() const;
[[nodiscard]] float GetPixelSize_mm() const;
[[nodiscard]] float GetWavelength_A() const;
[[nodiscard]] Coord GetScatteringVector() const;
[[nodiscard]] float GetPoniRot1_rad() const;
[[nodiscard]] float GetPoniRot2_rad() const;
[[nodiscard]] float GetPoniRot3_rad() const;
[[nodiscard]] std::pair<float, float> GetDirectBeam_pxl() const;
[[nodiscard]] std::optional<GoniometerAxis> GetRotation() const;
[[nodiscard]] Coord LabCoord(float x, float y) const;
[[nodiscard]] Coord DetectorToRecip(float x, float y) const;
[[nodiscard]] std::pair<float, float> RecipToDetector(const Coord &recip) const;
[[nodiscard]] float TwoTheta_rad(float x, float y) const;
[[nodiscard]] float Phi_rad(float x, float y) const;
[[nodiscard]] float PxlToRes(float x, float y) const;
[[nodiscard]] float PxlToQ(float x, float y) const;
[[nodiscard]] float PxlToRes(float dist_pxl) const;
[[nodiscard]] float ResToPxl(float d_A) const;
[[nodiscard]] Coord ResToPxl(float d_A, float phi) const;
[[nodiscard]] float DistFromEwaldSphere(const Coord& recip) const;
[[nodiscard]] float CalcAzIntSolidAngleCorr(float x, float y) const;
[[nodiscard]] float CalcAzIntPolarizationCorr(float x, float y, float coeff) const;
[[nodiscard]] std::pair<float, float> ResPhiToPxl(float d_A, float phi_rad) const;
[[nodiscard]] Coord ProjectToEwaldSphere(const Coord &p0) const;
// eq. 18 in https://journals.iucr.org/d/issues/2014/08/00/dz5332/index.html
[[nodiscard]] float AngleFromEwaldSphere_deg(const Coord &p0) const;
[[nodiscard]] const RotMatrix& GetPoniRotMatrix() const;
};