classify/picofeat.cpp File Reference

#include "picofeat.h"
#include "mfoutline.h"
#include "variables.h"
#include "sigmenu.h"
#include "hideedge.h"
#include "fpoint.h"
#include <math.h>
#include "ocrfeatures.h"
#include <stdio.h>
#include "efio.h"

Go to the source code of this file.

Defines

• #define PICO_FEATURE_LENGTH   0.05

Functions

• void ConvertSegmentToPicoFeat (FPOINT *Start, FPOINT *End, FEATURE_SET FeatureSet)

  Converts segment of outline into pico features & adds to FeatureSet.
  

• void ConvertToPicoFeatures2 (MFOUTLINE Outline, FEATURE_SET FeatureSet)

  Steps thru the specified outline and cuts it up into pieces of equal length.
  

• FEATURE_SET ExtractPicoFeatures (TBLOB *Blob, LINE_STATS *LineStats)

  Dummy for now.
  

• void InitPicoFXVars ()

  Initialize the pico-feature extractor variables that can be tuned without recompiling.
  

• void NormalizePicoX (FEATURE_SET FeatureSet)

  Computes the average x position over all of the pico-features in FeatureSet and then renormalizes the pico-features to force this average to be the x origin (ie x=0).
  

---

Define Documentation

#define PICO_FEATURE_LENGTH   0.05

Note:

File: picofeat.cpp
Definition of pico-features.

Author:

Dan Johnson

Date:

9/4/90, DSJ, Created.

 **	(c) Copyright Hewlett-Packard Company, 1988.
 ** 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
 ** 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.

Definition at line 36 of file picofeat.cpp.

---

Function Documentation

void ConvertSegmentToPicoFeat	(	FPOINT *	Start,
		FPOINT *	End,
		FEATURE_SET	FeatureSet
	)

Converts segment of outline into pico features & adds to FeatureSet.

Parameters:

	Start	Starting point of pico-feature
	End	Ending point of pico-feature
	FeatureSet	Set to add pico-feature to

Note:

Globals: PicoFeatureLength Length of a single pico-feature

Returns:

none (results are placed in FeatureSet)

Converts an entire segment of an outline into a set of pico features which are added to FeatureSet. The length of the segment is rounded to the nearest whole number of pico-features. The pico-features are spaced evenly over the entire segment.

Note:

Exceptions: none

Date:

Tue Apr 30 15:44:34 1991, DSJ, Created.

Definition at line 184 of file picofeat.cpp.

References AddFeature(), DistanceBetween, NewFeature(), NormalizedAngleFrom(), ParamOf, PicoFeatDesc, PicoFeatDir, PicoFeatureLength, PicoFeatX, PicoFeatY, XDelta, Xof, YDelta, and Yof.

Referenced by ConvertToPicoFeatures2().

                                                      {
  FEATURE Feature;
  FLOAT32 Angle;
  FLOAT32 Length;
  int NumFeatures;
  FPOINT Center;
  FPOINT Delta;
  int i;

  Angle = NormalizedAngleFrom (Start, End, 1.0);
  Length = DistanceBetween (*Start, *End);
  NumFeatures = (int) floor (Length / PicoFeatureLength + 0.5);
  if (NumFeatures < 1)
    NumFeatures = 1;

  /* compute vector for one pico feature */
  Xof (Delta) = XDelta (*Start, *End) / NumFeatures;
  Yof (Delta) = YDelta (*Start, *End) / NumFeatures;

  /* compute position of first pico feature */
  Xof (Center) = Xof (*Start) + Xof (Delta) / 2.0;
  Yof (Center) = Yof (*Start) + Yof (Delta) / 2.0;

  /* compute each pico feature in segment and add to feature set */
  for (i = 0; i < NumFeatures; i++) {
    Feature = NewFeature (&PicoFeatDesc);
    ParamOf (Feature, PicoFeatDir) = Angle;
    ParamOf (Feature, PicoFeatX) = Xof (Center);
    ParamOf (Feature, PicoFeatY) = Yof (Center);
    AddFeature(FeatureSet, Feature); 

    Xof (Center) += Xof (Delta);
    Yof (Center) += Yof (Delta);
  }
}                                /* ConvertSegmentToPicoFeat */

void ConvertToPicoFeatures2	(	MFOUTLINE	Outline,
		FEATURE_SET	FeatureSet
	)

Steps thru the specified outline and cuts it up into pieces of equal length.

Parameters:

	Outline	Outline to extract micro-features from
	FeatureSet	Set of features to add pico-features to

Note:

Globals: PicoFeatureLength Length of features to be extracted

Returns:

none (results are returned in FeatureSet)

These pieces become the desired pico-features. Each segment in the outline is converted into an integral number of pico-features.

Note:

An edge is hidden if the ending point of the edge is marked as hidden. This situation happens because the order of the outlines is reversed when they are converted from the old format. In the old format, a hidden edge is marked by the starting point for that edge.

Date:

4/30/91, DSJ, Adapted from ConvertToPicoFeatures().

An edge is hidden if the ending point of the edge is marked as hidden. This situation happens because the order of the outlines is reversed when they are converted from the old format. In the old format, a hidden edge is marked by the starting point for that edge.

Definition at line 243 of file picofeat.cpp.

References ConvertSegmentToPicoFeat(), DegenerateOutline, IsVisible, NextPointAfter, PointAt, and PositionOf.

Referenced by ExtractPicoFeatures().

                                                                       { 
  MFOUTLINE Next;
  MFOUTLINE First;
  MFOUTLINE Current;

  if (DegenerateOutline (Outline))
    return;

  First = Outline;
  Current = First;
  Next = NextPointAfter (Current);
  do {
    if (IsVisible (PointAt (Next)))
      ConvertSegmentToPicoFeat (&(PositionOf (PointAt (Current))),
        &(PositionOf (PointAt (Next))), FeatureSet);

    Current = Next;
    Next = NextPointAfter (Current);
  }
  while (Current != First);

}                                /* ConvertToPicoFeatures2 */

FEATURE_SET ExtractPicoFeatures	(	TBLOB *	Blob,
		LINE_STATS *	LineStats
	)

Dummy for now.

Parameters:

	Blob	Blob to extract pico-features from
	LineStats	Statistics on text row blob is in

Note:

Globals: NormMethod Normalization method currently specified

Returns:

Pico-features for Blob.

Note:

Exceptions: none

Date:

9/4/90, DSJ, Created.

Definition at line 89 of file picofeat.cpp.

References baseline, ConvertBlob(), ConvertToPicoFeatures2(), first, FreeOutlines(), iterate, MAX_PICO_FEATURES, NewFeatureSet(), NormalizeOutlines(), NormalizePicoX(), NormMethod, and Outline.

Referenced by GetAdaptiveFeatures(), and GetBaselineFeatures().

                                                                    { 
  LIST Outlines;
  LIST RemainingOutlines;
  MFOUTLINE Outline;
  FEATURE_SET FeatureSet;
  FLOAT32 XScale, YScale;

  FeatureSet = NewFeatureSet (MAX_PICO_FEATURES);

  Outlines = ConvertBlob (Blob);

  NormalizeOutlines(Outlines, LineStats, &XScale, &YScale); 
  RemainingOutlines = Outlines;
  iterate(RemainingOutlines) { 
    Outline = (MFOUTLINE) first (RemainingOutlines);
    /*---------Debug--------------------------------------------------*
    OFile = fopen ("f:/ims/debug/pfOutline.logCPP", "r");
    if (OFile == NULL)
    {
      OFile = Efopen ("f:/ims/debug/pfOutline.logCPP", "w");
      WriteOutline(OFile, Outline);
    }
    else
    {
      fclose (OFile);
      OFile = Efopen ("f:/ims/debug/pfOutline.logCPP", "a");
    }
    WriteOutline(OFile, Outline);
    fclose (OFile);
    *--------------------------------------------------------------------*/
    ConvertToPicoFeatures2(Outline, FeatureSet); 
  }
  if (NormMethod == baseline)
    NormalizePicoX(FeatureSet); 
  /*---------Debug--------------------------------------------------*
  File = fopen ("f:/ims/debug/pfFeatSet.logCPP", "r");
  if (File == NULL)
  {
    File = Efopen ("f:/ims/debug/pfFeatSet.logCPP", "w");
    WriteFeatureSet(File, FeatureSet);
  }
  else
  {
    fclose (File);
    File = Efopen ("f:/ims/debug/pfFeatSet.logCPP", "a");
  }
  WriteFeatureSet(File, FeatureSet);
  fclose (File);
  *--------------------------------------------------------------------*/
  FreeOutlines(Outlines); 
  return (FeatureSet);

}                                /* ExtractPicoFeatures */

void InitPicoFXVars

(

)

Initialize the pico-feature extractor variables that can be tuned without recompiling.

Parameters:

none

Note:

Globals: PicoFeatureLength = Controls length of pico-features

Returns:

none

Note:

Exceptions: none

Date:

9/4/90, DSJ, Created.

Definition at line 155 of file picofeat.cpp.

References dummy, float_variable, PICO_FEATURE_LENGTH, and PicoFeatureLength.

Referenced by InitAdaptiveClassifierVars().

                      { 

   VALUE dummy;
   
   float_variable (PicoFeatureLength, "PicoFeatureLength",
      PICO_FEATURE_LENGTH);
   
}  /* InitPicoFXVars */

void NormalizePicoX

(

FEATURE_SET

FeatureSet

)

Computes the average x position over all of the pico-features in FeatureSet and then renormalizes the pico-features to force this average to be the x origin (ie x=0).

Parameters:

FeatureSet

Pico-features to be normalized

Returns:

none (FeatureSet is changed)

Note:

Exceptions: none

Date:

Tue Sep 4 16:50:08 1990, DSJ, Created.

Definition at line 284 of file picofeat.cpp.

References FeatureIn, NumFeaturesIn, ParamOf, and PicoFeatX.

Referenced by ExtractPicoFeatures().

                                            { 
  int i;
  FEATURE Feature;
  FLOAT32 Origin = 0.0;

  for (i = 0; i < NumFeaturesIn (FeatureSet); i++) {
    Feature = FeatureIn (FeatureSet, i);
    Origin += ParamOf (Feature, PicoFeatX);
  }
  Origin /= NumFeaturesIn (FeatureSet);

  for (i = 0; i < NumFeaturesIn (FeatureSet); i++) {
    Feature = FeatureIn (FeatureSet, i);
    ParamOf (Feature, PicoFeatX) -= Origin;
  }
}                                /* NormalizePicoX */

---