com.joliciel.talismane.machineLearning.features.NormaliseFeature Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of talismane-machine-learning Show documentation
There is a newer version: 6.1.8
Show newest version
///////////////////////////////////////////////////////////////////////////////
//Copyright (C) 2014 Joliciel Informatique
//
//This file is part of Talismane.
//
//Talismane is free software: you can redistribute it and/or modify
//it under the terms of the GNU Affero General Public License as published by
//the Free Software Foundation, either version 3 of the License, or
//(at your option) any later version.
//
//Talismane is distributed in the hope that it will be useful,
//but WITHOUT ANY WARRANTY; without even the implied warranty of
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//GNU Affero General Public License for more details.
//
//You should have received a copy of the GNU Affero General Public License
//along with Talismane.  If not, see .
//////////////////////////////////////////////////////////////////////////////
package com.joliciel.talismane.machineLearning.features;

import com.joliciel.talismane.TalismaneException;

/**
 * Changes a numeric feature to a value from 0 to 1, where any value <=
 * minValue is set to 0, and any value >= maxValue is set to 1, and all other
 * values are set to a proportional value between 0 and 1.
 * 
 * @author Assaf Urieli
 *
 */
public class NormaliseFeature extends AbstractCachableFeatureimplements DoubleFeature {
  DoubleFeature featureToNormalise;
  DoubleFeature minValueFeature = new DoubleLiteralFeature(0.0);
  DoubleFeature maxValueFeature = null;

  /**
   * Constructor assuming the min value is 0.
   */
  public NormaliseFeature(DoubleFeature featureToNormalise, DoubleFeature maxValueFeature) {
    this.featureToNormalise = featureToNormalise;
    this.maxValueFeature = maxValueFeature;
    this.setName("Normalise(" + featureToNormalise.getName() + "," + maxValueFeature.getName() + ")");
  }

  /**
   * Constructor providing both min and max values.
   */
  public NormaliseFeature(DoubleFeature featureToNormalise, DoubleFeature minValueFeature, DoubleFeature maxValueFeature) {
    super();
    this.featureToNormalise = featureToNormalise;
    this.minValueFeature = minValueFeature;
    this.maxValueFeature = maxValueFeature;
    this.setName("Normalise(" + featureToNormalise.getName() + "," + minValueFeature.getName() + "," + maxValueFeature.getName() + ")");
  }

  @Override
  public FeatureResult checkInternal(T context, RuntimeEnvironment env) throws TalismaneException {
    FeatureResult featureResult = null;

    FeatureResult resultToNormalise = featureToNormalise.check(context, env);
    FeatureResult minValueResult = minValueFeature.check(context, env);
    FeatureResult maxValueResult = maxValueFeature.check(context, env);

    if (resultToNormalise != null && minValueResult != null && maxValueResult != null) {
      double minValue = minValueResult.getOutcome();
      double maxValue = maxValueResult.getOutcome();
      double normalisedValue = 0.0;
      double initialValue = resultToNormalise.getOutcome();
      if (initialValue < minValue)
        normalisedValue = 0.0;
      else if (initialValue > maxValue)
        normalisedValue = 1.0;
      else {
        normalisedValue = (initialValue - minValue) / (maxValue - minValue);
      }
      featureResult = this.generateResult(normalisedValue);
    }
    return featureResult;
  }

  public DoubleFeature getFeatureToNormalise() {
    return featureToNormalise;
  }

  public void setFeatureToNormalise(DoubleFeature featureToNormalise) {
    this.featureToNormalise = featureToNormalise;
  }

  public DoubleFeature getMinValueFeature() {
    return minValueFeature;
  }

  public void setMinValueFeature(DoubleFeature minValueFeature) {
    this.minValueFeature = minValueFeature;
  }

  public DoubleFeature getMaxValueFeature() {
    return maxValueFeature;
  }

  public void setMaxValueFeature(DoubleFeature maxValueFeature) {
    this.maxValueFeature = maxValueFeature;
  }

}