Jungfraujoch/common/Reflection.h

// SPDX-FileCopyrightText: 2025 Filip Leonarski, Paul Scherrer Institute <filip.leonarski@psi.ch>
// SPDX-License-Identifier: GPL-3.0-only

#pragma once

#include <cstdint>
#include <optional>
#include <cmath>

#include "SpotToSave.h"

struct Reflection {
    int32_t h;
    int32_t k;
    int32_t l;
    float image_number; // Can be in-between for 3D integration
    float delta_phi_deg; // phi angle from XDS - difference from middle of current frame (NOT an absolute angle)
    float predicted_x;
    float predicted_y;
    float observed_x;
    float observed_y;
    float d;
    float I;
    float bkg;
    float sigma;
    float dist_ewald;
    float rlp;
    float partiality;     // fraction of the reflection recorded in the sampled (rocking) slice
    float completeness = 1.0f; // fraction of the spot footprint on live pixels (1 = not clipped by edge/gap/mask)
    float zeta;
    float image_scale_corr; // I_true = scaling_correction * I; scaling_correction = rlp / (partiality * image_scale)
    bool observed = false;
    bool on_ice_ring = false; // sits on a hexagonal-ice powder ring: excluded from scaling, kept for merging
};

struct MergedReflection {
    int32_t h = 0;
    int32_t k = 0;
    int32_t l = 0;
    float I = NAN;
    float sigma = NAN;
    float I_half[2] = {NAN, NAN};
    float sigma_half[2] = {NAN, NAN};
    float d = 0.0;
    bool rfree_flag = false;
};