Skip to content

Add XML doc to the ITrainerEstimator interface #2847

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 12, 2019

Conversation

jwood803
Copy link
Contributor

@jwood803 jwood803 commented Mar 5, 2019

Just a quick draft for the XML docs to help fix #2629

@codecov
Copy link

codecov bot commented Mar 5, 2019

Codecov Report

Merging #2847 into master will increase coverage by 0.1%.
The diff coverage is n/a.

@@            Coverage Diff            @@
##           master    #2847     +/-   ##
=========================================
+ Coverage   71.71%   71.81%   +0.1%     
=========================================
  Files         809      812      +3     
  Lines      142522   142644    +122     
  Branches    16114    16090     -24     
=========================================
+ Hits       102203   102441    +238     
+ Misses      35884    35822     -62     
+ Partials     4435     4381     -54
Flag Coverage Δ
#Debug 71.81% <ø> (+0.1%) ⬆️
#production 67.96% <ø> (+0.02%) ⬆️
#test 86.25% <ø> (+0.34%) ⬆️
Impacted Files Coverage Δ
src/Microsoft.ML.FastTree/RegressionTree.cs 71.42% <0%> (-12.25%) ⬇️
...soft.ML.FastTree/Training/EarlyStoppingCriteria.cs 71.73% <0%> (-11.47%) ⬇️
src/Microsoft.ML.Core/Data/ProgressReporter.cs 70.95% <0%> (-6.99%) ⬇️
...oft.ML.Data/Dirty/ChooseColumnsByIndexTransform.cs 92.59% <0%> (-5.19%) ⬇️
...c/Microsoft.ML.SamplesUtils/SamplesDatasetUtils.cs 18.88% <0%> (-4.85%) ⬇️
...rc/Microsoft.ML.Data/Scorers/RowToRowScorerBase.cs 87.5% <0%> (-3.04%) ⬇️
src/Microsoft.ML.Data/Transforms/RangeFilter.cs 69.51% <0%> (-2.85%) ⬇️
...rosoft.ML.Data/DataView/CompositeRowToRowMapper.cs 49.09% <0%> (-2.64%) ⬇️
...t.ML.Data/Transforms/ValueToKeyMappingEstimator.cs 85.18% <0%> (-1.61%) ⬇️
src/Microsoft.ML.Data/Transforms/TransformBase.cs 54.41% <0%> (-1.35%) ⬇️
... and 543 more

/// <summary>
/// Interface for the Trainer Estimator.
/// </summary>
/// <typeparam name="TTransformer"></typeparam>
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
/// <typeparam name="TTransformer"></typeparam>
/// <typeparam name="TTransformer">The type of the transformer returned by the estimator.</typeparam>

/// Interface for the Trainer Estimator.
/// </summary>
/// <typeparam name="TTransformer"></typeparam>
/// <typeparam name="TPredictor"></typeparam>
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
/// <typeparam name="TPredictor"></typeparam>
/// <typeparam name="TPredictor">The type of the model parameters.</typeparam>

/// Interface for the Trainer Estimator.
/// </summary>
/// <typeparam name="TTransformer"></typeparam>
/// <typeparam name="TPredictor"></typeparam>
public interface ITrainerEstimator<out TTransformer, out TPredictor> : IEstimator<TTransformer>
Copy link
Contributor

Choose a reason for hiding this comment

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

Interesting! It's still named TPredictor, we have switched to TModel in out public facing API. If you could rename it here it would be great!

Copy link
Contributor

@Ivanidzo4ka Ivanidzo4ka left a comment

Choose a reason for hiding this comment

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

:shipit:

Copy link
Contributor

@artidoro artidoro left a comment

Choose a reason for hiding this comment

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

🚀

@artidoro artidoro merged commit 40abffc into dotnet:master Mar 12, 2019
@jwood803 jwood803 deleted the training-estimator-doc branch March 12, 2019 09:52
@ghost ghost locked as resolved and limited conversation to collaborators Mar 23, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

ITrainerEstimator lack of documenation
3 participants