Update machine learning tasks topic and add learners

docs/machine-learning/resources/tasks.md

@@ -1,39 +1,86 @@
 ---
 title: Machine learning tasks
 description: Explore the different machine learning tasks supported in ML.NET.
-ms.date: 06/04/2018
-author: aditidugar
+ms.date: 11/29/2018
+author: jralexander
 ---
 # Machine learning tasks
 
-When building a machine learning model, you first need to define what you are hoping to achieve with your data. After, you can pick the right machine learning task for your situation. The following list describes the different machine learning tasks that you can choose from and some common use cases. 
+When building a machine learning model, you first need to define what you are hoping to achieve with your data. Afterwards, you can pick the right machine learning task for your situation. The following list describes the different machine learning tasks that you can choose from and some common use cases.
 
 > [!NOTE]
 > ML.NET is currently in Preview. Not all machine learning tasks are currently supported. To submit a request for a certain task, open an issue in the [dotnet/machinelearning repository](https://github.com/dotnet/machinelearning/issues).
 
-> [!NOTE]
-> Currently, ML.NET does not support machine learning tasks with images. Support will be added in future releases. 
-
 ## Binary classification
 
 A [supervised machine learning](glossary.md#supervised-machine-learning) task that is used to predict which of two classes (categories) an instance of data belongs to. The input of a classification algorithm is a set of labeled examples, where each label is an integer of either 0 or 1. The output of a binary classification algorithm is a classifier, which you can use to predict the class of new unlabeled instances. Examples of binary classification scenarios include:
 
 * [Understanding sentiment of Twitter comments](../tutorials/sentiment-analysis.md) as either "positive" or "negative".
 * Diagnosing whether a patient has a certain disease or not.
 * Making a decision to mark an email as "spam" or not.
+* Determining if a photo contains a dog or fruit.
 
 For more information, see the [Binary classification](https://en.wikipedia.org/wiki/Binary_classification) article on Wikipedia.
 
+Recommended learners for binary classification:
+
+* AveragedPerceptronTrainer
+* StochasticGradientDescentClassificationTrainer
+* LightGbmBinaryTrainer
+* FastTreeBinaryClassificationTrainer
+* SymSgdClassificationTrainer
+
+### Binary Classification Learners
+
+The following learners are available for binary classification tasks:
+
+* [AveragedPerceptronTrainer](xref:Microsoft.ML.Trainers.Online.AveragedPerceptronTrainer)
+* [BinaryClassificationGamTrainer](xref:Microsoft.ML.Trainers.FastTree.BinaryClassificationGamTrainer)
+* [EnsembleTrainer](xref:Microsoft.ML.Runtime.Ensemble.EnsembleTrainer)
+* [FastForestClassification](xref:Microsoft.ML.Trainers.FastTree.FastForestClassification)
+* [FastTreeBinaryClassificationTrainer](xref:Microsoft.ML.Trainers.FastTree.FastTreeBinaryClassificationTrainer)
+* [FieldAwareFactorizationMachineTrainer](xref:Microsoft.ML.Runtime.FactorizationMachine.FieldAwareFactorizationMachineTrainer)
+* [LightGbmBinaryTrainer](xref:Microsoft.ML.Runtime.LightGBM.LightGbmBinaryTrainer)
+* [LinearClassificationTrainer](xref:Microsoft.ML.Trainers.LinearClassificationTrainer)
+* [LinearSvm](xref:Microsoft.ML.Trainers.Online.LinearSvm)
+* [PriorTrainer](xref:Microsoft.ML.Runtime.Learners.PriorTrainer)
+* [RandomTrainer](xref:Microsoft.ML.Runtime.Learners.RandomTrainer)
+* [StochasticGradientDescentClassificationTrainer](xref:Microsoft.ML.Trainers.StochasticGradientDescentClassificationTrainer)
+* [SymSgdClassificationTrainer](xref:Microsoft.ML.Trainers.SymSgd.SymSgdClassificationTrainer)
+
 ## Multiclass classification
 
-A [supervised machine learning](glossary.md#supervised-machine-learning) task that is used to predict the class (category) of an instance of data. The input of a classification algorithm is a set of labeled examples. Each label is an integer between 0 and k-1, where k is the number of classes. The output of a classification algorithm is a classifier, which you can use to predict the class of new unlabeled instances. Examples of multi-class classification scenarios include:
+A [supervised machine learning](glossary.md#supervised-machine-learning) task that is used to predict the class (category) of an instance of data. The input of a classification algorithm is a set of labeled examples. Each label normally starts as text. It is then run through the TermTransform, which converts it to the Key (numeric) type. The output of a classification algorithm is a classifier, which you can use to predict the class of new unlabeled instances. Examples of multi-class classification scenarios include:
 
 * Determining the breed of a dog as a "Siberian Husky", "Golden Retriever", "Poodle", etc.
 * Understanding movie reviews as "positive", "neutral", or "negative".
 * Categorizing hotel reviews as "location", "price", "cleanliness", etc.
 
 For more information, see the [Multiclass classification](https://en.wikipedia.org/wiki/Multiclass_classification) article on Wikipedia.
 
+Recommended learners for Multi-class:
+
+* OVA-AveragedPerceptronTrainer
+* SdcaMultiClassTrainer
+* LightGbmMulticlassTrainer
+* OVA-FastTreeBinaryClassificationTrainer
+
+>[!NOTE]
+>OVA and PKPD upgrades any [binary classification learner](#binary-classification) to act on multiclass datasets. More information on [Wikipedia] (https://en.wikipedia.org/wiki/Multiclass_classification#One-vs.-rest).
+
+### Multiclass Classification Learners
+
+The following learners are available for multiclass classification tasks:
+
+* [LightGbmMulticlassTrainer](xref:Microsoft.ML.Runtime.LightGBM.LightGbmMulticlassTrainer)
+* [MetaMulticlassTrainer<TTransformer,TModel>](xref:Microsoft.ML.Runtime.Learners.MetaMulticlassTrainer%602)
+* [MultiClassClassificationTrainers](xref:Microsoft.ML.Trainers.MultiClassClassificationTrainers)
+* [MulticlassDataPartitionEnsembleTrainer](xref:Microsoft.ML.Runtime.Ensemble.MulticlassDataPartitionEnsembleTrainer)
+* [MultiClassNaiveBayesTrainer](xref:Microsoft.ML.Trainers.MultiClassNaiveBayesTrainer)
+* [Ova](xref:Microsoft.ML.Runtime.Learners.Ova)
+* [Pkpd](xref:Microsoft.ML.Runtime.Learners.Pkpd)
+* [SdcaMultiClassTrainer](xref:Microsoft.ML.Trainers.SdcaMultiClassTrainer)
+
 ## Regression
 
 A [supervised machine learning](glossary.md#supervised-machine-learning) task that is used to predict the value of the label from a set of related features. The label can be of any real value and is not from a finite set of values as in classification tasks. Regression algorithms model the dependency of the label on its related features to determine how the label will change as the values of the features are varied. The input of a regression algorithm is a set of examples with labels of known values. The output of a regression algorithm is a function, which you can use to predict the label value for any new set of input features. Examples of regression scenarios include:
@@ -42,8 +89,31 @@ A [supervised machine learning](glossary.md#supervised-machine-learning) task th
 * Predicting future stock prices based on historical data and current market trends.
 * Predicting sales of a product based on advertising budgets.
 
-> [!NOTE]
-> Currently, ML.NET is still building support for regression tasks that involve time series.
+Recommended learners for regression:
+
+* FastTreeTweedieTrainer 
+* LightGbmRegressorTrainer 
+* SdcaRegressionTrainer 
+* FastTreeRegressionTrainer
+
+### Regression Learners
+
+The following learners are available for regression tasks:
+
+* [FastTreeRegressionTrainer](xref:Microsoft.ML.Trainers.FastTree.FastTreeRegressionTrainer)
+* [FastTreeRegressionFastTreeTrainer](xref:Microsoft.ML.Runtime.FastTreeRegressionFastTreeTrainer)
+* [FastTreeTweedieRegressionFastTreeTrainer](xref:Microsoft.ML.Runtime.FastTreeTweedieRegressionFastTreeTrainer)
+* [FastTreeTweedieTrainer](xref:Microsoft.ML.Trainers.FastTree.FastTreeTweedieTrainer)
+* [LightGbmRegressorTrainer](xref:Microsoft.ML.Runtime.LightGBM.LightGbmRegressorTrainer)
+* [LogisticRegression](xref:Microsoft.ML.Runtime.Learners.LogisticRegression)
+* [OlsLinearRegressionTrainer](xref:Microsoft.ML.Trainers.HalLearners.OlsLinearRegressionTrainer)
+* [OnlineGradientDescentTrainer](xref:Microsoft.ML.Trainers.Online.OnlineGradientDescentTrainer)
+* [PoissonRegression](xref:Microsoft.ML.Trainers.PoissonRegression)
+* [RegressionEnsembleTrainer](xref:Microsoft.ML.Runtime.Ensemble.RegressionEnsembleTrainer)
+* [RegressionGamTrainer](xref:Microsoft.ML.Trainers.FastTree.RegressionGamTrainer)
+* [SdcaRegressionTrainer](xref:Microsoft.ML.Trainers.SdcaRegressionTrainer)
+* [FastTree.SingleTrainer](xref:Microsoft.ML.Trainers.FastTree.SingleTrainer)
+* [LightGBM.SingleTrainer](xref:Microsoft.ML.Runtime.LightGBM.SingleTrainer)
 
 ## Clustering
 
@@ -53,9 +123,52 @@ An [unsupervised machine learning](glossary.md#unsupervised-machine-learning) ta
 * Identifying customer segments and demographics to help build targeted advertising campaigns.
 * Categorizing inventory based on manufacturing metrics.
 
-## Anomaly detection (*coming soon*)
+### Clustering Learners
+
+The following learners are available for clustering tasks:
+
+* [KMeansPlusPlusTrainer](xref:Microsoft.ML.Trainers.KMeans.KMeansPlusPlusTrainer)
+
+## Anomaly detection
+
+This task creates an anomaly detection model by using Principal Component Analysis (PCA). PCA-Based Anomaly Detection helps you build a model in scenarios where it is easy to obtain training data from one class, such as valid transactions, but difficult to obtain sufficient samples of the targeted anomalies.
+
+An established technique in machine learning, PCA is frequently used in exploratory data analysis because it reveals the inner structure of the data and explains the variance in the data. PCA works by analyzing data that contains multiple variables. It looks for correlations among the variables and determines the combination of values that best captures differences in outcomes. These combined feature values are used to create a more compact feature space called the principal components.
+
+Anomaly detection encompasses many important tasks in machine learning:
+
+* Identifying transactions that are potentially fraudulent.
+* Learning patterns that indicate that a network intrusion has occurred.
+* Finding abnormal clusters of patients.
+* Checking values entered into a system.
+
+Because anomalies are rare events by definition, it can be difficult to collect a representative sample of data to use for modeling. The algorithms included in this category have been especially designed to address the core challenges of building and training models by using imbalanced data sets.
+
+### Anomaly detection learners
+
+The following learners are available for anomaly detection tasks:
+
+* [RandomizedPcaTrainer](xref:Microsoft.ML.Trainers.PCA.RandomizedPcaTrainer)
+
+## Ranking
+
+A ​​​​​​​​​ranking task constructs a ranker from a set of labeled examples. This example set consists of instance groups that can be scored with a given criteria. The ranking labels are { 0, 1, 2, 3, 4 } for each instance.  The ranker is trained to rank new instance groups with unknown scores for each instance. ML.NET ranking learners are [machine learned ranking](https://en.wikipedia.org/wiki/Learning_to_rank) based.
+
+### Ranking learners
+
+The following learners are available for ranking tasks:
+
+* [FastTreeRankingFastTreeTrainer](xref:Microsoft.ML.Runtime.FastTreeRankingFastTreeTrainer)
+* [FastTreeRankingTrainer](xref:Microsoft.ML.Trainers.FastTree.FastTreeRankingTrainer)
+* [LightGbmRankingTrainer](xref:Microsoft.ML.Runtime.LightGBM.LightGbmRankingTrainer)
+
+## Recommendation
+
+A recommendation task enables producing a list of recommended products or services. ML.NET uses [Matrix factorization (MF)](https://en.wikipedia.org/wiki/Matrix_factorization_%28recommender_systems%29), a [collaborative filtering](https://en.wikipedia.org/wiki/Collaborative_filtering) algorithm for recommendations when you have historical product rating data in your catalog. For example, you have historical movie rating data for your users and want to recommend  other movies they are likely to watch next.
 
-## Ranking (*coming soon*)
+### Recommendation learners
 
-## Recommendation (*coming soon*)
+The following learners are available for recommendation tasks:
 
+* [MatrixFactorizationTrainer](xref:Microsoft.ML.Trainers.MatrixFactorizationTrainer)
+* [MatrixFactorizationPredictionTransformer](xref:Microsoft.ML.Trainers.Recommender.MatrixFactorizationPredictionTransformer)