Score Model

Important

Support for Machine Learning Studio (classic) will end on 31 August 2024. We recommend you transition to Azure Machine Learning by that date.

Beginning 1 December 2021, you will not be able to create new Machine Learning Studio (classic) resources. Through 31 August 2024, you can continue to use the existing Machine Learning Studio (classic) resources.

ML Studio (classic) documentation is being retired and may not be updated in the future.

Scores predictions for a trained classification or regression model

Category: Machine Learning / Score

Note

Applies to: Machine Learning Studio (classic) only

Similar drag-and-drop modules are available in Azure Machine Learning designer.

Module overview

This article describes how to use the Score Model module in Machine Learning Studio (classic), to generate predictions using a trained classification or regression model.

How to use Score Model

  1. Add the Score Model module to your experiment in Studio (classic).

  2. Attach a trained model and a dataset containing new input data.

    The data should be in a format compatible with the type of trained model you are using. The schema of the input dataset should also generally match the schema of the data used to train the model.

  3. Run the experiment.

Results

After you have generated a set of scores using Score Model:

  • To generate a set of metrics used for evaluating the model’s accuracy (performance). you can connect the scored dataset to Evaluate Model,
  • Right-click the module and select Visualize to see the a sample of the results.
  • Save the results to a dataset.

The score, or predicted value, can be in many different formats, depending on the model and your input data:

  • For classification models, Score Model outputs a predicted value for the class, as well as the probability of the predicted value.
  • For regression models, Score Model generates just the predicted numeric value.
  • For image classification models, the score might be the class of object in the image, or a Boolean indicating whether a particular feature was found.

Publish scores as a web service

A common use of scoring is to return the output as part of a predictive web service. For more information, see this tutorial on how to create a web service based on an experiment in Azure ML Studio (classic):

Examples

For examples of how Score Model is used in an experimental workflow, see the Azure AI Gallery:

Technical notes

Models not supported by Score Model

If you are using one of the following special types of model, you might need to use one of these custom scoring modules:

Usage tips

If the data that you are scoring contains missing values, in many cases no score will be generated for the entire row.

The following machine learning models require that data have no missing values. When using the following machine learning models, review the data before passing it to Score Model, and use Clean Missing Data to amend the missing values in input columns.

Expected inputs

Name Type Description
Trained model ILearner interface Trained predictive model
Dataset Data Table Input test dataset

Outputs

Name Type Description
Scored dataset Data Table Dataset with obtained scores

Exceptions

Exception Description
Error 0032 Exception occurs if argument is not a number.
Error 0033 Exception occurs if argument is Infinity.
Error 0003 Exception occurs if one or more of inputs are null or empty.
Error 0013 Exception occurs if the learner that is passed to the module is an invalid type.

See also

Evaluate
Train Model
Score Matchbox Recommender