<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE Change SYSTEM "https://itk.org/migrationv4/ITKMigration.dtd">
<!--***************************************************************************
**
** MoveGetSetLengthMeasurementVectorTraits.xml
**
** This is the second sample Migration Guide XML document. For full details,
** see MoveGetSetLengthMeasurementVectorTraits.xml. One aditional required
** element has been added which is <Title>. This will be used for the title of
** the migration guide page.
**
****************************************************************************-->

<Change>

  <!--
  ** Title for the published page
  **-->
  <Title>
  Improve Attribute Names for Labels
  </Title>

  <!--
  ** English language description of what was changed and why
  **-->
  <Description>
  <![CDATA[
  This change updates the attribute names for the LabelObject system.  The
  changes are:

  BinaryElongation        -> Elongation
  BinaryFlatness          -> Flatness
  BinaryPrincipalMoments  -> PrincipalMoments
  BinaryPrincipalAxes     -> PrincipalAxes
  Elongation              -> WeightedElongation
  EquivalentEllipsoidSize -> EquivalentEllipsoidDiameter
  EquivalentPerimeter     -> EquivalentSphericalPerimeter
  EquivalentRadius        -> EquivalentSphericalRadius
  Flatness                -> WeightedFlatness
  PhysicalSizeOnBorder    -> PerimeterOnBorder
  Region                  -> BoundingBox
  PrincipalAxes           -> WeightedPrincipalAxes
  PrincipalMoments        -> WeightedPrincipalMoments
  Sigma                   -> StandardDeviation
  Size                    -> NumberOfPixels
  SizeOnBorder            -> NumberOfPixelsOnBorder
  ]]>
  </Description>

  <!--
  ** Sample code to illustrate the fix process
  **-->
  <SampleCode>
    <Old>
    <![CDATA[
    typedef ShapeLabelObject LabelObjectType;
    LabelObjectType::Pointer labelObject;
    LabelObjectType::RegionType region = labelObject->GetRegion();
    ]]>
    </Old>

    <New>
    <![CDATA[
    typedef TLabelObject LabelObjectType;
    LabelObjectType::Pointer labelObject;
    LabelObjectType::RegionType region = labelObject->GetBoundingBox();
    ]]>
    </New>
  </SampleCode>


  <!--
  ** The asociated Gerrit entry for this API change
  **-->
  <Gerrit-ChangeId>
  Ib5bdca1cd1809490f1c5a0f991c7cc2714d33c70
  </Gerrit-ChangeId>

  <!--
  ** List of all files that were changed (might be automatically populated by
  ** git hook?)
  **-->
  <FileList>
  Code/Review/itkBinaryFillholeImageFilter.txx
  Code/Review/itkBinaryGrindPeakImageFilter.txx
  Code/Review/itkBinaryShapeKeepNObjectsImageFilter.txx
  Code/Review/itkBinaryShapeOpeningImageFilter.txx
  Code/Review/itkLabelMapUtilities.h
  Code/Review/itkLabelShapeKeepNObjectsImageFilter.txx
  Code/Review/itkLabelShapeOpeningImageFilter.txx
  Code/Review/itkShapeKeepNObjectsLabelMapFilter.txx
  Code/Review/itkShapeLabelMapFilter.txx
  Code/Review/itkShapeLabelObject.h
  Code/Review/itkShapeLabelObjectAccessors.h
  Code/Review/itkShapeOpeningLabelMapFilter.txx
  Code/Review/itkShapeRelabelImageFilter.txx
  Code/Review/itkShapeRelabelLabelMapFilter.txx
  Code/Review/itkShapeUniqueLabelMapFilter.txx
  Code/Review/itkStatisticsLabelMapFilter.txx
  Code/Review/itkStatisticsLabelObject.h
  Code/Review/itkStatisticsLabelObjectAccessors.h
  Testing/Code/Review/itkAttributePositionLabelMapFilterTest1.cxx
  Testing/Code/Review/itkAttributeUniqueLabelMapFilterTest1.cxx
  Testing/Code/Review/itkLabelMapToAttributeImageFilterTest1.cxx
  Testing/Code/Review/itkShapeLabelObjectAccessorsTest1.cxx
  </FileList>



  <!--
  ** Migration guide rules............ Still need to figure out how this will
  **-->

</Change>
