Mercurial > hg > orthanc-stone

annotate Framework/Deprecated/Loaders/OrthancMultiframeVolumeLoader.h @ 1279:7ec8fea061b9 broker

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
integration mainline->broker
author Sebastien Jodogne <s.jodogne@gmail.com>
date Tue, 04 Feb 2020 15:20:08 +0100
parents Framework/Loaders/OrthancMultiframeVolumeLoader.h@2d8ab34c8c91 Framework/Loaders/OrthancMultiframeVolumeLoader.h@0ca50d275b9a
children 83af7e562b45
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
1 /**
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
2 * Stone of Orthanc
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
3 * Copyright (C) 2012-2016 Sebastien Jodogne, Medical Physics
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
4 * Department, University Hospital of Liege, Belgium
1271
0ca50d275b9a upgrade to year 2020
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1225
diff changeset
5 * Copyright (C) 2017-2020 Osimis S.A., Belgium
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
6 *
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
7 * This program is free software: you can redistribute it and/or
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
8 * modify it under the terms of the GNU Affero General Public License
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
9 * as published by the Free Software Foundation, either version 3 of
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
10 * the License, or (at your option) any later version.
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
11 *
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
12 * This program is distributed in the hope that it will be useful, but
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
15 * Affero General Public License for more details.
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
16 *
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
17 * You should have received a copy of the GNU Affero General Public License
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
18 * along with this program. If not, see <http://www.gnu.org/licenses/>.
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
19 **/
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
20
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
21
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
22 #pragma once
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
23
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
24 #include "LoaderStateMachine.h"
1225
16738485e457 deprecating DicomStructureSetLoader, OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1156
diff changeset
25 #include "../../Volumes/DicomVolumeImage.h"
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
26
816
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 815
diff changeset
27 #include <boost/shared_ptr.hpp>
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 815
diff changeset
28
1225
16738485e457 deprecating DicomStructureSetLoader, OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1156
diff changeset
29 namespace Deprecated
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
30 {
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
31 class OrthancMultiframeVolumeLoader :
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
32 public LoaderStateMachine,
1225
16738485e457 deprecating DicomStructureSetLoader, OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1156
diff changeset
33 public OrthancStone::IObservable
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
34 {
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
35 private:
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
36 class LoadRTDoseGeometry;
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
37 class LoadGeometry;
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
38 class LoadTransferSyntax;
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
39 class LoadUncompressedPixelData;
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
40
1225
16738485e457 deprecating DicomStructureSetLoader, OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1156
diff changeset
41 boost::shared_ptr<OrthancStone::DicomVolumeImage> volume_;
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
42 std::string instanceId_;
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
43 std::string transferSyntaxUid_;
937
86ac61a040c9 Added getters and notifications to allow clients of the loaders (DicomStructureSetLoader, OrthancSeriesVolumeProgressiveLoader and OrthancMultiframeVolumeLoader) to know when the loading is finished + added ability for SDL event loop to execute a callback repeatedly (used to check the view loading state)
Benjamin Golinvaux <bgo@osimis.io>
parents: 935
diff changeset
44 bool pixelDataLoaded_;
1260
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
45 float outliersHalfRejectionRate_;
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
46 float distributionRawMin_;
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
47 float distributionRawMax_;
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
48 float computedDistributionMin_;
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
49 float computedDistributionMax_;
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
50
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
51 const std::string& GetInstanceId() const;
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
52
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
53 void ScheduleFrameDownloads();
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
54
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
55 void SetTransferSyntax(const std::string& transferSyntax);
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
56
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
57 void SetGeometry(const Orthanc::DicomMap& dicom);
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
58
1260
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
59
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
60 /**
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
61 This method will :
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
62
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
63 - copy the pixel values from the response to the volume image
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
64 - compute the maximum and minimum value while discarding the
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
65 outliersHalfRejectionRate_ fraction of the outliers from both the start
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
66 and the end of the distribution.
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
67
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
68 In English, this means that, if the volume dataset contains a few extreme
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
69 values very different from the rest (outliers) that we want to get rid of,
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
70 this method allows to do so.
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
71
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
72 If you supply 0.005, for instance, it means 1% of the extreme values will
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
73 be rejected (0.5% on each side of the distribution)
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
74 */
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
75 template <typename T>
1260
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
76 void CopyPixelDataAndComputeMinMax(const std::string& pixelData);
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
77
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
78 /** Service method for CopyPixelDataAndComputeMinMax*/
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
79 template <typename T>
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
80 void CopyPixelDataAndComputeDistribution(
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
81 const std::string& pixelData,
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
82 std::map<T, uint64_t>& distribution);
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
83
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
84 /** Service method for CopyPixelDataAndComputeMinMax*/
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
85 template <typename T>
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
86 void ComputeMinMaxWithOutlierRejection(
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
87 const std::map<T, uint64_t>& distribution);
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
88
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
89 void SetUncompressedPixelData(const std::string& pixelData);
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
90
1156
34ee7204fde3 removing IGeometryProvider
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 949
diff changeset
91 bool HasGeometry() const;
1225
16738485e457 deprecating DicomStructureSetLoader, OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1156
diff changeset
92 const OrthancStone::VolumeImageGeometry& GetImageGeometry() const;
949
32eaf4929b08 OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader now implement IGeometryProvider so that the geometry reference can be switched (CT or DOSE, for instance) + VolumeImageGeometry::SetSize renamed to VolumeImageGeometry::SetSizeInVoxels + prevent text layer update if text or properties do not change + a few stream operator<< for debug (Vector, Matrix,...) + fixed memory access aligment issues in ImageBuffer3D::ExtractSagittalSlice + fix for wrong screen Y offset of mpr slices in DicomVolumeImageMPRSlicer.
Benjamin Golinvaux <bgo@osimis.io>
parents: 937
diff changeset
93
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
94 public:
1225
16738485e457 deprecating DicomStructureSetLoader, OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1156
diff changeset
95 OrthancMultiframeVolumeLoader(boost::shared_ptr<OrthancStone::DicomVolumeImage> volume,
16738485e457 deprecating DicomStructureSetLoader, OrthancMultiframeVolumeLoader and OrthancSeriesVolumeProgressiveLoader
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1156
diff changeset
96 OrthancStone::IOracle& oracle,
1279
7ec8fea061b9 integration mainline->broker
Sebastien Jodogne <s.jodogne@gmail.com>
parents: 1270 1271
diff changeset
97 OrthancStone::IObservable& oracleObservable,
1260
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
98 float outliersHalfRejectionRate = 0.0005);
935
401808e7ff2e Added traces in LoaderCache objects dtors + fuse to prevent dead weak ptrs to be calleds in VisitWdigets (in GuiAdapter.h)
Benjamin Golinvaux <bgo@osimis.io>
parents: 921
diff changeset
99
401808e7ff2e Added traces in LoaderCache objects dtors + fuse to prevent dead weak ptrs to be calleds in VisitWdigets (in GuiAdapter.h)
Benjamin Golinvaux <bgo@osimis.io>
parents: 921
diff changeset
100 virtual ~OrthancMultiframeVolumeLoader();
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
101
937
86ac61a040c9 Added getters and notifications to allow clients of the loaders (DicomStructureSetLoader, OrthancSeriesVolumeProgressiveLoader and OrthancMultiframeVolumeLoader) to know when the loading is finished + added ability for SDL event loop to execute a callback repeatedly (used to check the view loading state)
Benjamin Golinvaux <bgo@osimis.io>
parents: 935
diff changeset
102 bool IsPixelDataLoaded() const
86ac61a040c9 Added getters and notifications to allow clients of the loaders (DicomStructureSetLoader, OrthancSeriesVolumeProgressiveLoader and OrthancMultiframeVolumeLoader) to know when the loading is finished + added ability for SDL event loop to execute a callback repeatedly (used to check the view loading state)
Benjamin Golinvaux <bgo@osimis.io>
parents: 935
diff changeset
103 {
86ac61a040c9 Added getters and notifications to allow clients of the loaders (DicomStructureSetLoader, OrthancSeriesVolumeProgressiveLoader and OrthancMultiframeVolumeLoader) to know when the loading is finished + added ability for SDL event loop to execute a callback repeatedly (used to check the view loading state)
Benjamin Golinvaux <bgo@osimis.io>
parents: 935
diff changeset
104 return pixelDataLoaded_;
86ac61a040c9 Added getters and notifications to allow clients of the loaders (DicomStructureSetLoader, OrthancSeriesVolumeProgressiveLoader and OrthancMultiframeVolumeLoader) to know when the loading is finished + added ability for SDL event loop to execute a callback repeatedly (used to check the view loading state)
Benjamin Golinvaux <bgo@osimis.io>
parents: 935
diff changeset
105 }
86ac61a040c9 Added getters and notifications to allow clients of the loaders (DicomStructureSetLoader, OrthancSeriesVolumeProgressiveLoader and OrthancMultiframeVolumeLoader) to know when the loading is finished + added ability for SDL event loop to execute a callback repeatedly (used to check the view loading state)
Benjamin Golinvaux <bgo@osimis.io>
parents: 935
diff changeset
106
1260
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
107 void GetDistributionMinMax
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
108 (float& minValue, float& maxValue) const;
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
109
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
110 void GetDistributionMinMaxWithOutliersRejection
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
111 (float& minValue, float& maxValue) const;
5a2d5380148d Added outlier rejection for min max computation in multiframe volume loader
Benjamin Golinvaux <bgo@osimis.io>
parents: 949
diff changeset
112
815
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
113 void LoadInstance(const std::string& instanceId);
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
114 };
df442f1ba0c6 reorganization
Sebastien Jodogne <s.jodogne@gmail.com>
parents:
diff changeset
115 }