rt_iod_validator.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_VALIDATION_RT_IOD_VALIDATOR_HPP
#define PACS_SERVICES_VALIDATION_RT_IOD_VALIDATOR_HPP
 
#include "kcenon/pacs/core/dicom_dataset.h"
#include "kcenon/pacs/core/dicom_tag.h"
#include "kcenon/pacs/services/validation/us_iod_validator.h"  // For shared validation types
 
#include <optional>
#include <string>
#include <vector>
 
namespace kcenon::pacs::services::validation {
 
// =============================================================================
// RT Validation Options
// =============================================================================
 
struct rt_validation_options {
    bool check_type1 = true;
 
    bool check_type2 = true;
 
    bool check_conditional = true;
 
    bool validate_rt_plan = true;
 
    bool validate_rt_dose = true;
 
    bool validate_rt_structure_set = true;
 
    bool validate_pixel_data = true;
 
    bool validate_references = true;
 
    bool allow_retired = true;
 
    bool strict_mode = false;
};
 
// =============================================================================
// RT Plan IOD Validator
// =============================================================================
 
class rt_plan_iod_validator {
public:
    rt_plan_iod_validator() = default;
    explicit rt_plan_iod_validator(const rt_validation_options& options);
 
    [[nodiscard]] validation_result validate(const core::dicom_dataset& dataset) const;
    [[nodiscard]] bool quick_check(const core::dicom_dataset& dataset) const;
 
    [[nodiscard]] const rt_validation_options& options() const noexcept;
    void set_options(const rt_validation_options& options);
 
private:
    void validate_patient_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_general_study_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_series_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_frame_of_reference_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_general_plan_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_fraction_scheme_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_beams_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_sop_common_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void check_type1_attribute(
        const core::dicom_dataset& dataset,
        core::dicom_tag tag,
        std::string_view name,
        std::vector<validation_finding>& findings) const;
 
    void check_type2_attribute(
        const core::dicom_dataset& dataset,
        core::dicom_tag tag,
        std::string_view name,
        std::vector<validation_finding>& findings) const;
 
    rt_validation_options options_;
};
 
// =============================================================================
// RT Dose IOD Validator
// =============================================================================
 
class rt_dose_iod_validator {
public:
    rt_dose_iod_validator() = default;
    explicit rt_dose_iod_validator(const rt_validation_options& options);
 
    [[nodiscard]] validation_result validate(const core::dicom_dataset& dataset) const;
    [[nodiscard]] bool quick_check(const core::dicom_dataset& dataset) const;
 
    [[nodiscard]] const rt_validation_options& options() const noexcept;
    void set_options(const rt_validation_options& options);
 
private:
    void validate_patient_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_general_study_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_series_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_frame_of_reference_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_dose_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_image_pixel_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_sop_common_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void check_type1_attribute(
        const core::dicom_dataset& dataset,
        core::dicom_tag tag,
        std::string_view name,
        std::vector<validation_finding>& findings) const;
 
    void check_type2_attribute(
        const core::dicom_dataset& dataset,
        core::dicom_tag tag,
        std::string_view name,
        std::vector<validation_finding>& findings) const;
 
    void check_dose_data_consistency(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    rt_validation_options options_;
};
 
// =============================================================================
// RT Structure Set IOD Validator
// =============================================================================
 
class rt_structure_set_iod_validator {
public:
    rt_structure_set_iod_validator() = default;
    explicit rt_structure_set_iod_validator(const rt_validation_options& options);
 
    [[nodiscard]] validation_result validate(const core::dicom_dataset& dataset) const;
    [[nodiscard]] bool quick_check(const core::dicom_dataset& dataset) const;
 
    [[nodiscard]] const rt_validation_options& options() const noexcept;
    void set_options(const rt_validation_options& options);
 
private:
    void validate_patient_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_general_study_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_series_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_structure_set_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_roi_contour_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_rt_roi_observations_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_sop_common_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void check_type1_attribute(
        const core::dicom_dataset& dataset,
        core::dicom_tag tag,
        std::string_view name,
        std::vector<validation_finding>& findings) const;
 
    void check_type2_attribute(
        const core::dicom_dataset& dataset,
        core::dicom_tag tag,
        std::string_view name,
        std::vector<validation_finding>& findings) const;
 
    void check_roi_consistency(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    rt_validation_options options_;
};
 
// =============================================================================
// Unified RT IOD Validator
// =============================================================================
 
class rt_iod_validator {
public:
    rt_iod_validator() = default;
    explicit rt_iod_validator(const rt_validation_options& options);
 
    [[nodiscard]] validation_result validate(const core::dicom_dataset& dataset) const;
 
    [[nodiscard]] bool quick_check(const core::dicom_dataset& dataset) const;
 
    [[nodiscard]] const rt_validation_options& options() const noexcept;
    void set_options(const rt_validation_options& options);
 
private:
    rt_validation_options options_;
};
 
// =============================================================================
// Convenience Functions
// =============================================================================
 
[[nodiscard]] validation_result validate_rt_plan_iod(const core::dicom_dataset& dataset);
 
[[nodiscard]] validation_result validate_rt_dose_iod(const core::dicom_dataset& dataset);
 
[[nodiscard]] validation_result validate_rt_structure_set_iod(const core::dicom_dataset& dataset);
 
[[nodiscard]] validation_result validate_rt_iod(const core::dicom_dataset& dataset);
 
[[nodiscard]] bool is_valid_rt_plan_dataset(const core::dicom_dataset& dataset);
 
[[nodiscard]] bool is_valid_rt_dose_dataset(const core::dicom_dataset& dataset);
 
[[nodiscard]] bool is_valid_rt_structure_set_dataset(const core::dicom_dataset& dataset);
 
[[nodiscard]] bool is_valid_rt_dataset(const core::dicom_dataset& dataset);
 
}  // namespace kcenon::pacs::services::validation
 
#endif  // PACS_SERVICES_VALIDATION_RT_IOD_VALIDATOR_HPP