Skip to content

Commit

Permalink
Update documentation.
Browse files Browse the repository at this point in the history
  • Loading branch information
michael-rapp committed Oct 2, 2024
1 parent 4cb654f commit 37fd3f2
Show file tree
Hide file tree
Showing 2 changed files with 80 additions and 0 deletions.
40 changes: 40 additions & 0 deletions doc/user_guide/boosting/parameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -427,6 +427,14 @@ The seed to be used by random number generators. The given value must be at leas
The percentage of features to be included in a sample. For example, a value of 0.6 corresponds to 60% of the features. The given value must be in (0, 1\] or 0, if the sample size should be calculated as log2(A - 1) + 1), where A denotes the number of available features.
- `min_samples` *(Default value = `1`)*
The minimum number of features to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of features to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of features should not be restricted.
- `num_retained` *(Default value = `0`)*
The number of trailing features to be always included in a sample. For example, a value of 2 means that the last two features are always retained.
Expand All @@ -449,26 +457,58 @@ The seed to be used by random number generators. The given value must be at leas
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
`'without-replacement'`
The training examples to be considered for learning a new rule are selected randomly without replacement. The following options may be provided using the {ref}`bracket notation<bracket-notation>`:
- `sample_size` *(Default value = `0.66`)*
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
`'stratified-output-wise'` *(classification only)*
The training examples to be considered for learning a new rule are selected according to an iterative stratified sampling method that ensures that for each label the proportion of relevant and irrelevant examples is maintained. The following options may be provided using the {ref}`bracket notation<bracket-notation>`:
- `sample_size` *(Default value = `0.66`)*
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
`'stratified-example-wise'` (*classification only*)
The training examples to be considered for learning a new rule are selected according to stratified sampling method, where distinct label vectors are treated as individual classes. The following options may be provided using the {ref}`bracket notation<bracket-notation>`:
- `sample_size` *(Default value = `0.66`)*
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
```

## Approximations and Optimizations
Expand Down
40 changes: 40 additions & 0 deletions doc/user_guide/seco/parameters.md
Original file line number Diff line number Diff line change
Expand Up @@ -357,6 +357,14 @@ The seed to be used by random number generators. The given value must be at leas
The percentage of features to be included in a sample. For example, a value of 0.6 corresponds to 60% of the features. The given value must be in (0, 1\] or 0, if the sample size should be calculated as log2(A - 1) + 1), where A denotes the number of available features.
- `min_samples` *(Default value = `1`)*
The minimum number of features to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of features to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of features should not be restricted.
- `num_retained` *(Default value = `0`)*
The number of trailing features to be always included in a sample. For example, a value of 2 means that the last two features are always retained.
Expand All @@ -379,26 +387,58 @@ The seed to be used by random number generators. The given value must be at leas
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
`'without-replacement'`
The training examples to be considered for learning a new rule are selected randomly without replacement. The following options may be provided using the {ref}`bracket notation<bracket-notation>`:
- `sample_size` *(Default value = `0.66`)*
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
`'stratified-output-wise'`
The training examples to be considered for learning a new rule are selected according to an iterative stratified sampling method that ensures that for each label the proportion of relevant and irrelevant examples is maintained. The following options may be provided using the {ref}`bracket notation<bracket-notation>`:
- `sample_size` *(Default value = `0.66`)*
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
`'stratified-example-wise'`
The training examples to be considered for learning a new rule are selected according to stratified sampling method, where distinct label vectors are treated as individual classes. The following options may be provided using the {ref}`bracket notation<bracket-notation>`:
- `sample_size` *(Default value = `0.66`)*
The percentage of examples to be included in a sample. For example, a value of 0.6 corresponds to 60% of the available examples. The given value must be in the range (0, 1).
- `min_samples` *(Default value = `1`)*
The minimum number of examples to be included in a sample. The given value must be at least 1.
- `max_samples` *(Default value = `0`)*
The maximum number of examples to be included in a sample. The given value must be at least the value of `min_samples` or 0, if the number of examples should not be restricted.
```

## Approximations and Optimizations
Expand Down

0 comments on commit 37fd3f2

Please sign in to comment.