setinfo.Rd 1.66 KB
Newer Older
Guolin Ke's avatar
Guolin Ke committed
1
2
3
4
5
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/lgb.Dataset.R
\name{setinfo}
\alias{setinfo}
\alias{setinfo.lgb.Dataset}
Nikita Titov's avatar
Nikita Titov committed
6
\title{Set information of an \code{lgb.Dataset} object}
Guolin Ke's avatar
Guolin Ke committed
7
8
9
10
11
12
\usage{
setinfo(dataset, ...)

\method{setinfo}{lgb.Dataset}(dataset, name, info, ...)
}
\arguments{
Nikita Titov's avatar
Nikita Titov committed
13
\item{dataset}{Object of class \code{lgb.Dataset}}
Guolin Ke's avatar
Guolin Ke committed
14

15
16
\item{...}{other parameters}

Guolin Ke's avatar
Guolin Ke committed
17
18
19
20
21
\item{name}{the name of the field to get}

\item{info}{the specific field of information to set}
}
\value{
22
23
24
the dataset you passed in

the dataset you passed in
Guolin Ke's avatar
Guolin Ke committed
25
26
}
\description{
27
Set one attribute of a \code{lgb.Dataset}
Guolin Ke's avatar
Guolin Ke committed
28
29
30
31
32
}
\details{
The \code{name} field can be one of the following:

\itemize{
33
34
35
36
37
    \item{\code{label}: vector of labels to use as the target variable}
    \item{\code{weight}: to do a weight rescale}
    \item{\code{init_score}: initial score is the base prediction lightgbm will boost from}
    \item{\code{group}: used for learning-to-rank tasks. An integer vector describing how to
        group rows together as ordered results from the same set of candidate results to be ranked.
38
39
40
        For example, if you have a 100-document dataset with \code{group = c(10, 20, 40, 10, 10, 10)},
        that means that you have 6 groups, where the first 10 records are in the first group,
        records 11-30 are in the second group, etc.}
Guolin Ke's avatar
Guolin Ke committed
41
42
43
}
}
\examples{
44
\donttest{
Guolin Ke's avatar
Guolin Ke committed
45
46
47
48
49
50
51
52
53
54
data(agaricus.train, package = "lightgbm")
train <- agaricus.train
dtrain <- lgb.Dataset(train$data, label = train$label)
lgb.Dataset.construct(dtrain)

labels <- lightgbm::getinfo(dtrain, "label")
lightgbm::setinfo(dtrain, "label", 1 - labels)

labels2 <- lightgbm::getinfo(dtrain, "label")
stopifnot(all.equal(labels2, 1 - labels))
55
}
Guolin Ke's avatar
Guolin Ke committed
56
}