quantumkleinmassscan2d.h

Go to the documentation of this file.

/**
 * @file quantumkleinmassscan2d.h
 * @brief Declares the quantumkleinmassscan2d physics/numerical component used by QPE experiments.
 * @ingroup qpe_quantum
 *
 * Source: @c core/quantum/quantumkleinmassscan2d.h. This file is part of Quantum Phenomena Explorer (QPE),
 * maintained by Officina Turini. See LICENSE_IT.txt / LICENSE.txt for the
 * QPE freeware source-available terms and THIRD_PARTY_NOTICES.txt for
 * third-party components.
 */
 
#pragma once
 
#include "core/quantum/quantumkleintunneling2d.h"
 
#include <vector>
 
namespace qpe {
 
/**
 * @brief Data structure used by the Quantum Klein Mass Point2D component.
 *
 * The structure keeps related values explicit and testable across the QPE physics, analysis, or persistence layers.
 */
struct QuantumKleinMassPoint2D
{
    bool valid = false;
    double restMass = 0.0;
    double restEnergy = 0.0;
    double gapEnergy = 0.0;
    double momentumMagnitude = 0.0;
    double transmission = 0.0;
    double reflection = 0.0;
    double interiorLongitudinalMomentumSquared = 0.0;
    QuantumKleinBarrierRegime2D regime = QuantumKleinBarrierRegime2D::EvanescentGap;
};
 
/**
 * @brief Data record containing Quantum Klein Mass Scan2D Result.
 *
 * The structure carries computed data without coupling the numerical component to the GUI or renderer.
 */
struct QuantumKleinMassScan2DResult
{
    bool valid = false;
    double hbar = 1.0;
    double fixedIncidentEnergy = 0.0;
    double incidenceAngleDegrees = 0.0;
    double barrierHeight = 0.0;
    double barrierWidth = 0.0;
    double minimumRestMass = 0.005;
    double maximumRestMass = 1.4;
    double normalIncidenceRegimeThresholdMass = 0.0;
    double kinematicMassLimit = 0.0;
    std::vector<QuantumKleinMassPoint2D> points;
};
 
// Stationary plane-wave reference T(m) for the same two-component Dirac
// square barrier used by QuantumKleinTunneling2D. The incident TOTAL energy
// and angle are held fixed while the rest mass changes; |p| is adjusted so
// sqrt((c|p|)^2 + (mc^2)^2) remains constant. This isolates the opening of
// the relativistic gap from the trivial effect of changing incident energy.
/**
 * @brief Implements the Quantum Klein Mass Scan2D component.
 *
 * The class provides one focused service within the QPE architecture and is documented here independently of the experiment-level Help.
 */
class QuantumKleinMassScan2D
{
public:
    /**
     * @brief Performs evaluate.
     * @param baseConfig Configuration values used by the operation.
     * @param restMass The rest mass value used by the operation.
     * @param hbar The hbar value used by the operation.
     */
    static QuantumKleinMassPoint2D evaluate(const QuantumKleinTunneling2DConfig &baseConfig,
                                             double restMass,
                                             double hbar = 1.0) noexcept;
 
    /**
     * @brief Performs scan.
     * @param baseConfig Configuration values used by the operation.
     * @param minimumRestMass The minimum rest mass value used by the operation.
     * @param maximumRestMass The maximum rest mass value used by the operation.
     * @param samples The samples value used by the operation.
     * @param hbar The hbar value used by the operation.
     */
    static QuantumKleinMassScan2DResult scan(const QuantumKleinTunneling2DConfig &baseConfig,
                                              double minimumRestMass = 0.005,
                                              double maximumRestMass = 1.4,
                                              int samples = 181,
                                              double hbar = 1.0) noexcept;
};
 
} // namespace qpe