# tLinearRegressionModel properties for Apache Spark Batch

These properties are used to configure tLinearRegressionModel running in the Spark Batch Job framework.

The Spark Batch tLinearRegressionModel component belongs to the Machine Learning family.

This component is available in Talend Platform products with Big Data and in Talend Data Fabric.

## Basic settings

| Schema and Edit schema | A schema is a row description. It defines the number of fields<br>(columns) to be processed and passed on to the next component. When you create a Spark<br>Job, avoid the reserved word line when naming the<br>fields.<br><br>Click Edit<br>schema to make changes to the schema. If the current schema is of the Repository type, three options are available:<br><br><ul> <li> <p> <span>View schema</span>: choose this                option to view the schema only.</p> </li> <li> <p> <span>Change to built-in property</span>:                choose this option to change the schema to <span>Built-in</span> for local changes.</p> </li> <li> <p> <span>Update repository connection</span>:                choose this option to change the schema stored in the repository and decide whether                to propagate the changes to all the Jobs upon completion. If you just want to                propagate the changes to the current Job, you can select <span>No</span> upon completion and choose this schema metadata                again in the <span>Repository Content</span>                window.</p> </li> </ul> |
| --- | --- |
| Label column | Select the input column used to provide Double-type<br>labels (values of the dependent variable in terms of linear regression). The records of this<br>column are used as the potential situations (the variation of the dependent variable in<br>terms of linear regression) a given element could fall into. |
| Feature column | Select the input column used to provide Vector-type<br>features (values of the independent or explanatory variable in terms of linear regression).<br>Very often, this column is the output of the feature engineering computations performed by<br>tModelEncoder. |
| Save the model on file<br>system | Select this check box to store the model in a given file system. Otherwise, the model is<br>stored in memory. The button for browsing does not work with the Spark Local mode; if you are using the Spark Yarn<br>or the Spark Standalone mode, ensure that you have properly<br>configured the connection in a configuration component in the same Job, such as tHDFSConfiguration. |
| ElasticNet mixing parameter | Enter the ElasticNet coefficient (numerical value) used for the regularization calculation<br>in order to control the bias/variance trade-off in feature selection. ElasticNet is the<br>combination of L1 regularization and L2 regularization.<br><br>The value to be put varies between 0.0 and 1.0, indicating the weights of the L1<br>regularization and the L2 regularization in the ElasticNet combination. When the value is<br>0.0, the regularization is actually equivalent to the L2 regularization; when the value is<br>1.0, it is equivalent to the L1 regularization.<br><br>For further information about how ElasticNet is implemented in Spark, see [ML linear methods](http://spark.apache.org/docs/latest/ml-classification-regression.html), in which the related<br>formula shows how the value you put (*α* in that formula) is used to<br>calculate the ElasticNet regularization.<br><br>For further information about ElasticNet, see [Regularization and variable selection via the<br>elastic net](http://web.stanford.edu/~hastie/Papers/B67.2%20%282005%29%20301-320%20Zou%20&%20Hastie.pdf). |
| Fit an intercept term | Select this check box to allow the tLinearRegressionModel to automatically calculate the<br>intercept constants and include them in the regression<br>computation.<br><br>In general, intercept should be present to guarantee that the<br>residuals of your model have a mean of zero. |
| Standardize features before fitting<br>model | Select this check box to scale the features to make them normally<br>distributed. |
| Maximum number of iterations | Enter the number of iterations you want the Job to perform to train the model. |
| Regularization | Enter the regularization coefficient (numerical value) to be used along with ElasticNet<br>for the regularization calculation.<br><br>For further information about how this parameter is implemented in Spark, see [ML linear methods](http://spark.apache.org/docs/latest/ml-classification-regression.html), in which the related<br>formula shows how the value you put (*λ* in that formula) is used to<br>calculate the eventual regularization. |
| Convergence tolerance | Enter the convergence score which the iterations are expected to<br>obtain.<br><br>In general, smaller value will result in higher accuracy in the<br>prediction at the cost of more iterations.<br><br>But note that in some cases, your model may not be able to reach the<br>convergence you put despite of whatever number of iterations you want<br>the Job to perform. This failure to converge might indicate that the<br>convergence score you use is not realistic to the features you are<br>processing and therefore, you need to process these features to a<br>greater degree. |
| Solver algorithm | Select the algorithm used for optimization.<br><br><ul> <li> <p> <span>Normal</span>: this algorithm uses                                    normal equations.</p> </li> <li> <p> <span>L-BFGS</span>: this algorithm                                    approximates the BFGS algorithm using a limited amount of                                    computer memory.</p> </li> <li> <p> <span>Auto</span>: the component select                                    either of the above-mentioned algorithms.</p> </li> </ul> |

## Usage

| **Usage rule** | This component is used as an end component and requires an input link.<br><br>You can accelerate the training process by adjusting the stopping conditions such as the<br>maximum number of iterations or the convergence tolerance but note that<br>the training that stops too early could impact its performance. |
| --- | --- |
| Model evaluation | The parameters you need to set are free parameters and so their values may be provided by<br>previous experiments, empirical guesses or the like. They do not have any optimal values<br>applicable for all datasets.<br><br>Therefore, you need to train the relationship model you are generating with different sets<br>of parameter values until you can obtain the best evaluation result. But note that you need<br>to write the evaluation code yourself to rank your model with scores.<br><br>For general information about validating a regression-based relationship model, see https://en.wikipedia.org/wiki/Regression\_validation. |
| Spark Connection | In the Spark<br>Configuration tab in the Run<br>view, define the connection to a given Spark cluster for the whole Job. In<br>addition, since the Job expects its dependent jar files for execution, you must<br>specify the directory in the file system to which these jar files are<br>transferred so that Spark can access these files:<br><br><ul> <li> <div> <span>Yarn mode</span> (Yarn client or Yarn cluster):<ul> <li> <p>When using Google Dataproc, specify a bucket in the                                            <span>Google Storage staging bucket</span>                                        field in the <span>Spark configuration</span>                                        tab.</p> </li> <li> <p>When using HDInsight, specify the blob to be used for Job                                        deployment in the <span>Windows Azure Storage                                            configuration</span> area in the <span>Spark                                            configuration</span> tab.</p> </li> <li>When using Altus, specify the S3 bucket or the Azure                                    Data Lake Storage for Job deployment in the <span>Spark                                        configuration</span> tab.</li> <li>When using Qubole, add a                                        <span>tS3Configuration</span> to your Job to write                                    your actual business data in the S3 system with Qubole. Without                                        <span>tS3Configuration</span>, this business data is                                    written in the Qubole HDFS system and destroyed once you shut                                    down your cluster.</li> <li> <p>When using on-premises distributions, use the configuration component                                        corresponding to the file system your cluster is using.                                        Typically, this system is HDFS and so use <a href="https://help.qlik.com/talend/r/en-US/7.3/components/hdfs/thdfsconfiguration">tHDFSConfiguration</a>.</p> </li> </ul> </div> </li> <li> <p> <span>Standalone mode</span>: use the                            configuration component corresponding to the file system your cluster is                            using, such as <a href="https://help.qlik.com/talend/r/en-US/7.3/components/hdfs/thdfsconfiguration-properties-for-apache-spark-batch">tHDFSConfiguration Apache Spark Batch</a> or <a href="https://help.qlik.com/talend/r/en-US/7.3/components/amazon-s3/ts3configuration-properties-for-apache-spark-batch">tS3Configuration Apache Spark Batch</a>.</p> <p>If you are using Databricks without any configuration component present                            in your Job, your business data is written directly in DBFS (Databricks                            Filesystem).</p> </li> </ul><br><br>This connection is effective on a per-Job basis. |