org.jpmml.evaluator

Interface Evaluator

All Superinterfaces:

Consumer, Serializable

All Known Implementing Classes:

AssociationModelEvaluator, ClusteringModelEvaluator, GeneralRegressionModelEvaluator, MiningModelEvaluator, NeuralNetworkEvaluator, RegressionModelEvaluator, RuleSetModelEvaluator, ScorecardEvaluator, TreeModelEvaluator

public interface Evaluator
extends Consumer

Performs the evaluation of a Model in "interpreted mode".

Obtaining Evaluator instance:

 PMML pmml = ...;
 PMMLManager pmmlManager = new PMMLManager(pmml);
 Evaluator evaluator = (Evaluator)pmmlManager.getModelManager(null, ModelEvaluatorFactory.getInstance());
 

Preparing active fields:

 Map<FieldName, Object> arguments = new LinkedHashMap<FieldName, Object>();
 List<FieldName> activeFields = evaluator.getActiveFields();
 for(FieldName activeField : activeFields){
   arguments.put(activeField, evaluator.prepare(activeField, ...));
 }
 

Performing the evaluation:

 Map<FieldName, ?> result = evaluator.evaluate(arguments);
 

Retrieving the value of the predicted field and output fields:

 FieldName targetField = evaluator.getTargetField();
 Object targetValue = result.get(targetField);

 List<FieldName> outputFields = evaluator.getOutputFields();
 for(FieldName outputField : outputFields){
   Object outputValue = result.get(outputField);
 }
 

Decoding complex value to simple value:

 Object value = ...;
 if(value instanceof Computable){
   Computable<?> computable = (Computable<?>)value;

   value = computable.getResult();
 }
 

See Also:

EvaluatorUtil

Method Summary

Methods

Modifier and Type	Method and Description
Map<FieldName,?>	evaluate(Map<FieldName,?> arguments)
Object	prepare(FieldName name, Object value) Prepares the input value for a field.

Methods inherited from interface org.jpmml.manager.Consumer

getActiveFields, getDataField, getGroupFields, getMiningField, getOutputField, getOutputFields, getPredictedFields, getSummary, getTargetField

Method Detail

prepare

Object prepare(FieldName name,
             Object value)

Prepares the input value for a field. First, the value is converted from the user-supplied representation to internal representation. Later on, the value is subjected to missing value treatment, invalid value treatment and outlier treatment.

Parameters:

name - The name of the field

string - The input value in user-supplied representation. Use null to represent missing input value.

Throws:

EvaluationException - If the input value preparation fails

See Also:

Consumer.getDataField(FieldName), Consumer.getMiningField(FieldName)

evaluate

Map<FieldName,?> evaluate(Map<FieldName,?> arguments)

Parameters:

arguments - Map of active field values.

Returns:

Map of predicted field and output field values. Simple values are represented using the Java equivalents of PMML data types (eg. String, Integer, Float, Double etc.). Complex values are represented as instances of Computable that return simple values.

Throws:

EvaluationException - If the evaluation fails

See Also:

Computable