Add basic text features sample

Author: popescu-v

doc/samples/samples.rst

@@ -948,6 +948,44 @@ Samples
     kh.deploy_model(
         model_dictionary_file_path, "SNB_Adult", data_table_path, output_data_table_path
     )
+.. autofunction:: deploy_model_text
+.. code-block:: python
+
+    # Imports
+    import os
+    from khiops import core as kh
+
+    # Set the file paths
+    dictionary_file_path = os.path.join(
+        kh.get_samples_dir(), "NegativeAirlineTweets", "NegativeAirlineTweets.kdic"
+    )
+    data_table_path = os.path.join(
+        kh.get_samples_dir(), "NegativeAirlineTweets", "NegativeAirlineTweets.txt"
+    )
+    output_dir = os.path.join("kh_samples", "deploy_model")
+    report_file_path = os.path.join(output_dir, "AnalysisResults.khj")
+    output_data_table_path = os.path.join(output_dir, "ScoresNegativeAirlineTweets.txt")
+
+    # Train the predictor
+    _, model_dictionary_file_path = kh.train_predictor(
+        dictionary_file_path,
+        "FlightNegativeTweets",
+        data_table_path,
+        "negativereason",
+        report_file_path,
+        max_trees=5,
+        max_text_features=1000,
+        text_features="words",
+    )
+
+    # Deploy the model on the database
+    # It will score it according to the trained predictor
+    kh.deploy_model(
+        model_dictionary_file_path,
+        "SNB_FlightNegativeTweets",
+        data_table_path,
+        output_data_table_path,
+    )
 .. autofunction:: deploy_model_mt
 .. code-block:: python
 

khiops/samples/samples.ipynb

@@ -1248,6 +1248,57 @@
     ")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "### `deploy_model_text()`\n\n",
+    "Deploys a model learned on textual data\n    It is a call to `~.api.deploy_model` with its mandatory parameters, plus\n    text-specific parameters.\n\n    In this example, a Selective Naive Bayes (SNB) model is deployed by applying its\n    associated dictionary to the input database. The model predictions are written to\n    the output database.\n    \n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Imports\n",
+    "import os\n",
+    "from khiops import core as kh\n",
+    "\n",
+    "# Set the file paths\n",
+    "dictionary_file_path = os.path.join(\n",
+    "    kh.get_samples_dir(), \"NegativeAirlineTweets\", \"NegativeAirlineTweets.kdic\"\n",
+    ")\n",
+    "data_table_path = os.path.join(\n",
+    "    kh.get_samples_dir(), \"NegativeAirlineTweets\", \"NegativeAirlineTweets.txt\"\n",
+    ")\n",
+    "output_dir = os.path.join(\"kh_samples\", \"deploy_model\")\n",
+    "report_file_path = os.path.join(output_dir, \"AnalysisResults.khj\")\n",
+    "output_data_table_path = os.path.join(output_dir, \"ScoresNegativeAirlineTweets.txt\")\n",
+    "\n",
+    "# Train the predictor\n",
+    "_, model_dictionary_file_path = kh.train_predictor(\n",
+    "    dictionary_file_path,\n",
+    "    \"FlightNegativeTweets\",\n",
+    "    data_table_path,\n",
+    "    \"negativereason\",\n",
+    "    report_file_path,\n",
+    "    max_trees=5,\n",
+    "    max_text_features=1000,\n",
+    "    text_features=\"words\",\n",
+    ")\n",
+    "\n",
+    "# Deploy the model on the database\n",
+    "# It will score it according to the trained predictor\n",
+    "kh.deploy_model(\n",
+    "    model_dictionary_file_path,\n",
+    "    \"SNB_FlightNegativeTweets\",\n",
+    "    data_table_path,\n",
+    "    output_data_table_path,\n",
+    ")"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

khiops/samples/samples.py

@@ -1022,6 +1022,52 @@ def train_recoder_mt_flatten():
     )
 
 
+def deploy_model_text():
+    """Deploys a model learned on textual data
+    It is a call to `~.api.deploy_model` with its mandatory parameters, plus
+    text-specific parameters.
+
+    In this example, a Selective Naive Bayes (SNB) model is deployed by applying its
+    associated dictionary to the input database. The model predictions are written to
+    the output database.
+    """
+    # Imports
+    import os
+    from khiops import core as kh
+
+    # Set the file paths
+    dictionary_file_path = os.path.join(
+        kh.get_samples_dir(), "NegativeAirlineTweets", "NegativeAirlineTweets.kdic"
+    )
+    data_table_path = os.path.join(
+        kh.get_samples_dir(), "NegativeAirlineTweets", "NegativeAirlineTweets.txt"
+    )
+    output_dir = os.path.join("kh_samples", "deploy_model")
+    report_file_path = os.path.join(output_dir, "AnalysisResults.khj")
+    output_data_table_path = os.path.join(output_dir, "ScoresNegativeAirlineTweets.txt")
+
+    # Train the predictor
+    _, model_dictionary_file_path = kh.train_predictor(
+        dictionary_file_path,
+        "FlightNegativeTweets",
+        data_table_path,
+        "negativereason",
+        report_file_path,
+        max_trees=5,
+        max_text_features=1000,
+        text_features="words",
+    )
+
+    # Deploy the model on the database
+    # It will score it according to the trained predictor
+    kh.deploy_model(
+        model_dictionary_file_path,
+        "SNB_FlightNegativeTweets",
+        data_table_path,
+        output_data_table_path,
+    )
+
+
 def deploy_model():
     """Deploys a model in the simplest way possible
 
@@ -1829,6 +1875,7 @@ def build_deployed_dictionary():
     train_recoder_with_multiple_parameters,
     train_recoder_mt_flatten,
     deploy_model,
+    deploy_model_text,
     deploy_model_mt,
     deploy_model_mt_with_interpretation,
     deploy_model_mt_snowflake,