@frontlinesystems/rason-mcp-server 2026.5.0

package/examples/datamining/AffinityAnalysis/AssociationRules.json

@@ -0,0 +1,52 @@
+{
+  "modelName": "AssociationRules",
+  "modelDescription": "Affinity Analysis: Association Rules. This RASON model example showcases the Association Rules feature. The goal of association rules mining is to recognize associations and/or correlations among large sets of data items, such as market basket analysis.",
+  "modelType": "datamining",
+  "datasources": {
+    "comment": "Define datasources to use with this model. Must be bound to a dataset within the datasets section. Use the property 'content': 'itemset', if the input data contains data in itemset format. See the datasources section within the RASON Reference guide (downloadable from the Help tab) for more information.",
+    "myDataSrc": {
+      "comment": "Imports the data contained within Associations.txt.",
+      "type": "csv",
+      "connection": "Associations.txt",
+      "direction": "import"
+    }
+  },
+  "datasets": {
+    "comment": "Datasets are bound to an entry in the 'datasources' section",
+    "myData": {
+      "comment": "The data from the myDataSrc datasource is bound to the myData dataset.",
+      "binding": "myDataSrc"
+    }
+  },
+  "estimator": {
+    "comment": "Define an estimator, including the type, algorithm and parameters. Only 1 estimator/transformer may appear in a RASON model.",
+    "associationEstimator": {
+      "comment": "An Association Rules estimator with various options set. Click the Help tab to download the RASON Reference Guide to learn about all options associated with the Association Rules feature.",
+      "type": "affinityAnalysis",
+      "algorithm": "associationRules",
+      "parameters": {
+        "minSupport": 0.1,
+        "method": "APRIORI",
+        "comment": "method parameter may take T_TREE or APRIORI"
+      }
+    }
+  },
+  "actions": {
+    "comment": "Define the actions, evaluations, and data to be used by the estimator defined above.",
+    "associationModel": {
+      "comment": "This action fits an association rules model to the myData dataset. ",
+      "data": "myData",
+      "estimator": "associationEstimator",
+      "action": "fit"
+    },
+    "rules": {
+      "comment": "This action uses the associationModel fitted model (from the action above) to transform the myData dataset using a minimum confidence option of .4. For more information on all Association rules options and resulting evaluations, click Help to download the RASON Reference Guide.",
+      "fittedModel": "associationModel",
+      "parameters": {
+        "minConfidence": 0.4
+      },
+      "action": "transform",
+      "evaluations": [ "transformation" ]
+    }
+  }
+}

package/examples/datamining/Classification/DecisionTree.json

@@ -0,0 +1,91 @@
+{
+  "modelName": "DecisionTreeClassification",
+  "modelDescription": "Classification: Decision Tree; This RASON model example generates a fitted model and POSTs the model to the RASON server. This example uses two outside data sources, hald-small-binary-train.txt and hald-small-binary-valid.txt. Both may be downloaded by clicking the RASON Examples Download icon (download cloud icon). To solve this model, you must first POST the model to the RASON Server by clicking the POST icon (upload cloud icon on the left). Afterwards click Choose Files (on the Properties pane on the right), browse to the location of the downloaded examples, and select both hald-small-binary-train.txt and hald-small-binary-valid.txt.  Then click the down arrow next to the Play icon and click Solve. For more information on POSTing and solving example models, click Help - Defining Your Data Science Model.",
+  "modelType": "datamining",
+  "datasources": {
+    "comment": "Define datasources to use with this model, in the datasources section. Typically these bind to external data sources due to data volume.",
+    "myTrainSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-train.txt to the myTrainSrc datasource. This dataset represents the training partition.",
+      "type": "csv",
+      "connection": "hald-small-binary-train.txt",
+      "direction": "import"
+    },
+    "myValidSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-valid.txt to the myValidSrc datasource. This dataset represents the validation partition.",
+      "type": "csv",
+      "connection": "hald-small-binary-valid.txt",
+      "direction": "import"
+    }
+  },
+  "datasets": {
+    "comment": "Datasets are bound to an entry in the 'datasources' section",
+    "myTrainData": {
+      "comment": "Binds the myTrainSrc datasource to the myTrainData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myTrainSrc",
+      "targetCol": "Y"
+    },
+    "myValidData": {
+      "comment": "Binds the myValidSrc datasource to the myValidData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myValidSrc",
+      "targetCol": "Y"
+    }
+  },
+  "preProcessor": {
+    "comment": "This (optional) section may be used for preliminarily data preparation or to compute values of some properties, which are passed later, at parse-time, to the RASON DM engine.",
+    "numLeafRecords": {
+      "comment": "Computes the value for numLeafRecords as the Maximum of 1 and 1.3 (13 rows/10); used in the estimator below as the setting for minNumRecordsInLeaves.",
+      "formula": "INT(MAX(1, ROWS(myTrainData) / 10))"
+    }
+  },
+  "estimator": {
+    "comment": "Defines an estimator, including the type, algorithm and parameters. Only 1 estimator may appear in a RASON model.",
+    "treeEstimator": {
+      "comment": "Defines the treeEstimator as a classification decision tree estimator; various options are set. For a complete list of all algorithm options, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "type": "classification",
+      "algorithm": "decisionTree",
+      "parameters": {
+        "priorProbMethod": "EMPIRICAL",
+        "minNumRecordsInLeaves": "numLeafRecords",
+        "maxNumNodes": 5,
+        "maxNumLevels": 3,
+        "maxNumSplits": 10,
+        "categoricalFeaturesNames": [ "X1" ],
+        "prunedTreeType": "MIN_ERROR"
+      }
+    }
+  },
+  "actions": {
+    "comment": "Define actions, evaluations, and data to be used by the estimator created above.",
+    "treeModel": {
+      "comment": "Fits a model to the myTrainData dataset using the treeEstimator estimator. The 'export' parameter exports the fitted model to a PMML file which can be reused in a new RASON model. For a complete list of all available evaluations, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "trainData": "myTrainData",
+      "validData": "myValidData",
+      "estimator": "treeEstimator",
+      "action": "fit",
+      "export": "pmml",
+      "evaluations": [ "trainingLog", "pruningLog", "featureImportance", "treeRules" ]
+    },
+    "trainScore": {
+      "comment": "Uses the fitted model treeModel to score the training dataset, myTrainData (the training partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. In addition, various evaluations are requested in the results. For a complete list of all available evaluations, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.) ",
+      "data": "myTrainData",
+      "fittedModel": "treeModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "accuracy", "specificity", "sensitivity", "recall", "precision", "f1" ]
+    },
+    "validScore": {
+      "comment": "Uses the fitted model treeModel to score the validation dataset, myValidData, (the validation partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. In addition, various evaluations are requested in the results. Note that the evaluation, metrics, returns: accuracy, specificity, sensitivity, precision, F1 score and AUC. For a complete list of all available evaluations, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "data": "myValidData",
+      "fittedModel": "treeModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "metrics" ]
+    }
+  }
+}

package/examples/datamining/Classification/DiscriminantAnalysis.json

@@ -0,0 +1,82 @@
+{
+  "modelName": "DiscriminantAnalysis",
+  "modelDescription": "This RASON model example generates a fitted model and POSTs the model to the RASON server. Then uses the fitted model to score both the training and validation partitions. This example uses two outside data sources, hald-small-binary-train.txt and hald-small-binary-valid.txt. Both may be downloaded by clicking the RASON Examples Download icon (download cloud icon). To solve this model, you must first POST the model to the RASON Server by clicking the POST icon (upload cloud icon on the left). Afterwards click Choose Files (on the Properties pane on the right), browse to the location of the downloaded examples, and select both hald-small-binary-train.txt and hald-small-binary-valid.txt.  Then click the down arrow next to the Play icon and click Solve. For more information on POSTing and solving example models, click Help - Defining Your Data Science Model.",
+  "modelType": "datamining",
+  "datasources": {
+    "comment": "Define datasources to use with this model, in the datasources section. Typically these bind to external data sources due to data volume.",
+    "myTrainSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-train.txt to the myTrainSrc datasource. This dataset represents the training partition.",
+      "type": "csv",
+      "connection": "hald-small-binary-train.txt",
+      "headerExists": true,
+      "direction": "import"
+    },
+    "myValidSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-valid.txt to the myValidSrc datasource. This dataset represents the validation partition.",
+      "type": "csv",
+      "connection": "hald-small-binary-valid.txt",
+      "headerExists": true,
+      "direction": "import"
+    }
+  },
+  "datasets": {
+    "comment": "Datasets are bound to an entry in the 'datasources' section",
+    "myTrainData": {
+      "comment": "Binds the myTrainSrc datasource to the myTrainData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myTrainSrc",
+      "targetCol": "Y"
+    },
+    "myValidData": {
+      "comment": "Binds the myValidSrc datasource to the myValidData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myValidSrc",
+      "targetCol": "Y"
+    }
+  },
+  "estimator": {
+    "comment": "Defines an estimator, including the type, algorithm and parameters. Only 1 estimator may appear in a RASON model.",
+    "daEstimator": {
+      "comment": "Defines the daEstimator as a classification discriminant analysis estimator; various options are set. For a complete list of all algorithm options, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "type": "classification",
+      "algorithm": "discriminantAnalysis",
+      "parameters": {
+        "priorProb": [
+          [ "1", 0.4 ],
+          [ "0", 0.6 ]
+        ]
+      }
+    }
+  },
+  "actions": {
+    "comment": "Define actions, evaluations, and data to be used by the estimator created above.",
+    "daModel": {
+      "comment": "Fits a model to the myTrainData dataset using the daEstimator estimator. The 'export' parameter exports the fitted model to a JSON file which can be reused in a new RASON model. For a complete list of all available evaluations, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "data": "myTrainData",
+      "estimator": "daEstimator",
+      "export": "json",
+      "action": "fit",
+      "evaluations": [ "linearDiscriminantFunctions", "quadraticDiscriminantFunctions" ]
+    },
+    "trainScore": {
+      "comment": "Uses the fitted model daModel to score the training dataset, myTrainData (the training partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. In addition, various evaluations are requested in the results. For a complete list of all available evaluations, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.) ",
+      "data": "myTrainData",
+      "fittedModel": "daModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "accuracy", "specificity", "sensitivity", "recall", "precision", "f1" ]
+    },
+    "validScore": {
+      "comment": "Uses the fitted model daModel to score the validation dataset, myValidData, (the validation partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. In addition, various evaluations are requested in the results. Note that evaluation, 'metrics',  returns accuracy, specificity, sensitivity, precision, F1 score and AUC. For a complete list of all available evaluations, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.) ",
+      "data": "myValidData",
+      "fittedModel": "daModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "metrics" ]
+    }
+  }
+}

package/examples/datamining/Classification/Ensembles/Bagging.json

@@ -0,0 +1,67 @@
+{
+  "modelName": "BaggingClassification",
+  "modelDescription": "Bagging Classification Example: This RASON model example generates a fitted model and POSTs the model to the RASON server. Then uses the fitted model to score the training partition. This example uses one outside data source, hald-small-binary-train.txt which may be downloaded by clicking the RASON Examples Download icon (download cloud icon). To solve this model, you must first POST the model to the RASON Server by clicking the POST icon (upload cloud icon on the left). Afterwards click Choose Files (on the Properties pane on the right), browse to the location of the downloaded examples, and select hald-small-binary-train.txt. Then click the down arrow next to the Play icon and click Solve. For more information on POSTing and solving example models, click Help - Defining Your Data Science Model.",
+  "modelType": "datamining",
+  "datasources": {
+    "comment": "Define datasources to use with this model, in the datasources section. Typically these bind to external data sources due to data volume.",
+    "myTrainSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-train.txt to the myTrainSrc datasource.",
+      "type": "csv",
+      "connection": "hald-small-binary.txt",
+      "direction": "import"
+    }
+  },
+  "datasets": {
+    "comment": "Use the datasets section to bind to an entry in the 'datasources' section",
+    "myTrainData": {
+      "comment": "Binds the myTrainSrc datasource to the myTrainData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myTrainSrc",
+      "targetCol": "Y"
+    }
+  },
+  "weakLearner": {
+    "comment": "This section is only required when a bagging or boosting estimator is specified in 'estimator', and is used to define the weak learner used in the ensemble method.",
+    "treeWeakLearner": {
+      "comment": "Creates the weaklearner, treeWeakLearner, which selects decision trees as the weak learner and sets one parameter, minNumRecordsInLeaves. This weak learner will be used in the bagging estimator below. See the Rason Data Science Model Components chapter in the RASON Reference Guide, downloadable from the Help tab.",
+      "type": "classification",
+      "algorithm": "decisionTree",
+      "parameters": {
+        "minNumRecordsInLeaves": 2
+      }
+    }
+  },
+  "estimator": {
+    "comment": "Define an estimator, including the type, algorithm and parameters. Only 1 estimator/transformer may appear in a RASON model.",
+    "baggingEstimator": {
+      "comment": "Defines the baggingEstimator as a classification bagging ensemble method estimator which uses the weakLearner above, treeWeakLearner; various options are set. For a complete list of all algorithm options, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "type": "classification",
+      "algorithm": "bagging",
+      "parameters": {
+        "numWeakLearners": 2,
+        "bootstrapSeed": 10
+      }
+    }
+  },
+  "actions": {
+    "comment": "Define the actions, evaluations, and data to be used by the estimator defined above.",
+    "baggingModel": {
+      "comment": "This action fits a model using the myTrainData dataset using the classification bagging ensemble method estimator created above, baggingEstimator. The fitted model is exported to a JSON file for later use.  Two evaluations are requested in the result, weakLearnerModels (which returns the model for all weak learners) and numWeakLearners (which returns the number of weak learners). For a list of all available evaluations for Classification - Ensemble Methods, see the RASON Reference Guide downloadable from the Help tab.",
+      "data": "myTrainData",
+      "estimator": "baggingEstimator",
+      "export": "json",
+      "action": "fit",
+      "evaluations": [ "weakLearnerModels", "numWeakLearners" ]
+    },
+    "trainScore": {
+      "comment": "This action uses the fitted model above, baggingModel, to score the myTrainData dataset (the training partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. See Evaluations: Classification - Ensemble Methods for a list of all evaluations supported. ",
+      "data": "myTrainData",
+      "fittedModel": "baggingModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "metrics" ]
+    }
+  }
+}

package/examples/datamining/Classification/Ensembles/Boosting.json

@@ -0,0 +1,68 @@
+{
+  "modelName": "BoostingClassification",
+  "modelDescription": "Classification Boosting Example: This RASON model example generates a fitted model and POSTs the model to the RASON server. Then uses the fitted model to score the training partition. This example uses one outside data source, hald-small-binary-train.txt which may be downloaded by clicking the RASON Examples Download icon (download cloud icon). To solve this model, you must first POST the model to the RASON Server by clicking the POST icon (upload cloud icon on the left). Afterwards click Choose Files (on the Properties pane on the right), browse to the location of the downloaded examples, and select hald-small-binary-train.txt. Then click the down arrow next to the Play icon and click Solve. For more information on POSTing and solving example models, click Help - Defining Your Data Science Model.",
+  "modelType": "datamining",
+  "datasources": {
+    "comment": "Define datasources to use with this model, in the datasources section. Typically these bind to external data sources due to data volume.",
+    "myTrainSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-train.txt to the myTrainSrc datasource.",
+      "type": "csv",
+      "connection": "hald-small-binary.txt",
+      "direction": "import"
+    }
+  },
+  "datasets": {
+    "comment": "Use the datasets section to bind to an entry in the 'datasources' section",
+    "myTrainData": {
+      "comment": "Binds the myTrainSrc datasource to the myTrainData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myTrainSrc",
+      "targetCol": "Y"
+    }
+  },
+  "weakLearner": {
+    "comment": "This section is only required when a bagging or boosting estimator is specified in 'estimator', and is used to define the weak learner used in the ensemble method.",
+    "treeWeakLearner": {
+      "comment": "Creates the weaklearner, treeWeakLearner, which selects decision trees as the weak learner and sets one parameter, minNumRecordsInLeaves. This weak learner will be used in the boosting estimator below. See the Rason Data Science Model Components chapter in the RASON Reference Guide, downloadable from the Help tab.",
+      "type": "classification",
+      "algorithm": "decisionTree",
+      "parameters": {
+        "minNumRecordsInLeaves": 2
+      }
+    }
+  },
+  "estimator": {
+    "comment": "Define an estimator, including the type, algorithm and parameters. Only 1 estimator/transformer may appear in a RASON model.",
+    "boostingEstimator": {
+      "comment": "Defines the boostingEstimator as a classification boosting ensemble method estimator which uses the weakLearner above, treeWeakLearner; various options are set. For a complete list of all algorithm options, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "type": "classification",
+      "algorithm": "boosting",
+      "parameters": {
+        "method": "M1_BREIMAN",
+        "numWeakLearners": 2,
+        "resamplingSeed": 10
+      }
+    }
+  },
+  "actions": {
+    "comment": "Define the actions, evaluations, and data to be used by the estimator defined above.",
+    "boostingModel": {
+      "comment": "This action fits a model using the myTrainData dataset using the classification boosting ensemble method estimator created above, boostingEstimator. The fitted model is exported to a JSON file for later use. Two evaluations are requested in the result, weakLearnerModels (which returns the model for all weak learners) and numWeakLearners (which returns the number of weak learners). For a list of all available evaluations for Classification - Ensemble Methods, see the RASON Reference Guide downloadable from the Help tab.",
+      "data": "myTrainData",
+      "estimator": "boostingEstimator",
+      "export": "json",
+      "action": "fit",
+      "evaluations": [ "weakLearnerModels", "numWeakLearners" ]
+    },
+    "trainScore": {
+      "comment": "This action uses the fitted model above, boostingModel, to score the myTrainData dataset (the training partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. See Evaluations: Classification - Ensemble Methods for a list of all evaluations supported. ",
+      "data": "myTrainData",
+      "fittedModel": "boostingModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "metrics" ]
+    }
+  }
+}

package/examples/datamining/Classification/Ensembles/RandomTrees.json

@@ -0,0 +1,92 @@
+{
+  "modelName": "RTClassification",
+  "modelDescription": "Classification Random Trees: This RASON model example generates a fitted model and POSTs the model to the RASON server. Then uses the fitted model to score both the training and validation partitions. This example uses two outside data sources, hald-small-binary-train.txt and hald-small-binary-valid.txt, which may be downloaded by clicking the RASON Examples Download icon (download cloud icon). To solve this model, you must first POST the model to the RASON Server by clicking the POST icon (upload cloud icon on the left). Afterwards click Choose Files (on the Properties pane on the right), browse to the location of the downloaded examples, and select hald-small-binary-train.txt and hald-small-binary-valid.txt. Then click the down arrow next to the Play icon and click Solve. For more information on POSTing and solving example models, click Help - Defining Your Data Science Model.",
+  "modelType": "datamining",
+  "datasources": {
+    "comment": "Define datasources to use with this model, in the datasources section. Typically these bind to external data sources due to data volume.",
+    "myTrainSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-train.txt to the myTrainSrc datasource.",
+      "type": "csv",
+      "connection": "hald-small-binary-train.txt",
+      "direction": "import"
+    },
+    "myValidSrc": {
+      "comment": "Binds the dataset contained within hald-small-binary-valid.txt to the myValidSrc datasource.",
+      "type": "csv",
+      "connection": "hald-small-binary-valid.txt",
+      "direction": "import"
+    }
+  },
+  "datasets": {
+    "comment": "Use the datasets section to bind to an entry in the 'datasources' section",
+    "myTrainData": {
+      "comment": "Binds the myTrainSrc datasource to the myTrainData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myTrainSrc",
+      "targetCol": "Y"
+    },
+    "myValidData": {
+      "comment": "Binds the myValidSrc datasource to the myValidData dataset. Note that the target variable is set to the Y variable using the 'targetCol' property.",
+      "binding": "myValidSrc",
+      "targetCol": "Y"
+    }
+  },
+  "preProcessor": {
+    "comment": "This (optional) section may be used for preliminary data preparation or to compute values of some properties, which are passed later in the model.",
+    "numLeafRecords": {
+      "comment": "numLeafRecords equals the Maximum of 1 or the number of rows in the dataset divided by 10. numLeafRecords is used to set the value for the minNumRecordsInLeaves in the estimator below.",
+      "formula": "INT(MAX(1, ROWS(myTrainData) / 10))"
+    }
+  },
+  "estimator": {
+    "comment": "Define an estimator, including the type, algorithm and parameters. Only 1 estimator/transformer may appear in a RASON model.",
+    "randomTreesEstimator": {
+      "comment": "Defines the randomTreesEstimator as a classification random trees ensemble method estimator. Note that there is no need for the weakLearner section when using a random trees estimator. Various options are set. Note that numLeafRecords (computed above) is used to set the value of the minNumRecordsInLeaves option. For a complete list of all algorithm options, see the RASON Data Science Model Components chapter in the RASON Reference Guide. (Click the Help tab to download.)",
+      "type": "classification",
+      "algorithm": "randomTrees",
+      "parameters": {
+        "priorProb": [
+          [ "1", 0.4 ],
+          [ "0", 0.6 ]
+        ],
+        "numWeakLearners": 2,
+        "bootstrapSeed": 1,
+        "featureSelectionSeed": 2,
+        "numSelectedFeatures": 5,
+        "minNumRecordsInLeaves": "numLeafRecords"
+      }
+    }
+  },
+  "actions": {
+    "comment": "Define the actions, evaluations, and data to be used by the estimator defined above.",
+    "randomTreesModel": {
+      "comment": "This action fits a model using the myTrainData dataset using the classification random trees ensemble estimator created above, randomTreesEstimator. The fitted model is exported to a JSON file for later use. Three evaluations are requested in the result, weakLearnerModels (which returns the model for all weak learners), numWeakLearners (which returns the number of weak learners) and featureImportance (which returns the variables that are included in the model along with their Importance value). For a list of all available evaluations for Classification - Random Trees Ensemble Methods, see the RASON Reference Guide downloadable from the Help tab.",
+      "data": "myTrainData",
+      "estimator": "randomTreesEstimator",
+      "export": "json",
+      "action": "fit",
+      "evaluations": [ "weakLearnerModels", "featureImportance", "numWeakLearners" ]
+    },
+    "trainScore": {
+      "comment": "This action uses the fitted model above, randomTreesModel, to score the myTrainData dataset (the training partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. See Evaluations: Classification - Random Trees Ensemble Methods for a list of all evaluations supported.",
+      "data": "myTrainData",
+      "fittedModel": "randomTreesModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "accuracy", "specificity", "sensitivity", "recall", "precision", "f1" ]
+    },
+    "validScore": {
+      "comment": "This action uses the fitted model above, randomTreesModel, to score the myValidData dataset (the validation partition) using the 'action':'predict' parameter. The successClass and successProbability are both set here. If not explicitly set, the default settings of 'successClass':1 and 'successProbability':0.5 will be used. See Evaluations: Classification - Random Trees Ensemble Methods for a list of all evaluations supported. Note that the evaluation, metrics, returns: accuracy, specificity, sensitivity, precision, F1 score and AUC.",
+      "data": "myValidData",
+      "fittedModel": "randomTreesModel",
+      "action": "predict",
+      "parameters": {
+        "successClass": "1",
+        "successProbability": 0.6
+      },
+      "evaluations": [ "prediction", "posteriorProbability", "confusionMatrix", "metrics" ]
+    }
+  }
+}

package/examples/datamining/Classification/FindBestModel.json

@@ -0,0 +1,87 @@
+{
+  "comment": "Classification: Find Best Model RASON example  - Find Best Model uses methods similar to those in (expensive high-end) tools like DataRobot and RapidMiner, to automatically choose types of ML models and their parameters, validate and compare them according to criteria that you choose, and deliver the model that best fits your data! This example uses two outside data sources, bh-class-train.txt and bh-class-valid.txt. Both may be downloaded by clicking the RASON Examples Download icon (download cloud icon). To solve this model, you must first POST the model to the RASON Server by clicking the POST icon (upload cloud icon on the left). Afterwards click Choose Files (on the Properties pane on the right), browse to the location of the downloaded examples, and select both bh-class-train.txt and bh-class-valid.txt.  Then click the down arrow next to the Play icon and click Solve. For more information on POSTing and solving example models, click Help - Defining Your Data Science Model.",
+  "modelName": "FindBestModelClassify",
+  "modelType": "datamining",
+  "datasources": {
+    "comment": "Define datasources to use with this model here. These datasources must be bound to a dataset in the next section.",
+    "myTrainSrc": {
+      "comment": "Binds the dataset contained within bh-class-train.txt to the myTrainSrc datasource. This dataset represents the training partition.",
+      "type": "csv",
+      "connection": "bh-class-train.txt"
+    },
+    "myValidSrc": {
+      "comment": "Binds the dataset contained within bh-class-valid.txt to the myValidSrc datasource. This dataset represents the validation partition.",
+      "type": "csv",
+      "connection": "bh-class-valid.txt"
+    }
+  },
+  "datasets": {
+    "comment": "Use the datasets section to bind to an entry in the 'datasources' section",
+    "myTrainData": {
+      "comment": "Binds the myTrainSrc datasource to the myTrainData dataset. Note that the target variable is set to the CATMEDV variable using the 'targetCol' property.",
+      "binding": "myTrainSrc",
+      "targetCol": "CATMEDV"
+    },
+    "myValidData": {
+      "comment": "Binds the myValidSrc datasource to the myValidData dataset. Note that the target variable is set to the CATMEDV variable using the 'targetCol' property.",
+      "binding": "myValidSrc",
+      "targetCol": "CATMEDV"
+    }
+  },
+  "estimator": {
+    "comment": "Define an estimator, including the type, algorithm and parameters. Only 1 estimator/transformer may appear in a RASON model.",
+    "fbmEstimator": {
+      "comment": "Defines the Find Best Model classification estimator, fbmEstimator. Use the learners property to set options for the 9 different classification learners, including the 3 ensemble methods. This example only sets options for 3, logistic regression, k-nearest neighbors and the boosting ensemble method. The learners property is optional. Omit to use each learners option default settings. See Algorithm Parameters: Find Best Model for Classification & Regression for a list of all options specific to the Find Best Model feature. See Algorithm Parameters for each learner for options specific to a learner, i.e. for options related to logistic regression, see Algorithm Parameters : Logistic Regression. ",
+      "type": "classification",
+      "algorithm": "findBestModel",
+      "learners": {
+        "logisticRegression": {
+          "fitIntercept": false
+        },
+        "nearestNeighbors": {
+          "numNeighbors": 5
+        },
+        "boosting": {
+          "weakLearner": {
+            "type": "classification",
+            "algorithm": "nearestNeighbors",
+            "parameters": {
+              "numNeighbors": 10
+            }
+          }
+        }
+      }
+    }
+  },
+  "actions": {
+    "comment": "Define the actions, evaluations, and data to be used by the estimator defined above.",
+    "fbmModel": {
+      "comment": "This action fits a model using the myTrainData dataset using the find best model estimator created above, fbmEstimator. The Find Best Model 'fit' action has only one possible evaluation, 'messages'.  This evaluation reports the fitting log which is where any warnings/failures that occur during the fitting process will be reported.",
+      "trainData": "myTrainData",
+      "estimator": "fbmEstimator",
+      "action": "fit",
+      "evaluations": [ "messages" ]
+    },
+    "trainScore": {
+      "comment": "This action uses the fitted model above, fbmModel, to score the myTrainData dataset (the training partition) using the 'action':'predict' parameter. If 'bestLearnerMetric' parameter is present in the 'predict' action. Then the best learner, for the given 'predict' action, according to the 'bestLearnerMetric' will be returned in the results. See Evaluations: Find Best Model for a list of all evaluations supported by Find Best Model. For classification models, the returned metrics are:  Accuracy, Specificity, Sensitivity, Precision and F1 score. ",
+      "data": "myTrainData",
+      "fittedModel": "fbmModel",
+      "parameters": {
+        "bestLearnerMetric": "ACCURACY"
+      },
+      "action": "predict",
+      "evaluations": [ "modelPerformance", "bestLearner", "learnerForScoring", "prediction" ]
+    },
+    "validScore": {
+      "comment": "This action uses the fitted model above, fbmModel, to score, or predict the values for the myValidData dataset (the validation partition) using the 'action':'predict' parameter. If 'bestLearnerMetric' parameter is present in the 'predict' action. Then the best learner, for the given 'predict' action, according to the 'bestLearnerMetric' will be returned in the results. See Evaluations: Find Best Model for a list of all evaluations supported by Find Best Model. For classification models, the returned metrics are:  Accuracy, Specificity, Sensitivity, Precision and F1 score. ",
+      "data": "myValidData",
+      "fittedModel": "fbmModel",
+      "action": "predict",
+      "parameters": {
+        "bestLearnerMetric": "ACCURACY",
+        "useForScoring": true
+      },
+      "evaluations": [ "modelPerformance", "bestLearner", "learnerForScoring", "prediction" ]
+    }
+  }
+}