xa_storage.h

Go to the documentation of this file.

// BSD 3-Clause License
// Copyright (c) 2021-2025, 🍀☀🌕🌥 🌊
// See the LICENSE file in the project root for full license information.
 
#ifndef PACS_SERVICES_SOP_CLASSES_XA_STORAGE_HPP
#define PACS_SERVICES_SOP_CLASSES_XA_STORAGE_HPP
 
#include <array>
#include <cstdint>
#include <string>
#include <string_view>
#include <vector>
 
namespace kcenon::pacs::services::sop_classes {
 
// =============================================================================
// X-Ray Angiographic Storage SOP Class UIDs
// =============================================================================
 
 
inline constexpr std::string_view xa_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.12.1";
 
inline constexpr std::string_view enhanced_xa_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.12.1.1";
 
inline constexpr std::string_view xrf_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.12.2";
 
 
 
inline constexpr std::string_view xray_3d_angiographic_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.13.1.1";
 
inline constexpr std::string_view xray_3d_craniofacial_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.13.1.2";
 
 
// =============================================================================
// XA-Specific Transfer Syntaxes
// =============================================================================
 
[[nodiscard]] std::vector<std::string> get_xa_transfer_syntaxes();
 
// =============================================================================
// XA Photometric Interpretations
// =============================================================================
 
enum class xa_photometric_interpretation {
    monochrome1,    
    monochrome2     
};
 
[[nodiscard]] std::string_view to_string(xa_photometric_interpretation interp) noexcept;
 
[[nodiscard]] xa_photometric_interpretation
parse_xa_photometric_interpretation(std::string_view value) noexcept;
 
[[nodiscard]] bool is_valid_xa_photometric(std::string_view value) noexcept;
 
// =============================================================================
// XA SOP Class Information
// =============================================================================
 
struct xa_sop_class_info {
    std::string_view uid;           
    std::string_view name;          
    std::string_view description;   
    bool is_enhanced;               
    bool is_3d;                     
    bool supports_multiframe;       
};
 
[[nodiscard]] std::vector<std::string>
get_xa_storage_sop_classes(bool include_3d = true);
 
[[nodiscard]] const xa_sop_class_info*
get_xa_sop_class_info(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_xa_storage_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_xa_multiframe_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_enhanced_xa_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_xa_3d_sop_class(std::string_view uid) noexcept;
 
// =============================================================================
// XA Positioner Information
// =============================================================================
 
enum class xa_positioner_motion {
    stationary,     
    dynamic         
};
 
[[nodiscard]] std::string_view to_string(xa_positioner_motion motion) noexcept;
 
struct xa_positioner_angles {
    double primary_angle;       
    double secondary_angle;     
 
    [[nodiscard]] bool is_valid() const noexcept;
};
 
// =============================================================================
// XA Frame Information
// =============================================================================
 
enum class xa_frame_rate : uint16_t {
    fps_7_5 = 8,      
    fps_15 = 15,      
    fps_30 = 30       
};
 
[[nodiscard]] constexpr uint16_t get_default_xa_cine_rate() noexcept {
    return 15;
}
 
[[nodiscard]] constexpr size_t get_max_xa_frame_count() noexcept {
    return 2000;  // Typical max for long cardiac runs
}
 
// =============================================================================
// XA Calibration Information
// =============================================================================
 
struct xa_calibration_data {
    double imager_pixel_spacing[2];     
    double distance_source_to_detector; 
    double distance_source_to_patient;  
 
    [[nodiscard]] double magnification_factor() const noexcept;
 
    [[nodiscard]] double isocenter_pixel_spacing() const noexcept;
 
    [[nodiscard]] bool is_valid() const noexcept;
};
 
}  // namespace kcenon::pacs::services::sop_classes
 
#endif  // PACS_SERVICES_SOP_CLASSES_XA_STORAGE_HPP