xgboost
linear_updater.h
Go to the documentation of this file.
1 /*
2  * Copyright 2018 by Contributors
3  */
4 #pragma once
5 
6 #include <dmlc/registry.h>
7 #include <xgboost/base.h>
8 #include <xgboost/data.h>
10 #include <xgboost/model.h>
11 
12 #include <functional>
13 #include <string>
14 #include <utility>
15 #include <vector>
16 
17 
18 namespace xgboost {
19 
20 class Json;
21 struct Context;
22 
23 namespace gbm {
24 class GBLinearModel;
25 } // namespace gbm
26 
30 class LinearUpdater : public Configurable {
31  protected:
32  Context const* ctx_;
33 
34  public:
36  ~LinearUpdater() override = default;
41  virtual void Configure(
42  const std::vector<std::pair<std::string, std::string> >& args) = 0;
43 
52  virtual void Update(linalg::Matrix<GradientPair>* in_gpair, DMatrix* data,
53  gbm::GBLinearModel* model, double sum_instance_weight) = 0;
54 
59  static LinearUpdater* Create(const std::string& name, Context const*);
60 };
61 
66  : public dmlc::FunctionRegEntryBase<LinearUpdaterReg,
67  std::function<LinearUpdater*()> > {};
68 
72 #define XGBOOST_REGISTER_LINEAR_UPDATER(UniqueId, Name) \
73  static DMLC_ATTRIBUTE_UNUSED ::xgboost::LinearUpdaterReg& \
74  __make_##LinearUpdaterReg##_##UniqueId##__ = \
75  ::dmlc::Registry< ::xgboost::LinearUpdaterReg>::Get()->__REGISTER__( \
76  Name)
77 
78 } // namespace xgboost
Defines configuration macros and basic types for xgboost.
Internal data structured used by XGBoost during training.
Definition: data.h:505
interface of linear updater
Definition: linear_updater.h:30
Context const * ctx_
Definition: linear_updater.h:32
virtual void Update(linalg::Matrix< GradientPair > *in_gpair, DMatrix *data, gbm::GBLinearModel *model, double sum_instance_weight)=0
Updates linear model given gradients.
static LinearUpdater * Create(const std::string &name, Context const *)
Create a linear updater given name.
virtual void Configure(const std::vector< std::pair< std::string, std::string > > &args)=0
Initialize the updater with given arguments.
~LinearUpdater() override=default
virtual destructor
A tensor storage. To use it for other functionality like slicing one needs to obtain a view first....
Definition: linalg.h:762
The input data structure of xgboost.
A device-and-host vector abstraction layer.
Defines the abstract interface for different components in XGBoost.
Core data structure for multi-target trees.
Definition: base.h:87
Definition: model.h:31
Runtime context for XGBoost. Contains information like threads and device.
Definition: context.h:133
Registry entry for linear updater.
Definition: linear_updater.h:67