#include <aira_assessment_manager.h>

Collaboration diagram for kcenon::pacs::ai::assessment_manager:

Public Member Functions
	assessment_manager ()=default

bool	store_assessment (const core::dicom_dataset &assessment_sr)
	Store an assessment SR document.

std::optional< core::dicom_dataset >	retrieve_assessment (const std::string &assessment_uid) const
	Retrieve an assessment SR dataset by its UID.

std::vector< assessment_info >	find_by_ai_result (const std::string &ai_result_uid) const
	Find all assessments for a given AI result.

std::vector< assessment_info >	find_by_assessor (const std::string &assessor_name) const
	Find all assessments by a specific assessor.

std::vector< assessment_info >	find_by_type (assessment_type type) const
	Find all assessments of a specific type.

std::optional< assessment_info >	get_info (const std::string &assessment_uid) const
	Get metadata for a specific assessment.

bool	exists (const std::string &assessment_uid) const
	Check if an assessment exists.

bool	remove (const std::string &assessment_uid)
	Remove an assessment.

size_t	count () const noexcept
	Get total number of stored assessments.

std::map< assessment_type, size_t >	get_statistics () const
	Get assessments grouped by type with counts.

Private Member Functions
assessment_info	parse_assessment_info (const core::dicom_dataset &sr) const

Private Attributes
std::map< std::string, core::dicom_dataset >	datasets_

std::map< std::string, assessment_info >	metadata_

Detailed Description

Definition at line 53 of file aira_assessment_manager.h.

Constructor & Destructor Documentation

◆ assessment_manager()

kcenon::pacs::ai::assessment_manager::assessment_manager ( )

default

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Member Function Documentation

◆ count()

size_t kcenon::pacs::ai::assessment_manager::count ( ) const

nodiscardnoexcept

Get total number of stored assessments.

Returns: Count of assessments

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 126 of file aira_assessment_manager.cpp.

                                                {
    return datasets_.size();
}

References datasets_.

◆ exists()

bool kcenon::pacs::ai::assessment_manager::exists ( const std::string & assessment_uid ) const

nodiscard

Check if an assessment exists.

Parameters

assessment_uid SOP Instance UID

Returns: true if the assessment exists

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 112 of file aira_assessment_manager.cpp.

                                                                     {
    return datasets_.find(assessment_uid) != datasets_.end();
}

References datasets_.

◆ find_by_ai_result()

std::vector< assessment_info > kcenon::pacs::ai::assessment_manager::find_by_ai_result ( const std::string & ai_result_uid ) const

nodiscard

Find all assessments for a given AI result.

Parameters

ai_result_uid SOP Instance UID of the AI result

Returns: List of assessment info records

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 66 of file aira_assessment_manager.cpp.

                                          {
 
    std::vector<assessment_info> results;
    for (const auto& [uid, info] : metadata_) {
        if (info.ai_result_uid == ai_result_uid) {
            results.push_back(info);
        }
    }
    return results;
}

References metadata_, and uid.

◆ find_by_assessor()

std::vector< assessment_info > kcenon::pacs::ai::assessment_manager::find_by_assessor ( const std::string & assessor_name ) const

nodiscard

Find all assessments by a specific assessor.

Parameters

assessor_name Name of the assessor

Returns: List of assessment info records

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 78 of file aira_assessment_manager.cpp.

                                          {
 
    std::vector<assessment_info> results;
    for (const auto& [uid, info] : metadata_) {
        if (info.assessor_name == assessor_name) {
            results.push_back(info);
        }
    }
    return results;
}

References metadata_, and uid.

◆ find_by_type()

std::vector< assessment_info > kcenon::pacs::ai::assessment_manager::find_by_type ( assessment_type type ) const

nodiscard

Find all assessments of a specific type.

Parameters

type	Assessment type to filter by

Returns: List of assessment info records

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 90 of file aira_assessment_manager.cpp.

                                {
 
    std::vector<assessment_info> results;
    for (const auto& [uid, info] : metadata_) {
        if (info.type == type) {
            results.push_back(info);
        }
    }
    return results;
}

References metadata_, and uid.

◆ get_info()

std::optional< assessment_info > kcenon::pacs::ai::assessment_manager::get_info ( const std::string & assessment_uid ) const

nodiscard

Get metadata for a specific assessment.

Parameters

assessment_uid SOP Instance UID

Returns: Assessment info if found

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 102 of file aira_assessment_manager.cpp.

                                           {
 
    auto it = metadata_.find(assessment_uid);
    if (it == metadata_.end()) {
        return std::nullopt;
    }
    return it->second;
}

References metadata_.

◆ get_statistics()

std::map< assessment_type, size_t > kcenon::pacs::ai::assessment_manager::get_statistics ( ) const

nodiscard

Get assessments grouped by type with counts.

Returns: Map of assessment_type to count

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 130 of file aira_assessment_manager.cpp.

                                                                         {
    std::map<assessment_type, size_t> stats;
    stats[assessment_type::accept] = 0;
    stats[assessment_type::modify] = 0;
    stats[assessment_type::reject] = 0;
 
    for (const auto& [uid, info] : metadata_) {
        stats[info.type]++;
    }
    return stats;
}

References kcenon::pacs::ai::accept, metadata_, kcenon::pacs::ai::modify, kcenon::pacs::ai::reject, and uid.

◆ parse_assessment_info()

assessment_info kcenon::pacs::ai::assessment_manager::parse_assessment_info ( const core::dicom_dataset & sr ) const

private

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 146 of file aira_assessment_manager.cpp.

                                       {
 
    assessment_info info;
    info.assessment_uid = sr.get_string(tags::sop_instance_uid);
    info.assessment_time = std::chrono::system_clock::now();
 
    // Parse completion flag to determine status
    auto completion = sr.get_string(manager_tags::completion_flag);
    if (completion == "COMPLETE") {
        info.status = assessment_status::final_;
    } else {
        info.status = assessment_status::draft;
    }
 
    // Parse Content Sequence for assessment type and assessor
    const auto* content_elem = sr.get(manager_tags::content_sequence);
    if (content_elem && content_elem->is_sequence()) {
        for (const auto& item : content_elem->sequence_items()) {
            auto vt = item.get_string(manager_tags::value_type);
 
            // Extract assessment type from CODE items
            if (vt == "CODE") {
                const auto* concept_name = item.get(
                    manager_tags::concept_name_code_sequence);
                if (concept_name && concept_name->is_sequence() &&
                    !concept_name->sequence_items().empty()) {
                    auto code = concept_name->sequence_items()[0].get_string(
                        manager_tags::code_value);
                    if (code == "AIRA-010") {
                        // Assessment Decision item
                        const auto* concept_code = item.get(
                            manager_tags::concept_code_sequence);
                        if (concept_code && concept_code->is_sequence() &&
                            !concept_code->sequence_items().empty()) {
                            auto type_code =
                                concept_code->sequence_items()[0].get_string(
                                    manager_tags::code_value);
                            if (type_code == "AIRA-ACCEPT") {
                                info.type = assessment_type::accept;
                            } else if (type_code == "AIRA-MODIFY") {
                                info.type = assessment_type::modify;
                            } else if (type_code == "AIRA-REJECT") {
                                info.type = assessment_type::reject;
                            }
                        }
                    }
                }
            }
 
            // Extract assessor name from PNAME items
            if (vt == "PNAME") {
                auto name = item.get_string(manager_tags::person_name);
                if (!name.empty()) {
                    info.assessor_name = name;
                }
            }
        }
    }
 
    // Parse Referenced SOP Sequence for AI result UID
    const auto* ref_elem = sr.get(manager_tags::referenced_sop_sequence);
    if (ref_elem && ref_elem->is_sequence() &&
        !ref_elem->sequence_items().empty()) {
        info.ai_result_uid = ref_elem->sequence_items()[0].get_string(
            manager_tags::referenced_sop_instance_uid);
    }
 
    return info;
}

Referenced by store_assessment().

Here is the caller graph for this function:

◆ remove()

bool kcenon::pacs::ai::assessment_manager::remove ( const std::string & assessment_uid )

Remove an assessment.

Parameters

assessment_uid SOP Instance UID

Returns: true if removed

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 116 of file aira_assessment_manager.cpp.

                                                               {
    auto ds_it = datasets_.find(assessment_uid);
    if (ds_it == datasets_.end()) {
        return false;
    }
    datasets_.erase(ds_it);
    metadata_.erase(assessment_uid);
    return true;
}

References datasets_, and metadata_.

◆ retrieve_assessment()

std::optional< core::dicom_dataset > kcenon::pacs::ai::assessment_manager::retrieve_assessment ( const std::string & assessment_uid ) const

nodiscard

Retrieve an assessment SR dataset by its UID.

Parameters

assessment_uid SOP Instance UID of the assessment

Returns: The dataset if found

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 56 of file aira_assessment_manager.cpp.

                                           {
 
    auto it = datasets_.find(assessment_uid);
    if (it == datasets_.end()) {
        return std::nullopt;
    }
    return it->second;
}

References datasets_.

◆ store_assessment()

bool kcenon::pacs::ai::assessment_manager::store_assessment ( const core::dicom_dataset & assessment_sr )

nodiscard

Store an assessment SR document.

Parses the SR dataset to extract assessment metadata and stores both the dataset and metadata for later retrieval.

Parameters

assessment_sr The assessment SR dataset

Returns: true if stored successfully

Examples: /home/runner/work/pacs_system/pacs_system/include/kcenon/pacs/ai/aira_assessment_manager.h.

Definition at line 41 of file aira_assessment_manager.cpp.

                                            {
 
    auto uid = assessment_sr.get_string(tags::sop_instance_uid);
    if (uid.empty()) {
        return false;
    }
 
    auto info = parse_assessment_info(assessment_sr);
    datasets_[uid] = assessment_sr;
    metadata_[uid] = std::move(info);
 
    return true;
}