Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

create_evaluation

create_evaluation(**kwargs)

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.

See also: AWS API Documentation

Request Syntax

response = client.create_evaluation(
    EvaluationId='string',
    EvaluationName='string',
    MLModelId='string',
    EvaluationDataSourceId='string'
)
Parameters
  • EvaluationId (string) --

    [REQUIRED]

    A user-supplied ID that uniquely identifies the Evaluation .

  • EvaluationName (string) -- A user-supplied name or description of the Evaluation .
  • MLModelId (string) --

    [REQUIRED]

    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 .

  • EvaluationDataSourceId (string) --

    [REQUIRED]

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

Return type

dict

Returns

Response Syntax

{
    'EvaluationId': 'string'
}

Response Structure

  • (dict) --

    Represents the output of a CreateEvaluation operation, and is an acknowledgement that Amazon ML received the request.

    CreateEvaluation operation is asynchronous. You can poll for status updates by using the GetEvcaluation operation and checking the Status parameter.

    • EvaluationId (string) --

      The user-supplied ID that uniquely identifies the Evaluation . This value should be identical to the value of the EvaluationId in the request.

Exceptions

  • MachineLearning.Client.exceptions.InvalidInputException
  • MachineLearning.Client.exceptions.InternalServerException
  • MachineLearning.Client.exceptions.IdempotentParameterMismatchException