Skip to content

Commit 091a6ae

Browse files
authored
General clean-up of ML.NET docs (#43970)
1 parent 860d644 commit 091a6ae

File tree

54 files changed

+557
-545
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+557
-545
lines changed

.openpublishing.redirection.machine-learning.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,11 @@
99
"redirect_url": "/dotnet/machine-learning/how-does-mldotnet-work",
1010
"redirect_document_id": true
1111
},
12+
{
13+
"source_path_from_root": "/docs/machine-learning/how-does-mldotnet-work.md",
14+
"redirect_url": "/dotnet/machine-learning/mldotnet-api",
15+
"redirect_document_id": true
16+
},
1217
{
1318
"source_path_from_root": "/docs/machine-learning/how-to-guides/consuming-model-ml-net.md",
1419
"redirect_url": "/dotnet/machine-learning/how-to-guides/save-load-machine-learning-models-ml-net",
@@ -80,6 +85,11 @@
8085
"source_path_from_root": "/docs/machine-learning/resources/what-is-mldotnet.md",
8186
"redirect_url": "/dotnet/machine-learning/how-does-mldotnet-work"
8287
},
88+
{
89+
"source_path_from_root": "/docs/machine-learning/resources/index.md",
90+
"redirect_url": "/dotnet/machine-learning/resources/glossary",
91+
"redirect_document_id": true
92+
},
8393
{
8494
"source_path_from_root": "/docs/machine-learning/tutorials/ml-cli.md",
8595
"redirect_url": "/dotnet/machine-learning/tutorials/sentiment-analysis-cli",

docs/csharp/language-reference/builtin-types/floating-point-numeric-types.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ The *floating-point numeric types* represent real numbers. All floating-point nu
2626
## Characteristics of the floating-point types
2727

2828
C# supports the following predefined floating-point types:
29-
29+
3030
|C# type/keyword|Approximate range|Precision|Size|.NET type|
3131
|----------|-----------------------|---------------|--------------|--------------|
3232
|`float`|±1.5 x 10<sup>−45</sup> to ±3.4 x 10<sup>38</sup>|~6-9 digits|4 bytes|<xref:System.Single?displayProperty=nameWithType>|
@@ -42,7 +42,7 @@ System.Double b = 12.3;
4242

4343
The default value of each floating-point type is zero, `0`. Each of the floating-point types has the `MinValue` and `MaxValue` constants that provide the minimum and maximum finite value of that type. The `float` and `double` types also provide constants that represent not-a-number and infinity values. For example, the `double` type provides the following constants: <xref:System.Double.NaN?displayProperty=nameWithType>, <xref:System.Double.NegativeInfinity?displayProperty=nameWithType>, and <xref:System.Double.PositiveInfinity?displayProperty=nameWithType>.
4444

45-
The `decimal` type is appropriate when the required degree of precision is determined by the number of digits to the right of the decimal point. Such numbers are commonly used in financial applications, for currency amounts (for example, $1.00), interest rates (for example, 2.625%), and so forth. Even numbers that are precise to only one decimal digit are handled more accurately by the `decimal` type: 0.1, for example, can be exactly represented by a `decimal` instance, while there's no `double` or `float` instance that exactly represents 0.1. Because of this difference in numeric types, unexpected rounding errors can occur in arithmetic calculations when you use `double` or `float` for decimal data. You can use `double` instead of `decimal` when optimizing performance is more important than ensuring accuracy. However, any difference in performance would go unnoticed by all but the most calculation-intensive applications. Another possible reason to avoid `decimal` is to minimize storage requirements. For example, [ML.NET](../../../machine-learning/how-does-mldotnet-work.md) uses `float` because the difference between 4 bytes and 16 bytes adds up for very large data sets. For more information, see <xref:System.Decimal?displayProperty=nameWithType>.
45+
The `decimal` type is appropriate when the required degree of precision is determined by the number of digits to the right of the decimal point. Such numbers are commonly used in financial applications, for currency amounts (for example, $1.00), interest rates (for example, 2.625%), and so forth. Even numbers that are precise to only one decimal digit are handled more accurately by the `decimal` type: 0.1, for example, can be exactly represented by a `decimal` instance, while there's no `double` or `float` instance that exactly represents 0.1. Because of this difference in numeric types, unexpected rounding errors can occur in arithmetic calculations when you use `double` or `float` for decimal data. You can use `double` instead of `decimal` when optimizing performance is more important than ensuring accuracy. However, any difference in performance would go unnoticed by all but the most calculation-intensive applications. Another possible reason to avoid `decimal` is to minimize storage requirements. For example, [ML.NET](../../../machine-learning/mldotnet-api.md) uses `float` because the difference between 4 bytes and 16 bytes adds up for very large data sets. For more information, see <xref:System.Decimal?displayProperty=nameWithType>.
4646

4747
You can mix [integral](integral-numeric-types.md) types and the `float` and `double` types in an expression. In this case, integral types are implicitly converted to one of the floating-point types and, if necessary, the `float` type is implicitly converted to `double`. The expression is evaluated as follows:
4848

docs/machine-learning/automate-training-with-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ To use the ML.NET API by itself, (without the ML.NET AutoML CLI) you need to cho
1414
The ML.NET CLI simplifies this process using automated machine learning (AutoML).
1515

1616
> [!NOTE]
17-
> This article refers to ML.NET **CLI** and ML.NET **AutoML**, which are currently in Preview, and material may be subject to change.
17+
> This article refers to ML.NET **CLI** and ML.NET **AutoML**, which are currently in preview, and material is subject to change.
1818
1919
## What is the ML.NET command-line interface (CLI)?
2020

docs/machine-learning/automated-machine-learning-mlnet.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ ms.custom: mvc
1111
Automated machine learning (AutoML) automates the process of applying machine learning to data. Given a dataset, you can run AutoML to iterate over different data transformations, machine learning algorithms, and hyperparameters to select the best model.
1212

1313
> [!NOTE]
14-
> This article refers to the ML.NET AutoML API, which is currently in preview. Material may be subject to change.
14+
> This article refers to the ML.NET AutoML API, which is currently in preview. Material is subject to change.
1515
1616
## How does AutoML work?
1717

@@ -37,11 +37,11 @@ Whether you're just getting started with machine learning or you're an experienc
3737
## AutoML in ML.NET
3838

3939
- **Featurizer** - Convenience API to automate data preprocessing.
40-
- **Trial** - A single hyperparamters optimization run.
40+
- **Trial** - A single hyperparameters optimization run.
4141
- **Experiment** - A collection of AutoML trials. ML.NET provides a high-level API for creating experiments which sets defaults for the individual Sweepable Pipeline, Search Space, and Tuner components.
4242
- **Search Space** - The range of available options to choose hyperparameters from.
4343
- **Tuner** - The algorithms used to optimize hyperparameters. ML.NET supports the following tuners:
44-
- **Cost Frugal Tuner** - Implementation of [Frugal Optimization for Cost-related Hyperparameters](https://arxiv.org/abs/2005.01571) which takes training cost into consideration
44+
- **Cost Frugal Tuner** - Implementation of [Frugal Optimization for Cost-related Hyperparameters](https://arxiv.org/abs/2005.01571), which takes training cost into consideration
4545
- **Eci Cost Frugal Tuner** - Implementation of Cost Frugal Tuner for hierarchical search spaces. Default tuner used by AutoML.
4646
- **SMAC** - Tuner that uses random forests to apply Bayesian optimization.
4747
- **Grid Search** - Tuner that works best for small search spaces.
@@ -50,7 +50,7 @@ Whether you're just getting started with machine learning or you're an experienc
5050
- **Sweepable Pipeline** - An ML.NET pipeline that contains one or more Sweepable Estimators.
5151
- **Trial Runner** - AutoML component that uses sweepable pipelines and trial settings to generate trial results from model training and evaluation.
5252

53-
It's recommended for beginners to start with the defaults provided by the high-level experiment API. For more experienced users looking for customization options, use the sweepable estimator, sweepable pipeline, search space, trial runner and tuner components.
53+
It's recommended for beginners to start with the defaults provided by the high-level experiment API. For more experienced users looking for customization options, use the sweepable estimator, sweepable pipeline, search space, trial runner, and tuner components.
5454

5555
For more information on getting started with the AutoML API, see the [How to use the ML.NET Automated Machine Learning (AutoML) API](how-to-guides/how-to-use-the-automl-api.md) guide.
5656

0 commit comments

Comments
 (0)