aira_assessment.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_AI_AIRA_ASSESSMENT_HPP
#define PACS_AI_AIRA_ASSESSMENT_HPP
 
#include "kcenon/pacs/core/dicom_dataset.h"
 
#include <chrono>
#include <optional>
#include <string>
#include <vector>
 
namespace kcenon::pacs::ai {
 
// =============================================================================
// Assessment Types
// =============================================================================
 
enum class assessment_type {
    accept,   
    modify,   
    reject    
};
 
enum class assessment_status {
    draft,      
    final_,     
    amended     
};
 
// =============================================================================
// Data Structures
// =============================================================================
 
struct assessed_result_reference {
    std::string sop_class_uid;
 
    std::string sop_instance_uid;
 
    std::string study_instance_uid;
 
    std::string series_instance_uid;
};
 
struct assessment_modification {
    std::string description;
 
    std::optional<std::string> modified_result_uid;
 
    std::optional<std::string> modified_result_class_uid;
};
 
struct assessment_rejection {
    std::string reason_code;
 
    std::string reason_scheme{"DCM"};
 
    std::string reason_description;
};
 
struct ai_assessment {
    assessment_type type;
 
    assessment_status status{assessment_status::draft};
 
    assessed_result_reference ai_result;
 
    std::string assessor_name;
 
    std::optional<std::string> assessor_id;
 
    std::optional<std::string> institution_name;
 
    std::optional<std::string> comment;
 
    std::optional<assessment_modification> modification;
 
    std::optional<assessment_rejection> rejection;
 
    std::chrono::system_clock::time_point assessment_time{
        std::chrono::system_clock::now()};
};
 
struct assessment_creation_result {
    bool success{false};
 
    std::optional<core::dicom_dataset> sr_dataset;
 
    std::string assessment_uid;
 
    std::string error_message;
};
 
struct assessment_info {
    std::string assessment_uid;
 
    assessment_type type;
 
    assessment_status status;
 
    std::string ai_result_uid;
 
    std::string assessor_name;
 
    std::chrono::system_clock::time_point assessment_time;
};
 
// =============================================================================
// Assessment Creator
// =============================================================================
 
class assessment_creator {
public:
    assessment_creator() = default;
 
    [[nodiscard]] assessment_creation_result create_assessment(
        const ai_assessment& assessment) const;
 
    [[nodiscard]] static std::string assessment_type_to_code(
        assessment_type type);
 
    [[nodiscard]] static std::string assessment_type_to_meaning(
        assessment_type type);
 
    [[nodiscard]] static std::string status_to_completion_flag(
        assessment_status status);
 
private:
    void build_patient_module(core::dicom_dataset& sr,
                              const ai_assessment& assessment) const;
    void build_sr_content(core::dicom_dataset& sr,
                          const ai_assessment& assessment) const;
    void build_referenced_sop_sequence(core::dicom_dataset& sr,
                                       const ai_assessment& assessment) const;
 
    [[nodiscard]] std::string generate_uid() const;
};
 
[[nodiscard]] std::string to_string(assessment_type type);
 
[[nodiscard]] std::string to_string(assessment_status status);
 
}  // namespace kcenon::pacs::ai
 
#endif  // PACS_AI_AIRA_ASSESSMENT_HPP