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 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376
|
/*=========================================================================
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 otbDescriptorsListSampleGenerator_h
#define otbDescriptorsListSampleGenerator_h
#include <vector>
#include "itkVariableLengthVector.h"
#include "itkImageRegion.h"
#include "itkFunctionBase.h"
#include "itkListSample.h"
#include "itkSimpleDataObjectDecorator.h"
#include "otbListSampleSource.h"
#include "otbVectorData.h"
#include "otbPersistentImageFilter.h"
#include "otbPersistentFilterStreamingDecorator.h"
namespace otb
{
template <class TOutputPrecision>
class DefaultDescriptorsType
{
public:
typedef itk::VariableLengthVector<TOutputPrecision> Type;
};
/** \class PersistentDescriptorsListSampleGenerator
* \brief [internal] Helper class for the implementation of DescriptorsListSampleGenerator
*
* This class inherits PersistentImageFilter and provides the Reset/Synthesize functions,
* plus the ThreadedGenerateData function implementing the image function evaluation
*
* \ingroup OTBObjectDetection
*/
template <class TInputImage, class TVectorData, class TFunctionType, class TListSample, class TLabel>
class ITK_EXPORT PersistentDescriptorsListSampleGenerator :
public PersistentImageFilter<TInputImage, TInputImage>
{
public:
/** Standard Self typedef */
typedef PersistentDescriptorsListSampleGenerator Self;
typedef PersistentImageFilter<TInputImage, TInputImage> Superclass;
typedef itk::SmartPointer<Self> Pointer;
typedef itk::SmartPointer<const Self> ConstPointer;
/** Method for creation through the object factory. */
itkNewMacro(Self);
/** Runtime information support. */
itkTypeMacro(PersistentDescriptorsListSampleGenerator, PersistentImageFilter);
/** Image related typedefs. */
typedef TInputImage InputImageType;
typedef typename TInputImage::Pointer InputImagePointer;
typedef typename TInputImage::RegionType RegionType;
typedef typename TInputImage::SizeType SizeType;
typedef typename TInputImage::IndexType IndexType;
typedef typename TInputImage::PixelType PixelType;
itkStaticConstMacro(InputImageDimension, unsigned int,
TInputImage::ImageDimension);
/** Image related typedefs. */
itkStaticConstMacro(ImageDimension, unsigned int,
TInputImage::ImageDimension);
/** Smart Pointer type to a DataObject. */
typedef itk::ProcessObject::DataObjectPointerArraySizeType DataObjectPointerArraySizeType;
typedef typename itk::DataObject::Pointer DataObjectPointer;
/** Input VectorData */
typedef TVectorData VectorDataType;
typedef typename VectorDataType::Pointer VectorDataPointerType;
typedef typename VectorDataType::DataNodeType VectorDataNodeType;
typedef typename VectorDataType::DataNodePointerType VectorDataNodePointerType;
typedef typename VectorDataType::DataTreeType VectorDataTreeType;
typedef typename VectorDataType::DataTreePointerType VectorDataTreePointerType;
typedef typename VectorDataNodeType::PointType VectorDataPointType;
typedef typename VectorDataNodeType::LineType VectorDataLineType;
typedef typename VectorDataNodeType::PolygonType VectorDataPolygonType;
typedef itk::PreOrderTreeIterator<VectorDataTreeType> VectorDataTreeIteratorType;
/** Function type for descriptors extraction */
typedef TFunctionType DescriptorsFunctionType;
typedef typename DescriptorsFunctionType::Pointer DescriptorsFunctionPointerType;
typedef typename DescriptorsFunctionType::InputType DescriptorsFunctionPointType;
typedef itk::ContinuousIndex
<typename DescriptorsFunctionPointType::ValueType,
itkGetStaticConstMacro(InputImageDimension)> ContinuousIndexType;
/** ListSample output */
typedef TListSample ListSampleType;
typedef typename ListSampleType::Pointer ListSamplePointerType;
typedef typename ListSampleType::MeasurementVectorType SampleMeasurementVectorType;
typedef typename ListSampleType::MeasurementType SampleMeasurementType;
/** LabelListSample output */
typedef TLabel LabelType;
typedef itk::FixedArray<LabelType,1> LabelSampleType;
typedef itk::Statistics::ListSample<LabelSampleType> LabelListSampleType;
typedef typename LabelListSampleType::Pointer LabelListSamplePointerType;
typedef typename LabelListSampleType::MeasurementVectorType LabelMeasurementVectorType;
typedef typename LabelListSampleType::MeasurementType LabelMeasurementType;
/** ListSamplePositions output */
typedef std::vector<DescriptorsFunctionPointType> SamplesPositionType;
typedef itk::SimpleDataObjectDecorator<SamplesPositionType> SamplesPositionObjectType;
typedef typename SamplesPositionObjectType::Pointer SamplesPositionObjectPointerType;
void SetSamplesLocations(VectorDataType * input);
VectorDataType * GetSamplesLocations(void);
/** The function to evaluate */
itkSetObjectMacro(DescriptorsFunction, DescriptorsFunctionType);
itkGetObjectMacro(DescriptorsFunction, DescriptorsFunctionType);
itkGetConstObjectMacro(DescriptorsFunction, DescriptorsFunctionType);
/** Output sample list */
ListSampleType* GetListSample();
/** Output label list */
LabelListSampleType* GetLabelListSample();
/** Output sample position list */
SamplesPositionType& GetSamplesPositions();
SamplesPositionObjectType* GetSamplesPositionsObject();
itkSetMacro( NeighborhoodRadius, unsigned int );
itkGetConstReferenceMacro( NeighborhoodRadius, unsigned int );
/** Make a DataObject of the correct type to be used as the specified
* output. */
itk::DataObject::Pointer MakeOutput(DataObjectPointerArraySizeType idx) ITK_OVERRIDE;
using Superclass::MakeOutput;
void AllocateOutputs() ITK_OVERRIDE;
void GenerateOutputInformation() ITK_OVERRIDE;
void Reset(void) ITK_OVERRIDE;
void Synthetize(void) ITK_OVERRIDE;
void AddInput(itk::DataObject * dataObject) ITK_OVERRIDE
{
Superclass::AddInput(dataObject);
}
protected:
PersistentDescriptorsListSampleGenerator();
~PersistentDescriptorsListSampleGenerator() ITK_OVERRIDE;
void PrintSelf(std::ostream& os, itk::Indent indent) const ITK_OVERRIDE;
void GenerateInputRequestedRegion() ITK_OVERRIDE;
void BeforeThreadedGenerateData() ITK_OVERRIDE;
/** Multi-thread version GenerateData. */
void ThreadedGenerateData(const RegionType& outputRegionForThread,
itk::ThreadIdType threadId) ITK_OVERRIDE;
private:
PersistentDescriptorsListSampleGenerator(const Self &); //purposely not implemented
void operator =(const Self&); //purposely not implemented
bool IsInsideWithNeighborhoodRadius(const RegionType& region, const ContinuousIndexType &index) const
{
typedef typename RegionType::IndexType IndexType;
typedef typename IndexType::IndexValueType IndexValueType;
typedef typename ContinuousIndexType::ValueType ContinuousIndexValueType;
for(unsigned int i=0; i<ImageDimension; ++i)
{
if( itk::Math::RoundHalfIntegerUp<IndexValueType>(index[i]) < static_cast<IndexValueType>( region.GetIndex(i) ) + static_cast<IndexValueType>(m_NeighborhoodRadius) )
//Comment this instruction after itkv4 migration (correct
//usage of centered-pixel coordinates)
//if( index[i] < static_cast<IndexValueType>( region.GetIndex(i) ) + m_NeighborhoodRadius )
{
return false;
}
// bound is the last valid pixel location
const ContinuousIndexValueType bound = static_cast<ContinuousIndexValueType>(
region.GetIndex(i) + region.GetSize(i) - 0.5);
//Comment this instruction after itkv4 migration (correct
//usage of centered-pixel coordinates)
//const ContinuousIndexValueType bound = static_cast<ContinuousIndexValueType>(
// region.GetIndex(i) + static_cast<IndexValueType>(region.GetSize(i)) - 1);
if( index[i] > bound - m_NeighborhoodRadius )
{
return false;
}
}
return true;
}
typedef std::vector<ListSamplePointerType> ListSampleArray;
typedef std::vector<LabelListSamplePointerType> LabelListSampleArray;
typedef std::vector<SamplesPositionType> SamplesPositionArray;
ListSampleArray m_ThreadListSample;
LabelListSampleArray m_ThreadLabelListSample;
SamplesPositionArray m_ThreadSamplesPosition;
DescriptorsFunctionPointerType m_DescriptorsFunction;
unsigned int m_NeighborhoodRadius;
};
/** \class DescriptorsListSampleGenerator
* \brief This class generates a ListSample by computing local descriptors
* on an image at specified positions.
*
* Given an image (by SetInputImage()) and a vector data containing points (by SetSamplesLocations()),
* this class evaluates an ImageFunction (set by SetDescriptorsFunction()) at each point of the vector data
* over the image.
* It generates a ListSample containing the descriptors values for each sample,
* along with a label ListSample containing the label associated with each sample.
* The label is read from the vector data using the data field "Class", read as an int
*
* This class is streaming capable and multithreaded
*
* \ingroup OTBObjectDetection
*/
template <class TInputImage, class TVectorData, class TListSample, class TLabel, class TOutputPrecision = double, class TCoordRep = double>
class ITK_EXPORT DescriptorsListSampleGenerator :
public PersistentFilterStreamingDecorator<
PersistentDescriptorsListSampleGenerator< TInputImage,
TVectorData,
itk::FunctionBase< itk::Point<TCoordRep, 2>,
typename DefaultDescriptorsType<TOutputPrecision>::Type >,
TListSample,
TLabel > >
{
public:
/** Standard Self typedef */
typedef DescriptorsListSampleGenerator Self;
typedef PersistentFilterStreamingDecorator
< PersistentDescriptorsListSampleGenerator
<TInputImage,
TVectorData,
itk::FunctionBase< itk::Point<TCoordRep, 2>, typename DefaultDescriptorsType<TOutputPrecision>::Type >,
TListSample,
TLabel> > Superclass;
typedef itk::SmartPointer<Self> Pointer;
typedef itk::SmartPointer<const Self> ConstPointer;
/** Type macro */
itkNewMacro(Self);
/** Creation through object factory macro */
itkTypeMacro(DescriptorsListSampleGenerator, PersistentFilterStreamingDecorator);
typedef TInputImage InputImageType;
typedef TVectorData InputVectorDataType;
typedef TListSample ListSampleType;
typedef TCoordRep CoordRepType;
typedef TOutputPrecision OutputPrecision;
/** The coordinates used when evaluating function */
typedef itk::Point<TCoordRep, 2> PointType;
/** The return value of the function */
typedef typename DefaultDescriptorsType<TOutputPrecision>::Type DescriptorType;
/** The function evaluated on the input image at locations specified by the vector data */
typedef itk::FunctionBase<PointType, DescriptorType> DescriptorsFunctionType;
typedef typename DescriptorsFunctionType::Pointer DescriptorsFunctionPointerType;
typedef typename Superclass::FilterType PersistentFilterType;
typedef typename PersistentFilterType::LabelListSampleType LabelListSampleType;
typedef typename PersistentFilterType::SamplesPositionObjectType SamplesPositionObjectType;
typedef typename PersistentFilterType::SamplesPositionType SamplesPositionType;
/** Input image to extract feature */
void SetInputImage(InputImageType * input)
{
this->GetFilter()->SetInput(input);
}
/** Input image to extract feature */
InputImageType * GetInputImage()
{
return this->GetFilter()->GetInput();
}
void AddInput(itk::DataObject * dataObject) ITK_OVERRIDE
{
this->GetFilter()->AddInput(dataObject);
}
/** Sample locations as a VectorData of points. The label is in the ClassKey feature */
void SetSamplesLocations(InputVectorDataType * input)
{
this->GetFilter()->SetSamplesLocations(input);
}
/** Sample locations as a VectorData of points. The label is in the ClassKey feature */
InputImageType * GetSamplesLocations()
{
return this->GetFilter()->GetSamplesLocations();
}
/** The function to evaluate */
void SetDescriptorsFunction(DescriptorsFunctionType * input)
{
this->GetFilter()->SetDescriptorsFunction(input);
}
/** The function to evaluate */
DescriptorsFunctionType * GetDescriptorsFunction()
{
return this->GetFilter()->GetDescriptorsFunction();
}
/** Final sample list */
ListSampleType* GetListSample()
{
return this->GetFilter()->GetListSample();
}
/** Final label list */
LabelListSampleType* GetLabelListSample()
{
return this->GetFilter()->GetLabelListSample();
}
/** Final label list */
SamplesPositionType& GetSamplesPositions()
{
return this->GetFilter()->GetSamplesPositions();
}
SamplesPositionObjectType* GetSamplesPositionsObject()
{
return this->GetFilter()->GetSamplesPositionsObject();
}
otbSetObjectMemberMacro(Filter, NeighborhoodRadius, unsigned int);
otbGetObjectMemberMacro(Filter, NeighborhoodRadius, unsigned int);
protected:
/** Constructor */
DescriptorsListSampleGenerator();
/** Destructor */
~DescriptorsListSampleGenerator() ITK_OVERRIDE;
private:
DescriptorsListSampleGenerator(const Self &); //purposely not implemented
void operator =(const Self&); //purposely not implemented
};
} // end namespace otb
#ifndef OTB_MANUAL_INSTANTIATION
#include "otbDescriptorsListSampleGenerator.txx"
#endif
#endif
|