Skip to content

Conversation

@lcawl
Copy link
Contributor

@lcawl lcawl commented Feb 11, 2021

Related to #67950 and elastic/kibana#90738

This PR edits the descriptions of the machine learning data frame analytics hyperparameters, which are used in several APIs.

@lcawl lcawl added >docs General docs changes :ml Machine learning v8.0.0 v7.12.0 labels Feb 11, 2021
@lcawl lcawl marked this pull request as ready for review February 11, 2021 03:46
@elasticmachine elasticmachine added Team:ML Meta label for the ML team Team:Docs Meta label for docs team labels Feb 11, 2021
@elasticmachine
Copy link
Collaborator

Pinging @elastic/ml-core (Team:ML)

@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-docs (Team:Docs)

Copy link
Contributor

@dimitris-athanasiou dimitris-athanasiou left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM Much nicer wording!

quickly. This parameter affects loss calculations by acting as a multiplier of
the tree depth. Higher alpha values result in shallower trees and faster
training times.
//TBD: but potentially reduce accuracy?
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unfortunately this is quite nuanced and very much data-dependent. I think we might be better off without mentioning anything more here for now. @valeriy42 is working on an example notebook that goes into more detail on explaining hyperparameters. When that is ready we can probably link to that for users that want to delve into the more nuanced details.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good to me, thanks! I'll remove that TBD

Copy link
Contributor

@szabosteve szabosteve left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for these changes. LGTM!

@lcawl lcawl merged commit 8b6ec07 into elastic:master Feb 11, 2021
@lcawl lcawl deleted the ml-alpha branch February 11, 2021 19:55
lcawl added a commit to lcawl/elasticsearch that referenced this pull request Feb 11, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

>docs General docs changes :ml Machine learning Team:Docs Meta label for docs team Team:ML Meta label for the ML team v7.12.0 v8.0.0-alpha1

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants