ITK  4.2.0
Insight Segmentation and Registration Toolkit
Classes | Public Types | Public Member Functions | Static Public Member Functions
itk::Statistics::ImageToListSampleAdaptor< TImage > Class Template Reference
Module ITKStatistics

#include <itkImageToListSampleAdaptor.h>

+ Inheritance diagram for itk::Statistics::ImageToListSampleAdaptor< TImage >:
+ Collaboration diagram for itk::Statistics::ImageToListSampleAdaptor< TImage >:

List of all members.

Classes

class  ConstIterator
 Const Iterator 

.  More...


class  Iterator


 Iterator 


.  More...





Public Types


typedef 

Superclass::AbsoluteFrequencyType 		AbsoluteFrequencyType


typedef SmartPointer< const Self > ConstPointer


typedef 

ImageRegionConstIterator

< ImageType > 		ImageConstIteratorType


typedef ImageType::ConstPointer ImageConstPointer


typedef ImageRegionIterator

< ImageType > 		ImageIteratorType


typedef ImageType::Pointer ImagePointer


typedef TImage ImageType


typedef ImageType::IndexType IndexType


typedef 

Superclass::InstanceIdentifier 		InstanceIdentifier


typedef 

MeasurementVectorPixelTraits

< PixelType > 		MeasurementPixelTraitsType


typedef 

MeasurementVectorTraitsType::ValueType 		MeasurementType


typedef 

Superclass::MeasurementVectorSizeType 		MeasurementVectorSizeType


typedef 

MeasurementVectorTraitsTypes

< MeasurementVectorType > 		MeasurementVectorTraitsType


typedef 

MeasurementPixelTraitsType::MeasurementVectorType 		MeasurementVectorType


typedef 

ImageType::PixelContainerConstPointer 		PixelContainerConstPointer


typedef PixelTraits< typename 

TImage::PixelType > 		PixelTraitsType


typedef ImageType::PixelType PixelType


typedef SmartPointer< Self > Pointer


typedef ImageToListSampleAdaptor Self


typedef ListSample< typename 

MeasurementVectorPixelTraits

< typename TImage::PixelType >

::MeasurementVectorType > 		Superclass


typedef 

Superclass::TotalAbsoluteFrequencyType 		TotalAbsoluteFrequencyType


typedef MeasurementVectorType ValueType


- Public Types inherited from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >


typedef std::vector

< MeasurementVectorType > 		InternalDataContainerType


- Public Types inherited from itk::Statistics::Sample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >


- Public Types inherited from itk::DataObject


typedef std::string DataObjectIdentifierType


typedef std::vector< Pointer >

::size_type 		DataObjectPointerArraySizeType


- Public Types inherited from itk::Object


- Public Types inherited from itk::LightObject





Public Member Functions


virtual ::itk::LightObject::Pointer CreateAnother (void) const 


AbsoluteFrequencyType GetFrequency (InstanceIdentifier id) const 


const TImage * GetImage () const 


virtual const 

MeasurementVectorType & 		GetMeasurementVector (InstanceIdentifier id) const 


virtual MeasurementVectorSizeType GetMeasurementVectorSize () const 


virtual const char * GetNameOfClass () const 


TotalAbsoluteFrequencyType GetTotalFrequency () const 


void SetImage (const TImage *image)


InstanceIdentifier Size () const 




Iterator Begin ()


- Public Member Functions inherited from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >


void Clear ()


virtual void Graft (const DataObject *thatObject)


void PushBack (const MeasurementVectorType &mv)


void Resize (InstanceIdentifier newsize)


void SetMeasurement (InstanceIdentifier id, unsigned int dim, const MeasurementType &value)


void SetMeasurementVector (InstanceIdentifier id, const MeasurementVectorType &mv)


- Public Member Functions inherited from itk::Statistics::Sample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >


virtual AbsoluteFrequencyType GetFrequency (InstanceIdentifier id) const =0


virtual const 

MeasurementVectorType & 		GetMeasurementVector (InstanceIdentifier id) const =0


virtual void SetMeasurementVectorSize (MeasurementVectorSizeType s)


- Public Member Functions inherited from itk::DataObject


virtual void CopyInformation (const DataObject *)


virtual void DataHasBeenGenerated ()


void DisconnectPipeline ()


bool GetDataReleased () const 


virtual const bool & GetReleaseDataFlag ()


SmartPointerForwardReference

< ProcessObject > 		GetSource () const 


DataObjectPointerArraySizeType GetSourceOutputIndex () const 


const DataObjectIdentifierType & GetSourceOutputName () const 


virtual unsigned long GetUpdateMTime () const 


virtual void Initialize ()


virtual void PrepareForNewData ()


virtual void PropagateRequestedRegion ()


void ReleaseData ()


virtual void ReleaseDataFlagOff ()


virtual void ReleaseDataFlagOn ()


virtual bool RequestedRegionIsOutsideOfTheBufferedRegion ()


virtual void ResetPipeline ()


void SetReleaseDataFlag (bool flag)


virtual void SetRequestedRegion (const DataObject *)


virtual void SetRequestedRegionToLargestPossibleRegion ()


bool ShouldIReleaseData () const 


virtual void Update ()


virtual void UpdateOutputData ()


virtual void UpdateOutputInformation ()


virtual bool VerifyRequestedRegion ()


void SetPipelineMTime (unsigned long time)


virtual const unsigned long & GetPipelineMTime ()


virtual void SetRealTimeStamp (RealTimeStamp _arg)


virtual const RealTimeStamp & GetRealTimeStamp ()


- Public Member Functions inherited from itk::Object


unsigned long AddObserver (const EventObject &event, Command *)


unsigned long AddObserver (const EventObject &event, Command *) const 


virtual void DebugOff () const 


virtual void DebugOn () const 


Command * GetCommand (unsigned long tag)


bool GetDebug () const 


MetaDataDictionary & GetMetaDataDictionary (void)


const MetaDataDictionary & GetMetaDataDictionary (void) const 


virtual unsigned long GetMTime () const 


virtual const TimeStamp & GetTimeStamp () const 


bool HasObserver (const EventObject &event) const 


void InvokeEvent (const EventObject &)


void InvokeEvent (const EventObject &) const 


virtual void Modified () const 


virtual void Register () const 


void RemoveAllObservers ()


void RemoveObserver (unsigned long tag)


void SetDebug (bool debugFlag) const 


void SetMetaDataDictionary (const MetaDataDictionary &rhs)


virtual void SetReferenceCount (int)


virtual void UnRegister () const 


- Public Member Functions inherited from itk::LightObject


virtual void Delete ()


virtual int GetReferenceCount () const 


 itkCloneMacro (Self)


void Print (std::ostream &os, Indent indent=0) const 





Static Public Member Functions


static Pointer New ()


- Protected Member Functions inherited from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >


 ListSample ()


virtual ~ListSample ()


- Protected Member Functions inherited from itk::Statistics::Sample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >


 Sample ()


virtual ~Sample ()


- Protected Member Functions inherited from itk::DataObject


virtual void PropagateResetPipeline ()


 DataObject ()


 ~DataObject ()


- Protected Member Functions inherited from itk::Object


 Object ()


bool PrintObservers (std::ostream &os, Indent indent) const 


virtual void SetTimeStamp (const TimeStamp &time)


virtual ~Object ()


- Protected Member Functions inherited from itk::LightObject


virtual LightObject::Pointer InternalClone () const 


 LightObject ()


virtual void PrintHeader (std::ostream &os, Indent indent) const 


virtual void PrintTrailer (std::ostream &os, Indent indent) const 


virtual ~LightObject ()


ImageConstPointer m_Image


MeasurementVectorType m_MeasurementVectorInternal


Iterator End ()


ConstIterator Begin () const 


ConstIterator End () const 


 ImageToListSampleAdaptor ()


virtual ~ImageToListSampleAdaptor ()


void PrintSelf (std::ostream &os, Indent indent) const 


 ImageToListSampleAdaptor (const Self &)


void operator= (const Self &)





Additional Inherited Members




Detailed Description


template<class TImage>

class itk::Statistics::ImageToListSampleAdaptor< TImage >



This class provides ListSample interface to ITK Image. 


After calling SetImage( const Image * ) method to plug in the image object, users can use Sample interfaces to access Image data. The resulting data are a list of measurement vectors.


The measurment vector type is determined from the image pixel type. This class handles images with scalar, fixed array or variable length vector pixel types.


See also:
Sample, ListSample


Wiki Examples:





Definition at line 53 of file itkImageToListSampleAdaptor.h.


Member Typedef Documentation








template<class TImage > 

      

        

          typedef Superclass::AbsoluteFrequencyType itk::Statistics::ImageToListSampleAdaptor< TImage >::AbsoluteFrequencyType
        

      




Frequency value type 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 95 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef SmartPointer< const Self > itk::Statistics::ImageToListSampleAdaptor< TImage >::ConstPointer
        

      





Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 65 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageRegionConstIterator< ImageType > itk::Statistics::ImageToListSampleAdaptor< TImage >::ImageConstIteratorType
        

      





Definition at line 83 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageType::ConstPointer itk::Statistics::ImageToListSampleAdaptor< TImage >::ImageConstPointer
        

      





Definition at line 76 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageRegionIterator< ImageType > itk::Statistics::ImageToListSampleAdaptor< TImage >::ImageIteratorType
        

      




Image Iterator typedef support 



Definition at line 82 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageType::Pointer itk::Statistics::ImageToListSampleAdaptor< TImage >::ImagePointer
        

      





Definition at line 75 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef TImage itk::Statistics::ImageToListSampleAdaptor< TImage >::ImageType
        

      




Image typedefs 



Definition at line 71 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageType::IndexType itk::Statistics::ImageToListSampleAdaptor< TImage >::IndexType
        

      





Definition at line 77 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef Superclass::InstanceIdentifier itk::Statistics::ImageToListSampleAdaptor< TImage >::InstanceIdentifier
        

      




InstanceIdentifier typedef. This identifier is a unique sequential id for each measurement vector in a Sample subclass. 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 98 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef MeasurementVectorPixelTraits< PixelType > itk::Statistics::ImageToListSampleAdaptor< TImage >::MeasurementPixelTraitsType
        

      




Superclass typedefs for Measurement vector, measurement, Instance Identifier, frequency, size, size element value 



Definition at line 89 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef MeasurementVectorTraitsType::ValueType itk::Statistics::ImageToListSampleAdaptor< TImage >::MeasurementType
        

      




ValueType of a measurement (ValueType of a component of the MeasurementVector 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 93 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef Superclass::MeasurementVectorSizeType itk::Statistics::ImageToListSampleAdaptor< TImage >::MeasurementVectorSizeType
        

      




Typedef for the length of each measurement vector 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 97 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef MeasurementVectorTraitsTypes< MeasurementVectorType > itk::Statistics::ImageToListSampleAdaptor< TImage >::MeasurementVectorTraitsType
        

      





Definition at line 92 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef MeasurementPixelTraitsType::MeasurementVectorType itk::Statistics::ImageToListSampleAdaptor< TImage >::MeasurementVectorType
        

      




Typedefs inherited from the superclass 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 90 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageType::PixelContainerConstPointer itk::Statistics::ImageToListSampleAdaptor< TImage >::PixelContainerConstPointer
        

      





Definition at line 79 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef PixelTraits< typename TImage::PixelType > itk::Statistics::ImageToListSampleAdaptor< TImage >::PixelTraitsType
        

      





Definition at line 84 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageType::PixelType itk::Statistics::ImageToListSampleAdaptor< TImage >::PixelType
        

      





Definition at line 78 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef SmartPointer< Self > itk::Statistics::ImageToListSampleAdaptor< TImage >::Pointer
        

      





Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 64 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ImageToListSampleAdaptor itk::Statistics::ImageToListSampleAdaptor< TImage >::Self
        

      




Standard class typedefs 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 58 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef ListSample< typename MeasurementVectorPixelTraits< typename TImage::PixelType >::MeasurementVectorType > itk::Statistics::ImageToListSampleAdaptor< TImage >::Superclass
        

      





Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 62 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef Superclass::TotalAbsoluteFrequencyType itk::Statistics::ImageToListSampleAdaptor< TImage >::TotalAbsoluteFrequencyType
        

      




Total frequency type 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 96 of file itkImageToListSampleAdaptor.h.













template<class TImage > 

      

        

          typedef MeasurementVectorType itk::Statistics::ImageToListSampleAdaptor< TImage >::ValueType
        

      




Value type of a measurement (component of the measurement vector) 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 100 of file itkImageToListSampleAdaptor.h.







Constructor & Destructor Documentation








template<class TImage > 



  

  
      

        

          itk::Statistics::ImageToListSampleAdaptor< TImage >::ImageToListSampleAdaptor 
          (
          )
          
        

      

  		
  
protected  
  






returns an iterator that points to the end of the container 













template<class TImage > 



  

  
      

        

          virtual itk::Statistics::ImageToListSampleAdaptor< TImage >::~ImageToListSampleAdaptor 
          (
          )
          
        

      

  		
  
inlineprotectedvirtual  
  






returns an iterator that points to the end of the container 



Definition at line 296 of file itkImageToListSampleAdaptor.h.













template<class TImage > 



  

  
      

        

          itk::Statistics::ImageToListSampleAdaptor< TImage >::ImageToListSampleAdaptor 
          (
          const Self & 
          )
          
        

      

  		
  
private  
  






returns an iterator that points to the end of the container 







Member Function Documentation








template<class TImage > 



  

  
      

        

          Iterator itk::Statistics::ImageToListSampleAdaptor< TImage >::Begin 
          (
          void 
          )
          
        

      

  		
  
inline  
  






returns an iterator that points to the beginning of the container 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 250 of file itkImageToListSampleAdaptor.h.



References itk::ImageRegionConstIterator< TImage >::GoToBegin().



Referenced by itk::Statistics::ImageToListSampleAdaptor< TImage >::ConstIterator::ConstIterator().













template<class TImage > 



  

  
      

        

          ConstIterator itk::Statistics::ImageToListSampleAdaptor< TImage >::Begin 
          (
          void 
          )
           const
        

      

  		
  
inline  
  






returns an iterator that points to the beginning of the container 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 273 of file itkImageToListSampleAdaptor.h.



References itk::ImageRegionConstIterator< TImage >::GoToBegin().













template<class TImage > 



  

  
      

        

          virtual::itk::LightObject::Pointer itk::Statistics::ImageToListSampleAdaptor< TImage >::CreateAnother 
          (
          void 
          )
           const
        

      

  		
  
virtual  
  






Create an object from an instance, potentially deferring to a factory. This method allows you to create an instance of an object that is exactly the same type as the referring object. This is useful in cases where an object has been cast back to a base class. 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 



  

  
      

        

          Iterator itk::Statistics::ImageToListSampleAdaptor< TImage >::End 
          (
          void 
          )
          
        

      

  		
  
inline  
  






returns an iterator that points to the end of the container 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 261 of file itkImageToListSampleAdaptor.h.



References itk::ImageRegionConstIterator< TImage >::GoToEnd().













template<class TImage > 



  

  
      

        

          ConstIterator itk::Statistics::ImageToListSampleAdaptor< TImage >::End 
          (
          void 
          )
           const
        

      

  		
  
inline  
  






returns an iterator that points to the end of the container 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 284 of file itkImageToListSampleAdaptor.h.



References itk::ImageRegionConstIterator< TImage >::GoToEnd().













template<class TImage > 

      

        

          AbsoluteFrequencyType itk::Statistics::ImageToListSampleAdaptor< TImage >::GetFrequency 
          (
          InstanceIdentifier 
          id)
           const
        

      




method to return frequency for a specified id 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 

      

        

          const TImage* itk::Statistics::ImageToListSampleAdaptor< TImage >::GetImage 
          (
          )
           const
        

      




Method to get the image 













template<class TImage > 



  

  
      

        

          virtual const MeasurementVectorType& itk::Statistics::ImageToListSampleAdaptor< TImage >::GetMeasurementVector 
          (
          InstanceIdentifier 
          id)
           const
        

      

  		
  
virtual  
  






method to return measurement vector for a specified id 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 



  

  
      

        

          virtual MeasurementVectorSizeType itk::Statistics::ImageToListSampleAdaptor< TImage >::GetMeasurementVectorSize 
          (
          )
           const
        

      

  		
  
inlinevirtual  
  






Get method for the length of the measurement vector 



Reimplemented from itk::Statistics::Sample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.



Definition at line 114 of file itkImageToListSampleAdaptor.h.













template<class TImage > 



  

  
      

        

          virtual const char* itk::Statistics::ImageToListSampleAdaptor< TImage >::GetNameOfClass 
          (
          )
           const
        

      

  		
  
virtual  
  






Run-time type information (and related methods). 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 



  

  
      

        

          TotalAbsoluteFrequencyType itk::Statistics::ImageToListSampleAdaptor< TImage >::GetTotalFrequency 
          (
          )
           const
        

      

  		
  
virtual  
  






method to return the total frequency 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 



  

  
      

        

          static Pointer itk::Statistics::ImageToListSampleAdaptor< TImage >::New 
          (
          )
          
        

      

  		
  
static  
  






Method for creation through the object factory. 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 



  

  
      

        

          void itk::Statistics::ImageToListSampleAdaptor< TImage >::operator= 
          (
          const Self & 
          )
          
        

      

  		
  
private  
  






returns an iterator that points to the end of the container 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 



  

  
      

        

          void itk::Statistics::ImageToListSampleAdaptor< TImage >::PrintSelf 
          (
          std::ostream & 
          os, 
        

        

          
          
          Indent 
          indent 
        

        

          
          )
           const
        

      

  		
  
protectedvirtual  
  






returns an iterator that points to the end of the container 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.













template<class TImage > 

      

        

          void itk::Statistics::ImageToListSampleAdaptor< TImage >::SetImage 
          (
          const TImage * 
          image)
          
        

      




Method to set the image 













template<class TImage > 



  

  
      

        

          InstanceIdentifier itk::Statistics::ImageToListSampleAdaptor< TImage >::Size 
          (
          )
           const
        

      

  		
  
virtual  
  






returns the number of measurement vectors in this container 



Reimplemented from itk::Statistics::ListSample< MeasurementVectorPixelTraits< TImage::PixelType >::MeasurementVectorType >.







Member Data Documentation








template<class TImage > 



  

  
      

        

          ImageConstPointer itk::Statistics::ImageToListSampleAdaptor< TImage >::m_Image
        

      

  		
  
private  
  






returns an iterator that points to the end of the container 



Definition at line 303 of file itkImageToListSampleAdaptor.h.













template<class TImage > 



  

  
      

        

          MeasurementVectorType itk::Statistics::ImageToListSampleAdaptor< TImage >::m_MeasurementVectorInternal
        

      

  		
  
mutableprivate  
  






returns an iterator that points to the end of the container 



Definition at line 304 of file itkImageToListSampleAdaptor.h.







The documentation for this class was generated from the following file:







  Tarballs of the nightly generated Doxygen documentation are available
    for the
    html,
    xml, and
    tag file.
  




  Generated on Wed Jul 11 2012 00:33:33 for ITK by doxygen 1.8.1