sop_class_registry.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_CLASS_REGISTRY_HPP
#define PACS_SERVICES_SOP_CLASS_REGISTRY_HPP
 
#include <functional>
#include <optional>
#include <string>
#include <string_view>
#include <unordered_map>
#include <vector>
 
namespace kcenon::pacs::services {
 
// =============================================================================
// SOP Class Categories
// =============================================================================
 
enum class sop_class_category {
    storage,              
    query_retrieve,       
    worklist,             
    mpps,                 
    storage_commitment,   
    ups,                  
    verification,         
    print,                
    media,                
    other                 
};
 
enum class modality_type {
    ct,         
    mr,         
    us,         
    xa,         
    xrf,        
    cr,         
    dx,         
    mg,         
    nm,         
    pet,        
    rt,         
    sc,         
    sr,         
    seg,        
    sm,         
    op,         
    pmap,       
    other       
};
 
// =============================================================================
// SOP Class Information
// =============================================================================
 
struct sop_class_info {
    std::string_view uid;               
    std::string_view name;              
    sop_class_category category;        
    modality_type modality;             
    bool is_retired;                    
    bool supports_multiframe;           
};
 
// =============================================================================
// SOP Class Registry
// =============================================================================
 
class sop_class_registry {
public:
    [[nodiscard]] static sop_class_registry& instance();
 
    [[nodiscard]] bool is_supported(std::string_view uid) const;
 
    [[nodiscard]] const sop_class_info* get_info(std::string_view uid) const;
 
    [[nodiscard]] std::vector<std::string>
    get_by_category(sop_class_category category) const;
 
    [[nodiscard]] std::vector<std::string>
    get_by_modality(modality_type modality, bool include_retired = true) const;
 
    [[nodiscard]] std::vector<std::string>
    get_all_storage_classes(bool include_retired = true) const;
 
    [[nodiscard]] std::vector<std::string> get_all() const;
 
    bool register_sop_class(const sop_class_info& info);
 
    [[nodiscard]] static std::string_view
    modality_to_string(modality_type modality) noexcept;
 
    [[nodiscard]] static modality_type
    parse_modality(std::string_view modality) noexcept;
 
private:
    sop_class_registry();
    ~sop_class_registry() = default;
 
    // Non-copyable, non-movable singleton
    sop_class_registry(const sop_class_registry&) = delete;
    sop_class_registry& operator=(const sop_class_registry&) = delete;
    sop_class_registry(sop_class_registry&&) = delete;
    sop_class_registry& operator=(sop_class_registry&&) = delete;
 
    void register_standard_sop_classes();
    void register_us_sop_classes();
    void register_xa_sop_classes();
    void register_dx_sop_classes();
    void register_ct_sop_classes();
    void register_mr_sop_classes();
    void register_pet_sop_classes();
    void register_nm_sop_classes();
    void register_rt_sop_classes();
    void register_seg_sop_classes();
    void register_sr_sop_classes();
    void register_print_sop_classes();
    void register_ups_sop_classes();
    void register_wsi_sop_classes();
    void register_ophthalmic_sop_classes();
    void register_parametric_map_sop_classes();
    void register_waveform_sop_classes();
    void register_other_sop_classes();
 
    std::unordered_map<std::string, sop_class_info> registry_;
};
 
// =============================================================================
// Convenience Functions
// =============================================================================
 
[[nodiscard]] bool is_storage_sop_class(std::string_view uid);
 
[[nodiscard]] modality_type get_storage_modality(std::string_view uid);
 
[[nodiscard]] std::string_view get_sop_class_name(std::string_view uid);
 
}  // namespace kcenon::pacs::services
 
#endif  // PACS_SERVICES_SOP_CLASS_REGISTRY_HPP