itkSample.h

Go to the documentation of this file.

/*=========================================================================
 *
 *  Copyright Insight Software Consortium
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *         http://www.apache.org/licenses/LICENSE-2.0.txt
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 *
 *=========================================================================*/
#ifndef __itkSample_h
#define __itkSample_h

#include "itkPoint.h"
#include "itkDataObject.h"
#include "itkMeasurementVectorTraits.h"
#include <vector> // for the size_type declaration

namespace itk
{
namespace Statistics
{
template< typename TMeasurementVector >
class Sample:public DataObject
{
public:
  typedef Sample                     Self;
  typedef DataObject                 Superclass;
  typedef SmartPointer< Self >       Pointer;
  typedef SmartPointer< const Self > ConstPointer;

  itkTypeMacro(Sample, DataObject);

  typedef TMeasurementVector MeasurementVectorType;

  typedef typename MeasurementVectorTraitsTypes<
    MeasurementVectorType >::ValueType MeasurementType;

  typedef MeasurementVectorTraits::AbsoluteFrequencyType AbsoluteFrequencyType;

  typedef NumericTraits< AbsoluteFrequencyType >::AccumulateType TotalAbsoluteFrequencyType;

  typedef typename MeasurementVectorTraits::InstanceIdentifier InstanceIdentifier;

  typedef unsigned int MeasurementVectorSizeType;

  virtual InstanceIdentifier Size() const = 0;

  virtual const MeasurementVectorType &
  GetMeasurementVector(InstanceIdentifier id) const = 0;

  virtual AbsoluteFrequencyType GetFrequency(InstanceIdentifier id) const = 0;

  virtual TotalAbsoluteFrequencyType GetTotalFrequency() const = 0;

  virtual void SetMeasurementVectorSize(MeasurementVectorSizeType s)
  {
    // Test whether the vector type is resizable or not
    MeasurementVectorType m;

    if ( MeasurementVectorTraits::IsResizable(m) )
      {
      // then this is a resizable vector type
      //
      // if the new size is the same as the previou size, just return
      if ( s == this->m_MeasurementVectorSize )
        {
        return;
        }
      else
        {
        // If the new size is different from the current size, then
        // only change the measurement vector size if the container is empty.
        if ( this->Size() )
          {
          itkExceptionMacro("Attempting to change the measurement \
          vector size of a non-empty Sample");
          }
        else
          {
          this->m_MeasurementVectorSize = s;
          this->Modified();
          }
        }
      }
    else
      {
      // If this is a non-resizable vector type
      MeasurementVectorType     m3;
      MeasurementVectorSizeType defaultLength =
        NumericTraits<MeasurementVectorType>::GetLength(m3);
      // and the new length is different from the default one, then throw an
      // exception
      if ( defaultLength != s )
        {
        itkExceptionMacro(
          "Attempting to change the measurement \
                           vector size of a non-resizable vector type"                                                  );
        }
      }
  }

  itkGetConstMacro(MeasurementVectorSize, MeasurementVectorSizeType);

  virtual void Graft(const DataObject *thatObject) ITK_OVERRIDE
  {
    this->Superclass::Graft(thatObject);

    const Self *thatConst = dynamic_cast< const Self * >( thatObject );
    if ( thatConst )
      {
      this->SetMeasurementVectorSize( thatConst->GetMeasurementVectorSize() );
      }
  }

protected:
  Sample()
  {
    m_MeasurementVectorSize = NumericTraits<MeasurementVectorType>::GetLength(
      MeasurementVectorType() );
  }

  virtual ~Sample() {}

  virtual void PrintSelf(std::ostream & os, Indent indent) const ITK_OVERRIDE
  {
    Superclass::PrintSelf(os, indent);
    os << indent << "Length of measurement vectors in the sample: "
       << m_MeasurementVectorSize << std::endl;
  }

private:
  Sample(const Self &);         //purposely not implemented
  void operator=(const Self &); //purposely not implemented

  MeasurementVectorSizeType m_MeasurementVectorSize;
};  // end of class
} // end of namespace Statistics
} // end of namespace itk

#endif