CREATEEVALUATION()`¶

About CreateEvaluation¶

Creates a new Evaluation of an MLModel. An MLModel is evaluated on a set of observations associated to a DataSource. Like a DataSource for an MLModel, the DataSource for an Evaluation contains values for the Target Variable. The Evaluation compares the predicted result for each observation to the actual outcome and provides a summary so that you know how effective the MLModel functions on the test data. Evaluation generates a relevant performance metric, such as BinaryAUC, RegressionRMSE or MulticlassAvgFScore based on the corresponding MLModelType: BINARY, REGRESSION or MULTICLASS.

CreateEvaluation is an asynchronous operation. In response to CreateEvaluation, Amazon Machine Learning (Amazon ML) immediately returns and sets the evaluation status to PENDING. After the Evaluation is created and ready for use, Amazon ML sets the status to COMPLETED.

You can use the GetEvaluation operation to check progress of the evaluation during the creation operation.

Method Signature¶

METHODS /AWS1/IF_ML~CREATEEVALUATION
  IMPORTING
    !IV_EVALUATIONID TYPE /AWS1/ML_ENTITYID OPTIONAL
    !IV_EVALUATIONNAME TYPE /AWS1/ML_ENTITYNAME OPTIONAL
    !IV_MLMODELID TYPE /AWS1/ML_ENTITYID OPTIONAL
    !IV_EVALUATIONDATASOURCEID TYPE /AWS1/ML_ENTITYID OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_ml_createevaloutput
  RAISING
    /AWS1/CX_ML_IDEMPOTENTPRMMIS00
    /AWS1/CX_ML_INTERNALSERVEREX
    /AWS1/CX_ML_INVALIDINPUTEX
    /AWS1/CX_ML_CLIENTEXC
    /AWS1/CX_ML_SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_evaluationid` `TYPE /AWS1/ML_ENTITYID` `/AWS1/ML_ENTITYID`¶

A user-supplied ID that uniquely identifies the Evaluation.

`iv_mlmodelid` `TYPE /AWS1/ML_ENTITYID` `/AWS1/ML_ENTITYID`¶

The ID of the MLModel to evaluate.

The schema used in creating the MLModel must match the schema of the DataSource used in the Evaluation.

`iv_evaluationdatasourceid` `TYPE /AWS1/ML_ENTITYID` `/AWS1/ML_ENTITYID`¶

The ID of the DataSource for the evaluation. The schema of the DataSource must match the schema used to create the MLModel.

Optional arguments:¶

`iv_evaluationname` `TYPE /AWS1/ML_ENTITYNAME` `/AWS1/ML_ENTITYNAME`¶

A user-supplied name or description of the Evaluation.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_ml_createevaloutput` `/AWS1/CL_ML_CREATEEVALOUTPUT`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->createevaluation(
  iv_evaluationdatasourceid = |string|
  iv_evaluationid = |string|
  iv_evaluationname = |string|
  iv_mlmodelid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_entityid = lo_result->get_evaluationid( ).
ENDIF.

/AWS1/IF_ML=>CREATEEVALUATION()¶