mg_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_MG_STORAGE_HPP
#define PACS_SERVICES_SOP_CLASSES_MG_STORAGE_HPP
 
#include <array>
#include <cstdint>
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
namespace kcenon::pacs::services::sop_classes {
 
// =============================================================================
// Digital Mammography Storage SOP Class UIDs (re-exported from dx_storage.hpp)
// =============================================================================
 
 
inline constexpr std::string_view mg_image_storage_for_presentation_uid =
    "1.2.840.10008.5.1.4.1.1.1.2";
 
inline constexpr std::string_view mg_image_storage_for_processing_uid =
    "1.2.840.10008.5.1.4.1.1.1.2.1";
 
inline constexpr std::string_view breast_tomosynthesis_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.13.1.3";
 
inline constexpr std::string_view breast_projection_image_storage_for_presentation_uid =
    "1.2.840.10008.5.1.4.1.1.13.1.4";
 
inline constexpr std::string_view breast_projection_image_storage_for_processing_uid =
    "1.2.840.10008.5.1.4.1.1.13.1.5";
 
 
// =============================================================================
// Breast Laterality
// =============================================================================
 
enum class breast_laterality {
    left,       
    right,      
    bilateral,  
    unknown     
};
 
[[nodiscard]] std::string_view to_string(breast_laterality laterality) noexcept;
 
[[nodiscard]] breast_laterality parse_breast_laterality(std::string_view value) noexcept;
 
[[nodiscard]] bool is_valid_breast_laterality(std::string_view value) noexcept;
 
// =============================================================================
// Mammography View Position
// =============================================================================
 
enum class mg_view_position {
    // Standard screening views
    cc,         
    mlo,        
 
    // Additional diagnostic views
    ml,         
    lm,         
    xccl,       
    xccm,       
    fb,         
    sio,        
    iso,        
    cv,         
    at,         
 
    // Spot/magnification views
    spot,       
    mag,        
    spot_mag,   
    rl,         
    rm,         
    rs,         
    ri,         
 
    // Specialized views
    tangen,     
    implant,    
    id,         
 
    // Other
    other       
};
 
[[nodiscard]] std::string_view to_string(mg_view_position position) noexcept;
 
[[nodiscard]] mg_view_position parse_mg_view_position(std::string_view value) noexcept;
 
[[nodiscard]] bool is_screening_view(mg_view_position position) noexcept;
 
[[nodiscard]] bool is_magnification_view(mg_view_position position) noexcept;
 
[[nodiscard]] bool is_spot_compression_view(mg_view_position position) noexcept;
 
[[nodiscard]] std::vector<std::string_view> get_valid_mg_view_positions() noexcept;
 
// =============================================================================
// Mammography Image Acquisition Parameters
// =============================================================================
 
struct mg_acquisition_params {
    std::optional<double> compression_force_n;
 
    std::optional<double> compressed_breast_thickness_mm;
 
    std::optional<double> relative_x_ray_exposure;
 
    std::optional<double> entrance_dose_dgy;
 
    std::optional<std::string> entrance_dose_derivation;
 
    std::optional<double> organ_dose_dgy;
 
    std::optional<double> half_value_layer_mm;
 
    std::optional<double> kvp;
 
    std::optional<double> exposure_time_ms;
 
    std::optional<double> tube_current_ma;
 
    std::optional<double> exposure_mas;
 
    std::optional<std::string> anode_target_material;
 
    std::optional<std::string> filter_material;
 
    std::optional<double> filter_thickness_mm;
 
    std::optional<double> focal_spot_mm;
 
    std::optional<bool> breast_implant_present;
 
    std::optional<bool> partial_view;
 
    std::optional<std::string> partial_view_description;
};
 
[[nodiscard]] bool is_valid_compression_force(double force_n) noexcept;
 
[[nodiscard]] std::pair<double, double> get_typical_compression_force_range() noexcept;
 
[[nodiscard]] bool is_valid_compressed_breast_thickness(double thickness_mm) noexcept;
 
// =============================================================================
// Mammography Image Type
// =============================================================================
 
enum class mg_image_type {
    for_presentation,   
    for_processing      
};
 
[[nodiscard]] std::string_view to_string(mg_image_type type) noexcept;
 
// =============================================================================
// Mammography CAD Integration
// =============================================================================
 
enum class cad_processing_status {
    not_processed,          
    processed_no_findings,  
    processed_findings,     
    processing_failed,      
    pending                 
};
 
[[nodiscard]] std::string_view to_string(cad_processing_status status) noexcept;
 
// =============================================================================
// Mammography SOP Class Information
// =============================================================================
 
struct mg_sop_class_info {
    std::string_view uid;           
    std::string_view name;          
    std::string_view description;   
    mg_image_type image_type;       
    bool is_tomosynthesis;          
    bool supports_multiframe;       
};
 
[[nodiscard]] std::vector<std::string>
get_mg_storage_sop_classes(bool include_tomosynthesis = true);
 
[[nodiscard]] const mg_sop_class_info*
get_mg_sop_class_info(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_mg_storage_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_breast_tomosynthesis_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_mg_for_processing_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_mg_for_presentation_sop_class(std::string_view uid) noexcept;
 
// =============================================================================
// Transfer Syntax Recommendations
// =============================================================================
 
[[nodiscard]] std::vector<std::string> get_mg_transfer_syntaxes();
 
// =============================================================================
// Utility Functions
// =============================================================================
 
[[nodiscard]] bool is_valid_laterality_view_combination(
    breast_laterality laterality,
    mg_view_position view) noexcept;
 
[[nodiscard]] std::vector<std::pair<breast_laterality, mg_view_position>>
get_standard_screening_views() noexcept;
 
[[nodiscard]] std::string create_mg_image_type(
    bool is_original,
    bool is_primary,
    mg_image_type type);
 
}  // namespace kcenon::pacs::services::sop_classes
 
#endif  // PACS_SERVICES_SOP_CLASSES_MG_STORAGE_HPP