seg_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_SEG_STORAGE_HPP
#define PACS_SERVICES_SOP_CLASSES_SEG_STORAGE_HPP
 
#include <array>
#include <cstdint>
#include <string>
#include <string_view>
#include <vector>
 
namespace kcenon::pacs::services::sop_classes {
 
// =============================================================================
// Segmentation Storage SOP Class UIDs
// =============================================================================
 
 
inline constexpr std::string_view segmentation_storage_uid =
    "1.2.840.10008.5.1.4.1.1.66.4";
 
inline constexpr std::string_view surface_segmentation_storage_uid =
    "1.2.840.10008.5.1.4.1.1.66.5";
 
inline constexpr std::string_view heightmap_segmentation_storage_uid =
    "1.2.840.10008.5.1.4.1.1.66.7";
 
inline constexpr std::string_view label_map_segmentation_storage_uid =
    "1.2.840.10008.5.1.4.1.1.66.8";
 
 
// =============================================================================
// SEG-Specific Transfer Syntaxes
// =============================================================================
 
[[nodiscard]] std::vector<std::string> get_seg_transfer_syntaxes();
 
// =============================================================================
// Segmentation Type
// =============================================================================
 
enum class segmentation_type {
    binary,         
    fractional      
};
 
[[nodiscard]] std::string_view to_string(segmentation_type type) noexcept;
 
[[nodiscard]] segmentation_type parse_segmentation_type(std::string_view value) noexcept;
 
[[nodiscard]] bool is_valid_segmentation_type(std::string_view value) noexcept;
 
// =============================================================================
// Segmentation Fractional Type
// =============================================================================
 
enum class segmentation_fractional_type {
    probability,    
    occupancy       
};
 
[[nodiscard]] std::string_view to_string(segmentation_fractional_type type) noexcept;
 
[[nodiscard]] segmentation_fractional_type
parse_segmentation_fractional_type(std::string_view value) noexcept;
 
// =============================================================================
// Segment Algorithm Type
// =============================================================================
 
enum class segment_algorithm_type {
    automatic,      
    semiautomatic,  
    manual          
};
 
[[nodiscard]] std::string_view to_string(segment_algorithm_type type) noexcept;
 
[[nodiscard]] segment_algorithm_type
parse_segment_algorithm_type(std::string_view value) noexcept;
 
[[nodiscard]] bool is_valid_segment_algorithm_type(std::string_view value) noexcept;
 
// =============================================================================
// Recommended Display CIELab Value
// =============================================================================
 
struct segment_color {
    uint16_t l;     
    uint16_t a;     
    uint16_t b;     
};
 
[[nodiscard]] segment_color get_recommended_segment_color(std::string_view segment_label) noexcept;
 
// =============================================================================
// SEG SOP Class Information
// =============================================================================
 
struct seg_sop_class_info {
    std::string_view uid;           
    std::string_view name;          
    std::string_view description;   
    bool is_retired;                
    bool is_surface;                
};
 
[[nodiscard]] std::vector<std::string>
get_seg_storage_sop_classes(bool include_surface = true);
 
[[nodiscard]] const seg_sop_class_info*
get_seg_sop_class_info(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_seg_storage_sop_class(std::string_view uid) noexcept;
 
[[nodiscard]] bool is_surface_segmentation_sop_class(std::string_view uid) noexcept;
 
// =============================================================================
// Segment Category and Type Codes
// =============================================================================
 
enum class segment_category {
    tissue,                 
    anatomical_structure,   
    physical_object,        
    morphologically_abnormal, 
    function,               
    spatial,                
    body_substance          
};
 
[[nodiscard]] std::string_view get_segment_category_code(segment_category category) noexcept;
 
[[nodiscard]] std::string_view get_segment_category_meaning(segment_category category) noexcept;
 
}  // namespace kcenon::pacs::services::sop_classes
 
#endif  // PACS_SERVICES_SOP_CLASSES_SEG_STORAGE_HPP