buildTermCorpus

There are many cases where we have a handful (10 - 2000) past examples of text data and we want to see if new text is close to these saved examples. Machine learning techniques like classification are not appropriate because we don’t have enough data to train an accurate model.

Operator Usage in Easy Mode

Click + on the parent node.
Enter the Build Term Corpus operator in the search field and select the operator from the Results to open the operator form.
In the Table drop-down, enter or select a table to create the model.
In the Model Name field, enter the name of a model.
In the Column field, enter a column name that contains the text to extract TF-IDF features.
In the Columns to Keep drop-down, select a column name to store with the corpus as enrichment to retrieve when used in matchSimilarFromCorpus.
Optional. Click Add More to add values for minimum and maximum TF parameters.
Click Run to view the result.
Click Save to add the operator to the playbook.
Click Cancel to discard the operator form.

Usage Details

We then want to match them against an incoming stream of events to determine how close they are to what we've already observed and retrieve some enrichment about those past examples.

```cplusplus LQL Command buildTermCorpus(table: TableReference, modelName: String, column:String, columnsToKeep:String[], parameters:Double*)

**Input Parameters**  
_table_ (TableReference)    -   The table to create a model  
_modelName_ (String)    -   name of a model  
_column_    (String)    -   Column name that contains the text to extract TF-IDF features  
_columnsToKeep_ (String\[]) -   list of columns to store with the corpus as enrichment to retrieve when used in matchSimilarFromCorpus  
_parameters_    (Double)    -   minDF and minTF parameters, default values for both is 1.0 (include 100% of terms). First parameter will be always set for minTF. e.g.  
buildTermCorpus(table, model, corpus, [columnsToKeep], 0.5, 0.4) // minDF = 0.5, minTF=0.4

**Output**  
If the operator successfully run, it will return success message of model being stored.

## Example

**Input**  
table = github_logs

&lt;style&gt;
  th {
    border: 1px solid #cccccc;
    background-color: #eeeeee;
    padding: 8px 5px 8px 5px;
    text-align: left
  }
&lt;/style&gt;

&lt;div&gt;&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;corpus&lt;/th&gt;
&lt;th&gt;label&lt;/th&gt;
&lt;th&gt;domain&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;&lt;td&gt;a b c, d e f, g, h, i, j&lt;/td&gt;&lt;td&gt;x&lt;/td&gt;&lt;td&gt;google&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;aa b, c, d ee, ff, gg, hh, i, jj&lt;/td&gt;&lt;td&gt;y&lt;/td&gt;&lt;td&gt;facebook&lt;/td&gt;&lt;/tr&gt;
  &lt;tr&gt;&lt;td&gt;k, l, m, n, o, p, q&lt;/td&gt;&lt;td&gt;z&lt;/td&gt;&lt;td&gt;apple&lt;/td&gt;&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/tr&gt;
&lt;/table&gt;&lt;/div&gt;

LQL command
``` {sql}
buildModelFromCorpus(inputTable, "corpusModel", "corpus", ["label", "domain"])
// table = inputTable
// text to train model = corpus
// columns to keep so they will be added after match is found = label and domain
// minDF and minTF are default

Output

RESULT
'Successfully created model and stored into <> file'