rt_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_RT_STORAGE_HPP
#define PACS_SERVICES_SOP_CLASSES_RT_STORAGE_HPP
 
#include <array>
#include <cstdint>
#include <string>
#include <string_view>
#include <vector>
 
namespace kcenon::pacs::services::sop_classes {
 
// =============================================================================
// RT Storage SOP Class UIDs
// =============================================================================
 
 
inline constexpr std::string_view rt_plan_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.5";
 
inline constexpr std::string_view rt_dose_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.2";
 
inline constexpr std::string_view rt_structure_set_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.3";
 
inline constexpr std::string_view rt_image_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.1";
 
inline constexpr std::string_view rt_beams_treatment_record_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.4";
 
inline constexpr std::string_view rt_brachy_treatment_record_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.6";
 
inline constexpr std::string_view rt_treatment_summary_record_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.7";
 
inline constexpr std::string_view rt_ion_plan_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.8";
 
inline constexpr std::string_view rt_ion_beams_treatment_record_storage_uid =
    "1.2.840.10008.5.1.4.1.1.481.9";
 
 
// =============================================================================
// RT-Specific Transfer Syntaxes
// =============================================================================
 
[[nodiscard]] std::vector<std::string> get_rt_transfer_syntaxes();
 
// =============================================================================
// RT SOP Class Information
// =============================================================================
 
struct rt_sop_class_info {
    std::string_view uid;           
    std::string_view name;          
    std::string_view description;   
    bool is_retired;                
    bool has_pixel_data;            
};
 
[[nodiscard]] std::vector<std::string>
get_rt_storage_sop_classes(bool include_retired = true);
 
[[nodiscard]] const rt_sop_class_info*
get_rt_sop_class_info(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_rt_storage_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_rt_plan_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool rt_sop_class_has_pixel_data(std::string_view uid) noexcept;
 
// =============================================================================
// RT Plan Type
// =============================================================================
 
enum class rt_plan_intent {
    curative,           
    palliative,         
    prophylactic,       
    verification,       
    machine_qa,         
    research,           
    service             
};
 
[[nodiscard]] std::string_view to_string(rt_plan_intent intent) noexcept;
 
[[nodiscard]] rt_plan_intent parse_rt_plan_intent(std::string_view value) noexcept;
 
enum class rt_plan_geometry {
    patient,            
    treatment_device    
};
 
[[nodiscard]] std::string_view to_string(rt_plan_geometry geometry) noexcept;
 
[[nodiscard]] rt_plan_geometry parse_rt_plan_geometry(std::string_view value) noexcept;
 
// =============================================================================
// RT Dose Type
// =============================================================================
 
enum class rt_dose_type {
    physical,           
    effective,          
    error               
};
 
[[nodiscard]] std::string_view to_string(rt_dose_type type) noexcept;
 
[[nodiscard]] rt_dose_type parse_rt_dose_type(std::string_view value) noexcept;
 
enum class rt_dose_summation_type {
    plan,               
    multi_plan,         
    fraction,           
    beam,               
    brachy,             
    fraction_session,   
    beam_session,       
    brachy_session,     
    control_point,      
    record              
};
 
[[nodiscard]] std::string_view to_string(rt_dose_summation_type type) noexcept;
 
[[nodiscard]] rt_dose_summation_type parse_rt_dose_summation_type(std::string_view value) noexcept;
 
enum class rt_dose_units {
    gy,                 
    relative            
};
 
[[nodiscard]] std::string_view to_string(rt_dose_units units) noexcept;
 
[[nodiscard]] rt_dose_units parse_rt_dose_units(std::string_view value) noexcept;
 
// =============================================================================
// RT Structure Set
// =============================================================================
 
enum class rt_roi_interpreted_type {
    external,           
    ptv,                
    ctv,                
    gtv,                
    organ,              
    avoidance,          
    treated_volume,     
    irrad_volume,       
    bolus,              
    brachy_channel,     
    brachy_accessory,   
    brachy_src_appl,    
    brachy_chnl_shld,   
    support,            
    fixation,           
    dose_region,        
    contrast_agent,     
    cavity,             
    marker,             
    registration,       
    isocenter,          
    control_point       
};
 
[[nodiscard]] std::string_view to_string(rt_roi_interpreted_type type) noexcept;
 
[[nodiscard]] rt_roi_interpreted_type parse_rt_roi_interpreted_type(std::string_view value) noexcept;
 
enum class rt_roi_generation_algorithm {
    automatic,          
    semiautomatic,      
    manual              
};
 
[[nodiscard]] std::string_view to_string(rt_roi_generation_algorithm algorithm) noexcept;
 
[[nodiscard]] rt_roi_generation_algorithm
parse_rt_roi_generation_algorithm(std::string_view value) noexcept;
 
// =============================================================================
// RT Beam Information
// =============================================================================
 
enum class rt_beam_type {
    static_beam,        
    dynamic             
};
 
[[nodiscard]] std::string_view to_string(rt_beam_type type) noexcept;
 
[[nodiscard]] rt_beam_type parse_rt_beam_type(std::string_view value) noexcept;
 
enum class rt_radiation_type {
    photon,             
    electron,           
    neutron,            
    proton,             
    ion                 
};
 
[[nodiscard]] std::string_view to_string(rt_radiation_type type) noexcept;
 
[[nodiscard]] rt_radiation_type parse_rt_radiation_type(std::string_view value) noexcept;
 
enum class rt_treatment_delivery_type {
    treatment,          
    open_portfilm,      
    trmt_portfilm,      
    continuation,       
    setup               
};
 
[[nodiscard]] std::string_view to_string(rt_treatment_delivery_type type) noexcept;
 
[[nodiscard]] rt_treatment_delivery_type
parse_rt_treatment_delivery_type(std::string_view value) noexcept;
 
// =============================================================================
// RT Image Information
// =============================================================================
 
enum class rt_image_plane {
    axial,              
    localizer,          
    drr,                
    portal,             
    fluence             
};
 
[[nodiscard]] std::string_view to_string(rt_image_plane plane) noexcept;
 
[[nodiscard]] rt_image_plane parse_rt_image_plane(std::string_view value) noexcept;
 
}  // namespace kcenon::pacs::services::sop_classes
 
#endif  // PACS_SERVICES_SOP_CLASSES_RT_STORAGE_HPP