NAME

       mlpack_preprocess_split - split data

SYNOPSIS

        mlpack_preprocess_split [-h] [-v]

DESCRIPTION

       This utility takes a dataset and optionally labels and splits them into a training set and
       a test set. Before the split, the points  in  the  dataset  are  randomly  reordered.  The
       percentage  of  the  dataset  to  be  used  as  the  test  set  can  be specified with the
       --test_ratio (-r) option; the default is 0.2 (20%).

       The program does not modify the original file, but instead makes separate  files  to  save
       the  training  and  test  files;  The  program requires you to specify the file names with
       --training_file (-t) and --test_file (-T).

       Optionally,  labels  can  be  also  be  split  along  with  the  data  by  specifying  the
       --input_labels_file  (-I)  option.  Splitting  labels  works the same way as splitting the
       data. The output training and test  labels  will  be  saved  to  the  files  specified  by
       --training_labels_file (-l) and --test_labels_file (-L), respectively.

       So,  a  simple example where we want to split dataset.csv into train.csv and test.csv with
       60% of the data in the training set and 40% of the dataset in the test set, we could run

       $ mlpack_preprocess_split -i dataset.csv -t train.csv -T test.csv -r 0.4

       If we had a dataset in dataset.csv and associated labels in labels.csv, and we  wanted  to
       split these into training_set.csv, training_labels.csv, test_set.csv, and test_labels.csv,
       with 30% of the data in the test set, we could run

       $ mlpack_preprocess_split -i dataset.csv -I labels.csv -r 0.3  >  -t  training_set.csv  -l
       training_labels.csv -T test_set.csv > -L test_labels.csv

REQUIRED INPUT OPTIONS

       --input_file (-i) [string]
              File containing data,

OPTIONAL INPUT OPTIONS

       --help (-h)
              Default help info.

       --info [string]
              Get  help  on  a specific module or option.  Default value ''.  --input_labels_file
              (-I) [string] File containing labels Default value ''.

       --seed (-s) [int]
              Random seed (0 for std::time(NULL)). Default value 0.

       --test_ratio (-r) [double]
              Ratio of test set; if not set,the ratio defaults to 0.2 Default value 0.2.

       --verbose (-v)
              Display informational messages and the full list of parameters and  timers  at  the
              end of execution.

       --version (-V)
              Display the version of mlpack.

OPTIONAL OUTPUT OPTIONS

       --test_file (-T) [string]
              File  name  to  save  test data Default value ''.  --test_labels_file (-L) [string]
              File name to save test label Default value ''.  --training_file (-t) [string]  File
              name  to  save  train  data Default value ''.  --training_labels_file (-l) [string]
              File name to save train label Default value ’'.

ADDITIONAL INFORMATION

ADDITIONAL INFORMATION

       For further information, including relevant papers, citations,  and  theory,  For  further
       information,  including  relevant papers, citations, and theory, consult the documentation
       found at http://www.mlpack.org or included with your consult the  documentation  found  at
       http://www.mlpack.org  or  included  with  your  DISTRIBUTION  OF MLPACK.  DISTRIBUTION OF
       MLPACK.

                                                        mlpack_preprocess_split(16 November 2017)