pet_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_PET_STORAGE_HPP
#define PACS_SERVICES_SOP_CLASSES_PET_STORAGE_HPP
 
#include <array>
#include <cstdint>
#include <string>
#include <string_view>
#include <vector>
 
namespace kcenon::pacs::services::sop_classes {
 
// =============================================================================
// PET Storage SOP Class UIDs
// =============================================================================
 
 
inline constexpr std::string_view pet_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.128";
 
inline constexpr std::string_view enhanced_pet_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.130";
 
inline constexpr std::string_view legacy_converted_enhanced_pet_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.128.1";
 
 
// =============================================================================
// PET-Specific Transfer Syntaxes
// =============================================================================
 
[[nodiscard]] std::vector<std::string> get_pet_transfer_syntaxes();
 
// =============================================================================
// PET Photometric Interpretations
// =============================================================================
 
enum class pet_photometric_interpretation {
    monochrome2     
};
 
[[nodiscard]] std::string_view to_string(pet_photometric_interpretation interp) noexcept;
 
[[nodiscard]] pet_photometric_interpretation
parse_pet_photometric_interpretation(std::string_view value) noexcept;
 
[[nodiscard]] bool is_valid_pet_photometric(std::string_view value) noexcept;
 
// =============================================================================
// PET SOP Class Information
// =============================================================================
 
struct pet_sop_class_info {
    std::string_view uid;           
    std::string_view name;          
    std::string_view description;   
    bool is_retired;                
    bool supports_multiframe;       
    bool is_enhanced;               
};
 
[[nodiscard]] std::vector<std::string>
get_pet_storage_sop_classes(bool include_retired = true);
 
[[nodiscard]] const pet_sop_class_info*
get_pet_sop_class_info(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_pet_storage_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_enhanced_pet_sop_class(std::string_view uid) noexcept;
 
// =============================================================================
// PET Image Type Codes
// =============================================================================
 
enum class pet_image_type {
    original,           
    derived,            
    primary,            
    secondary           
};
 
enum class pet_series_type {
    static_image,       
    dynamic,            
    gated,              
    whole_body          
};
 
enum class pet_attenuation_correction {
    none,               
    measured,           
    calculated,         
    ct_based            
};
 
enum class pet_scatter_correction {
    none,               
    single_scatter,     
    convolution,        
    model_based         
};
 
enum class pet_reconstruction_type {
    fbp,                
    osem,               
    mlem,               
    tof_osem,           
    psf_osem,           
    other               
};
 
[[nodiscard]] std::string_view to_string(pet_reconstruction_type recon) noexcept;
 
[[nodiscard]] pet_reconstruction_type
parse_pet_reconstruction_type(std::string_view value) noexcept;
 
// =============================================================================
// PET Units and SUV Calculation
// =============================================================================
 
enum class pet_units {
    cnts,               
    bqml,               
    gml,                
    suv_bw,             
    suv_lbm,            
    suv_bsa,            
    percent_id_gram,    
    other               
};
 
[[nodiscard]] std::string_view to_string(pet_units units) noexcept;
 
[[nodiscard]] pet_units parse_pet_units(std::string_view value) noexcept;
 
// =============================================================================
// PET Radiopharmaceutical Information
// =============================================================================
 
enum class pet_radiotracer {
    fdg,                
    naf,                
    flt,                
    fdopa,              
    ammonia,            
    rubidium,           
    gallium_dotatate,   
    psma,               
    other               
};
 
[[nodiscard]] std::string_view to_string(pet_radiotracer tracer) noexcept;
 
}  // namespace kcenon::pacs::services::sop_classes
 
#endif  // PACS_SERVICES_SOP_CLASSES_PET_STORAGE_HPP