This documentation is for Machine Learner 1.0.0. View documentation for the latest release.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents


This sample demonstrates how a model is generated out of a data set using the linear regression algorithm. The sample uses a data set to generate a model, which is divided into two sets for training and testing.


Follow the steps below to set up the prerequisites before you start.

  1. Download WSO2 Machine Learner, and start the server.


  1. For information on setting up and running WSO2 ML,


  1. see Getting Started.

Building the sample


  1. Download and install jq (CLI JSON processor). For instructions, see jq Documentation.
  2. If you are using Mac OS X, download and install GNU stream editor (sed). For instructions, see GNU sed Documentation.

Executing the sample

Follow the steps below to execute the sample.





  1. Restart the WSO2 ML server by executing the following command: ./ -Dsetup 
  2. Navigate to <ML_HOME>/samples/rest-apidefault/linear-regression/ directory using the CLI.


    <ML_HOME> refers to the downloaded product-ml directory with the source code of the product.

  3. Execute the following command to execute the sample: sh ./

Output of the sample

Once the sample is successfully executed, you can obtain the following output.


view the summary and the prediction of the model  as described below.


By  default , the sample generates the model in the <ML_HOME>/






directory of your machine. For example, the generated file is in the following format denoting the date and time when it was generated:


You can change the location where the output model file is saved, by defining the folder path of the required location for the value of the location element in the <ML_HOME>/samples/rest-api/linear-regression/create-model-storage file.


Viewing the model summary

You can view the summary of the built model using the ML UI as follows.

  1. Log in to the ML UI from your Web browser using admin/admin credentials and the following URL:  https://<ML_HOST>:<ML_PORT>/ml

  2. Click the Projects button as shown below.
    click Projects buttonImage Added

  3. Click MODELS button of the new analysis which you created by executing the sample as shown below.
    view the new projectImage Added
  4. Click  VIEW  of the built new model as shown below.
     view the new modelImage Added
    You view the summary of the built model as shown below.
    Image Added

Viewing the model prediction

The sample executes the generated model on


the  <ML_HOME>/samples/


default/linear-regression/prediction-test  data set, and it prints the value [






 as the prediction result In the CLI logs.