.. Silas documentation master file, created by
   sphinx-quickstart on Mon Nov 19 12:49:44 2018.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. _sec-train-test:

Training and Testing
====================

.. toctree::
   :maxdepth: 2
   :caption: Contents:

To train a model on a data set and test the model, run the following command::

   silas learn [OPTIONS] [settings_file]

where settings_file specifies the :ref:`settings file <sec-ml-settings>` and OPTIONS include:

* -h: Print help message and exit.
* -e spec_file: Perform :ref:`enforcement learning <sec-enforce-learn>` which builds machine learning models that are compliant with respect to the user specifications defined in spec_file. The definition of spec_file can be found in :ref:`User Specifications <sec-user-spec>`.
* -o model_dir: Output models in the directory model_dir.

For example, to build a model using settings1.json and output the model in model/this-model/, issue the following command::

   silas learn -o model/this-model/ settings1.json

.. Indices and tables
.. ==================

.. * :ref:`genindex`
.. * :ref:`modindex`
.. * :ref:`search`