mr_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_MR_IOD_VALIDATOR_HPP
#define PACS_SERVICES_VALIDATION_MR_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"  // Reuse validation types
 
#include <string>
#include <vector>
 
namespace kcenon::pacs::services::validation {
 
// =============================================================================
// MR-Specific DICOM Tags (not in core tag constants)
// =============================================================================
 
namespace mr_tags {
 
inline constexpr core::dicom_tag scanning_sequence{0x0018, 0x0020};
 
inline constexpr core::dicom_tag sequence_variant{0x0018, 0x0021};
 
inline constexpr core::dicom_tag scan_options{0x0018, 0x0022};
 
inline constexpr core::dicom_tag mr_acquisition_type{0x0018, 0x0023};
 
inline constexpr core::dicom_tag repetition_time{0x0018, 0x0080};
 
inline constexpr core::dicom_tag echo_time{0x0018, 0x0081};
 
inline constexpr core::dicom_tag echo_train_length{0x0018, 0x0091};
 
inline constexpr core::dicom_tag inversion_time{0x0018, 0x0082};
 
inline constexpr core::dicom_tag magnetic_field_strength{0x0018, 0x0087};
 
inline constexpr core::dicom_tag spacing_between_slices{0x0018, 0x0088};
 
inline constexpr core::dicom_tag number_of_phase_encoding_steps{0x0018, 0x0089};
 
inline constexpr core::dicom_tag percent_sampling{0x0018, 0x0093};
 
inline constexpr core::dicom_tag percent_phase_fov{0x0018, 0x0094};
 
inline constexpr core::dicom_tag pixel_bandwidth{0x0018, 0x0095};
 
inline constexpr core::dicom_tag flip_angle{0x0018, 0x1314};
 
inline constexpr core::dicom_tag sar{0x0018, 0x1316};
 
inline constexpr core::dicom_tag slice_thickness{0x0018, 0x0050};
 
inline constexpr core::dicom_tag image_position_patient{0x0020, 0x0032};
 
inline constexpr core::dicom_tag image_orientation_patient{0x0020, 0x0037};
 
}  // namespace mr_tags
 
// =============================================================================
// MR Validation Options
// =============================================================================
 
struct mr_validation_options {
    bool check_type1 = true;
 
    bool check_type2 = true;
 
    bool check_conditional = true;
 
    bool validate_pixel_data = true;
 
    bool validate_mr_params = true;
 
    bool strict_mode = false;
};
 
// =============================================================================
// MR IOD Validator
// =============================================================================
 
class mr_iod_validator {
public:
    mr_iod_validator() = default;
 
    explicit mr_iod_validator(const mr_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 mr_validation_options& options() const noexcept;
 
    void set_options(const mr_validation_options& options);
 
private:
    // Module validation methods
    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_general_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_general_equipment_module(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void validate_mr_image_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;
 
    // Attribute validation helpers
    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_modality(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    void check_pixel_data_consistency(
        const core::dicom_dataset& dataset,
        std::vector<validation_finding>& findings) const;
 
    mr_validation_options options_;
};
 
// =============================================================================
// Convenience Functions
// =============================================================================
 
[[nodiscard]] validation_result validate_mr_iod(
    const core::dicom_dataset& dataset);
 
[[nodiscard]] bool is_valid_mr_dataset(const core::dicom_dataset& dataset);
 
}  // namespace kcenon::pacs::services::validation
 
#endif  // PACS_SERVICES_VALIDATION_MR_IOD_VALIDATOR_HPP