1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
|
/************************************************************************
*
* Copyright (C) 2021-2025 IRCAD France
*
* This file is part of Sight.
*
* Sight is free software: you can redistribute it and/or modify it under
* the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* Sight is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with Sight. If not, see <https://www.gnu.org/licenses/>.
*
***********************************************************************/
#pragma once
#include <core/com/signal.hpp>
#include <core/progress/monitor.hpp>
#include <data/series_set.hpp>
#include <io/__/service/reader.hpp>
#include <io/dicom/reader/file.hpp>
namespace sight::module::io::dicom
{
/**
* @brief DICOM generic reader.
*
* @details Allow reading a DICOM directory. Part of the configuration is managed by reader class.
* After selecting a folder, it is scanned and if more than one DICOM Series are found, a selection dialog is
* shown allowing to select one or more Series to load. The DICOM series can be filtered by sopFilter and
* typeFilter configuration parameters.
*
* @section Signals Signals
* - \b monitor_created(SPTR(core::progress::monitor)): emitted to display a progress bar while the image is read,
* it should be connected to a progress bar
*
* @section XML XML Configuration
* @code{.xml}
<service type="sight::module::io::dicom::reader">
<inout key="data" uid="..." />
<config>
<windowTitle>Open DICOM directory</windowTitle>
<dialog sopFilter="1.2.840.10008.5.1.4.1.1.2, 1.2.840.10008.5.1.4.1.1.4.1"/>
</config>
</service>
@endcode
*
* @subsection In-Out In-Out
* - \b data [sight::data::object]: object to read to.
*
* @subsection Configuration Configuration
* - \b dialog(optional):
* \b sopFilter: The SOP class uids to filter. If empty, and if typeFilter is also empty, the default type filter
* "image", "model", "report" is used.
* \b typeFilter: The type of DICOM to filter. Currently, "image", "model", "report" and "fiducials" are allowed.
* \b policy:
* - \b "never": never show the open dialog (DEFAULT)
* - \b "once": show only once, store the location as long as the service is started
* - \b "always": always show the location dialog
*
*
* @see sight::io::service::reader
* @see sight::io::dicom::Reader
*/
class reader final : public sight::io::service::reader
{
public:
SIGHT_DECLARE_SERVICE(reader, sight::io::service::reader);
using monitor_created_signal_t = core::com::signal<void (core::progress::monitor::sptr)>;
reader() noexcept;
~reader() noexcept final;
/// Propose to read a session data file
void open_location_dialog() final;
protected:
/// Does nothing
void starting() final;
/// Does nothing
void stopping() final;
/// Parses the configuration
void configuring() final;
/// Read DICOM data from filesystem
void updating() final;
/// Returns managed path type, here service manages only single file
sight::io::service::path_type_t get_path_type() const final
{
return sight::io::service::folder;
}
private:
/// Clear location and selected series
void clear();
[[nodiscard]] bool show_location();
[[nodiscard]] bool scan();
[[nodiscard]] bool show_selection();
/// Dialog policy to use for dialogs. By default, always show dialog
dialog_policy m_dialog_policy {dialog_policy::always};
/// Default filters to use when scanning for DICOM files
sight::data::series::sop_keywords_t m_filters {
data::series::dicom_types_to_sops(
static_cast<data::series::dicom_types>(data::series::dicom_t::image)
| static_cast<data::series::dicom_types>(data::series::dicom_t::model)
| static_cast<data::series::dicom_types>(data::series::dicom_t::report)
)
};
std::string m_displayed_columns =
"PatientName/SeriesInstanceUID,PatientSex,PatientBirthDate/Icon,Modality,StudyDescription/SeriesDescription,StudyDate/SeriesDate,StudyTime/SeriesTime,PatientAge,BodyPartExamined,PatientPositionString,ContrastBolusAgent,AcquisitionTime,ContrastBolusStartTime";
/// The reader to use to read all DICOM files
sight::io::dicom::reader::file::sptr m_reader;
/// This will hold the scanned / selected series
sight::data::series_set::sptr m_selection;
};
} // namespace sight::module::io::dicom
|
