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
|
/*=========================================================================
Program: ORFEO Toolbox
Language: C++
Date: $Date$
Version: $Revision$
Copyright (c) Centre National d'Etudes Spatiales. All rights reserved.
See OTBCopyright.txt for details.
This software is distributed WITHOUT ANY WARRANTY; without even
the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the above copyright notices for more information.
=========================================================================*/
#ifndef otbRAMDrivenAdaptativeStreamingManager_h
#define otbRAMDrivenAdaptativeStreamingManager_h
#include "otbStreamingManager.h"
namespace otb
{
/** \class RAMDrivenAdaptativeStreamingManager
* \brief This class computes the divisions needed to stream an image
* according to the input image tiling scheme and a user-defined
* available RAM.
*
* This streaming manager uses the TileHint from the
* MetaDataDictionary to find out the tiling sheme of the input file
* if available.
*
* You can use SetAvailableRAMInMB to set the available RAM. An
* estimation of the pipeline memory print will be done, and the
* number of divisions will then be computed to fit the available RAM.
*
* \sa ImageRegionAdaptativeSplitter
* \sa ImageFileWriter
* \sa StreamingImageVirtualFileWriter
*
* \ingroup OTBStreaming
*/
template<class TImage>
class ITK_EXPORT RAMDrivenAdaptativeStreamingManager : public StreamingManager<TImage>
{
public:
/** Standard class typedefs. */
typedef RAMDrivenAdaptativeStreamingManager Self;
typedef StreamingManager<TImage> Superclass;
typedef itk::SmartPointer<Self> Pointer;
typedef itk::SmartPointer<const Self> ConstPointer;
typedef TImage ImageType;
typedef typename Superclass::RegionType RegionType;
/** Creation through object factory macro */
itkNewMacro(Self);
/** Type macro */
itkTypeMacro(RAMDrivenAdaptativeStreamingManager, itk::LightObject);
/** Dimension of input image. */
itkStaticConstMacro(ImageDimension, unsigned int, ImageType::ImageDimension);
/** The number of Megabytes available (if 0, the configuration option is
used)*/
itkSetMacro(AvailableRAMInMB, unsigned int);
/** The number of Megabytes available (if 0, the configuration option is
used)*/
itkGetConstMacro(AvailableRAMInMB, unsigned int);
/** The multiplier to apply to the memory print estimation */
itkSetMacro(Bias, double);
/** The multiplier to apply to the memory print estimation */
itkGetConstMacro(Bias, double);
/** Actually computes the stream divisions, according to the specified streaming mode,
* eventually using the input parameter to estimate memory consumption */
void PrepareStreaming(itk::DataObject * input, const RegionType ®ion) ITK_OVERRIDE;
protected:
RAMDrivenAdaptativeStreamingManager();
~RAMDrivenAdaptativeStreamingManager() ITK_OVERRIDE;
/** The number of MegaBytes of RAM available */
unsigned int m_AvailableRAMInMB;
/** The multiplier to apply to the memory print estimation */
double m_Bias;
private:
RAMDrivenAdaptativeStreamingManager(const RAMDrivenAdaptativeStreamingManager &);
void operator =(const RAMDrivenAdaptativeStreamingManager&);
};
} // End namespace otb
#ifndef OTB_MANUAL_INSTANTIATION
#include "otbRAMDrivenAdaptativeStreamingManager.txx"
#endif
#endif
|
