lightgbm_R.h 15.1 KB
Newer Older
Guolin Ke's avatar
Guolin Ke committed
1
2
3
#ifndef LIGHTGBM_R_H_
#define LIGHTGBM_R_H_

Guolin Ke's avatar
Guolin Ke committed
4
5
#include "R_object_helper.h"

Guolin Ke's avatar
Guolin Ke committed
6
7
8
9
10
11
#include <cstdint>
#include <LightGBM/c_api.h>


/*!
* \brief get string message of the last error
12
13
*  all functions in this file will return 0 on success
*  and -1 when an error occured
Guolin Ke's avatar
Guolin Ke committed
14
15
16
* \return err_msg error inforomation
* \return error inforomation
*/
Guolin Ke's avatar
Guolin Ke committed
17
LIGHTGBM_C_EXPORT LGBM_SE LGBM_GetLastError_R(LGBM_SE buf_len, LGBM_SE actual_len, LGBM_SE err_msg);
Guolin Ke's avatar
Guolin Ke committed
18
19
20
21

// --- start Dataset interface

/*!
22
* \brief load data set from file like the command_line LightGBM does
Guolin Ke's avatar
Guolin Ke committed
23
24
* \param filename the name of the file
* \param parameters additional parameters
25
* \param reference used to align bin mapper with other dataset, nullptr means not used
Guolin Ke's avatar
Guolin Ke committed
26
27
28
* \param out created dataset
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
29
30
31
32
33
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetCreateFromFile_R(LGBM_SE filename,
  LGBM_SE parameters,
  LGBM_SE reference,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
34
35
36
37
38
39
40
41
42
43

/*!
* \brief create a dataset from CSC format
* \param indptr pointer to row headers
* \param indices findex
* \param data fvalue
* \param nindptr number of cols in the matrix + 1
* \param nelem number of nonzero elements in the matrix
* \param num_row number of rows
* \param parameters additional parameters
44
* \param reference used to align bin mapper with other dataset, nullptr means not used
Guolin Ke's avatar
Guolin Ke committed
45
46
47
* \param out created dataset
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
48
49
50
51
52
53
54
55
56
57
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetCreateFromCSC_R(LGBM_SE indptr,
  LGBM_SE indices,
  LGBM_SE data,
  LGBM_SE nindptr,
  LGBM_SE nelem,
  LGBM_SE num_row,
  LGBM_SE parameters,
  LGBM_SE reference,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
58
59
60
61
62
63
64
65


/*!
* \brief create dataset from dense matrix
* \param data matric data
* \param nrow number of rows
* \param ncol number columns
* \param parameters additional parameters
66
* \param reference used to align bin mapper with other dataset, nullptr means not used
Guolin Ke's avatar
Guolin Ke committed
67
68
69
* \param out created dataset
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
70
71
72
73
74
75
76
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetCreateFromMat_R(LGBM_SE data,
  LGBM_SE nrow,
  LGBM_SE ncol,
  LGBM_SE parameters,
  LGBM_SE reference,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
77
78
79
80
81
82
83
84
85
86

/*!
* \brief Create subset of a data
* \param handle handle of full dataset
* \param used_row_indices Indices used in subset
* \param len_used_row_indices length of Indices used in subset
* \param parameters additional parameters
* \param out created dataset
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
87
88
89
90
91
92
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetGetSubset_R(LGBM_SE handle,
  LGBM_SE used_row_indices,
  LGBM_SE len_used_row_indices,
  LGBM_SE parameters,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
93
94
95
96
97
98
99

/*!
* \brief save feature names to Dataset
* \param handle handle
* \param feature_names feature names
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
100
101
102
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetSetFeatureNames_R(LGBM_SE handle,
  LGBM_SE feature_names,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
103
104
105
106
107
108
109

/*!
* \brief save feature names to Dataset
* \param handle handle
* \param feature_names feature names
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
110
111
112
113
114
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetGetFeatureNames_R(LGBM_SE handle,
  LGBM_SE buf_len,
  LGBM_SE actual_len,
  LGBM_SE feature_names,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
115
116
117

/*!
* \brief save dateset to binary file
118
* \param handle an instance of dataset
Guolin Ke's avatar
Guolin Ke committed
119
120
121
* \param filename file name
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
122
123
124
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetSaveBinary_R(LGBM_SE handle,
  LGBM_SE filename,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
125
126
127

/*!
* \brief free dataset
128
* \param handle an instance of dataset
Guolin Ke's avatar
Guolin Ke committed
129
130
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
131
132
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetFree_R(LGBM_SE handle,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
133
134
135

/*!
* \brief set vector to a content in info
136
*        Note: group and group_id only work for C_API_DTYPE_INT32
Guolin Ke's avatar
Guolin Ke committed
137
*              label and weight only work for C_API_DTYPE_FLOAT32
138
* \param handle an instance of dataset
Guolin Ke's avatar
Guolin Ke committed
139
140
141
142
143
* \param field_name field name, can be label, weight, group, group_id
* \param field_data pointer to vector
* \param num_element number of element in field_data
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
144
145
146
147
148
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetSetField_R(LGBM_SE handle,
  LGBM_SE field_name,
  LGBM_SE field_data,
  LGBM_SE num_element,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
149
150
151

/*!
* \brief get size of info vector from dataset
152
* \param handle an instance of dataset
Guolin Ke's avatar
Guolin Ke committed
153
154
155
156
* \param field_name field name
* \param out size of info vector from dataset
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
157
158
159
160
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetGetFieldSize_R(LGBM_SE handle,
  LGBM_SE field_name,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
161
162
163

/*!
* \brief get info vector from dataset
164
* \param handle an instance of dataset
Guolin Ke's avatar
Guolin Ke committed
165
166
167
168
* \param field_name field name
* \param field_data pointer to vector
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
169
170
171
172
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetGetField_R(LGBM_SE handle,
  LGBM_SE field_name,
  LGBM_SE field_data,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
173

174
175
176
177
178
179
180
181
182
183
/*!
* \brief Update parameters for a Dataset
* \param handle a instance of data matrix
* \param parameters parameters
* \return 0 when succeed, -1 when failure happens
*/
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetUpdateParam_R(LGBM_SE handle,
  LGBM_SE params,
  LGBM_SE call_state);

Guolin Ke's avatar
Guolin Ke committed
184
185
186
187
188
189
/*!
* \brief get number of data.
* \param handle the handle to the dataset
* \param out The address to hold number of data
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
190
191
192
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetGetNumData_R(LGBM_SE handle,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
193
194
195
196
197
198
199

/*!
* \brief get number of features
* \param handle the handle to the dataset
* \param out The output of number of features
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
200
201
202
LIGHTGBM_C_EXPORT LGBM_SE LGBM_DatasetGetNumFeature_R(LGBM_SE handle,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
203
204
205
206
207
208
209
210
211
212

// --- start Booster interfaces

/*!
* \brief create an new boosting learner
* \param train_data training data set
* \param parameters format: 'key1=value1 key2=value2'
* \prama out handle of created Booster
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
213
214
215
216
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterCreate_R(LGBM_SE train_data,
  LGBM_SE parameters,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
217
218
219
220
221
222

/*!
* \brief free obj in handle
* \param handle handle to be freed
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
223
224
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterFree_R(LGBM_SE handle,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
225
226
227
228
229
230
231

/*!
* \brief load an existing boosting from model file
* \param filename filename of model
* \prama out handle of created Booster
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
232
233
234
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterCreateFromModelfile_R(LGBM_SE filename,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
235

236
237
238
239
240
241
242
243
244
/*!
* \brief load an existing boosting from model_str
* \param model_str string containing the model
* \param out handle of created Booster
* \return 0 when succeed, -1 when failure happens
*/
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterLoadModelFromString_R(LGBM_SE model_str,
  LGBM_SE out,
  LGBM_SE call_state);
245

Guolin Ke's avatar
Guolin Ke committed
246
/*!
247
* \brief Merge model in two boosters to first handle
Guolin Ke's avatar
Guolin Ke committed
248
249
250
251
* \param handle handle, will merge other handle to this
* \param other_handle
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
252
253
254
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterMerge_R(LGBM_SE handle,
  LGBM_SE other_handle,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
255
256
257
258
259
260
261

/*!
* \brief Add new validation to booster
* \param handle handle
* \param valid_data validation data set
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
262
263
264
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterAddValidData_R(LGBM_SE handle,
  LGBM_SE valid_data,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
265
266
267
268
269
270
271

/*!
* \brief Reset training data for booster
* \param handle handle
* \param train_data training data set
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
272
273
274
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterResetTrainingData_R(LGBM_SE handle,
  LGBM_SE train_data,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
275
276
277
278
279
280
281

/*!
* \brief Reset config for current booster
* \param handle handle
* \param parameters format: 'key1=value1 key2=value2'
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
282
283
284
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterResetParameter_R(LGBM_SE handle,
  LGBM_SE parameters,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
285
286

/*!
287
* \brief Get number of classes
Guolin Ke's avatar
Guolin Ke committed
288
289
290
291
* \param handle handle
* \param out number of classes
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
292
293
294
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterGetNumClasses_R(LGBM_SE handle,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
295
296
297
298
299
300

/*!
* \brief update the model in one round
* \param handle handle
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
301
302
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterUpdateOneIter_R(LGBM_SE handle,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
303
304
305
306
307
308
309
310
311
312

/*!
* \brief update the model, by directly specify gradient and second order gradient,
*       this can be used to support customized loss function
* \param handle handle
* \param grad gradient statistics
* \param hess second order gradient statistics
* \param len length of grad/hess
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
313
314
315
316
317
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterUpdateOneIterCustom_R(LGBM_SE handle,
  LGBM_SE grad,
  LGBM_SE hess,
  LGBM_SE len,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
318
319
320
321
322
323

/*!
* \brief Rollback one iteration
* \param handle handle
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
324
325
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterRollbackOneIter_R(LGBM_SE handle,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
326
327
328
329
330
331

/*!
* \brief Get iteration of current boosting rounds
* \param out iteration of boosting rounds
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
332
333
334
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterGetCurrentIteration_R(LGBM_SE handle,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
335
336
337
338
339
340

/*!
* \brief Get Name of eval
* \param eval_names eval names
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
341
342
343
344
345
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterGetEvalNames_R(LGBM_SE handle,
  LGBM_SE buf_len,
  LGBM_SE actual_len,
  LGBM_SE eval_names,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
346
347
348
349
350
351
352
353

/*!
* \brief get evaluation for training data and validation data
* \param handle handle
* \param data_idx 0:training data, 1: 1st valid data, 2:2nd valid data ...
* \param out_result float arrary contains result
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
354
355
356
357
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterGetEval_R(LGBM_SE handle,
  LGBM_SE data_idx,
  LGBM_SE out_result,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
358
359
360
361
362
363
364
365

/*!
* \brief Get number of prediction for training data and validation data
* \param handle handle
* \param data_idx 0:training data, 1: 1st valid data, 2:2nd valid data ...
* \param out size of predict
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
366
367
368
369
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterGetNumPredict_R(LGBM_SE handle,
  LGBM_SE data_idx,
  LGBM_SE out,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
370
371

/*!
372
373
* \brief Get prediction for training data and validation data.
*        This can be used to support customized eval function
Guolin Ke's avatar
Guolin Ke committed
374
375
376
377
378
* \param handle handle
* \param data_idx 0:training data, 1: 1st valid data, 2:2nd valid data ...
* \param out_result, used to store predict result, should pre-allocate memory
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
379
380
381
382
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterGetPredict_R(LGBM_SE handle,
  LGBM_SE data_idx,
  LGBM_SE out_result,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
383
384
385
386
387
388
389
390
391
392
393
394

/*!
* \brief make prediction for file
* \param handle handle
* \param data_filename filename of data file
* \param data_has_header data file has header or not
* \param is_rawscore
* \param is_leafidx
* \param num_iteration number of iteration for prediction, <= 0 means no limit
* \return 0 when succeed, -1 when failure happens
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
395
396
397
398
399
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterPredictForFile_R(LGBM_SE handle,
  LGBM_SE data_filename,
  LGBM_SE data_has_header,
  LGBM_SE is_rawscore,
  LGBM_SE is_leafidx,
400
  LGBM_SE is_predcontrib,
Guolin Ke's avatar
Guolin Ke committed
401
  LGBM_SE num_iteration,
402
  LGBM_SE parameter,
Guolin Ke's avatar
Guolin Ke committed
403
404
  LGBM_SE result_filename,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
405
406
407
408
409
410
411
412
413
414
415

/*!
* \brief Get number of prediction
* \param handle handle
* \param num_row
* \param is_rawscore
* \param is_leafidx
* \param num_iteration number of iteration for prediction, <= 0 means no limit
* \param out_len lenght of prediction
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
416
417
418
419
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterCalcNumPredict_R(LGBM_SE handle,
  LGBM_SE num_row,
  LGBM_SE is_rawscore,
  LGBM_SE is_leafidx,
420
  LGBM_SE is_predcontrib,
Guolin Ke's avatar
Guolin Ke committed
421
422
423
  LGBM_SE num_iteration,
  LGBM_SE out_len,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
424
425
426
427

/*!
* \brief make prediction for an new data set
*        Note:  should pre-allocate memory for out_result,
428
*               for normal and raw score: its length is equal to num_class * num_data
Guolin Ke's avatar
Guolin Ke committed
429
430
431
432
433
434
*               for leaf index, its length is equal to num_class * num_data * num_iteration
* \param handle handle
* \param indptr pointer to row headers
* \param indices findex
* \param data fvalue
* \param nindptr number of cols in the matrix + 1
435
* \param nelem number of non-zero elements in the matrix
Guolin Ke's avatar
Guolin Ke committed
436
437
438
439
440
441
442
* \param num_row number of rows
* \param is_rawscore
* \param is_leafidx
* \param num_iteration number of iteration for prediction, <= 0 means no limit
* \param out prediction result
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
443
444
445
446
447
448
449
450
451
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterPredictForCSC_R(LGBM_SE handle,
  LGBM_SE indptr,
  LGBM_SE indices,
  LGBM_SE data,
  LGBM_SE nindptr,
  LGBM_SE nelem,
  LGBM_SE num_row,
  LGBM_SE is_rawscore,
  LGBM_SE is_leafidx,
452
  LGBM_SE is_predcontrib,
Guolin Ke's avatar
Guolin Ke committed
453
  LGBM_SE num_iteration,
454
  LGBM_SE parameter,
Guolin Ke's avatar
Guolin Ke committed
455
456
  LGBM_SE out_result,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
457
458

/*!
459
* \brief make prediction for a new data set
Guolin Ke's avatar
Guolin Ke committed
460
*        Note:  should pre-allocate memory for out_result,
461
*               for normal and raw score: its length is equal to num_class * num_data
Guolin Ke's avatar
Guolin Ke committed
462
463
464
465
466
467
468
469
470
471
472
*               for leaf index, its length is equal to num_class * num_data * num_iteration
* \param handle handle
* \param data pointer to the data space
* \param nrow number of rows
* \param ncol number columns
* \param is_rawscore
* \param is_leafidx
* \param num_iteration number of iteration for prediction, <= 0 means no limit
* \param out prediction result
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
473
474
475
476
477
478
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterPredictForMat_R(LGBM_SE handle,
  LGBM_SE data,
  LGBM_SE nrow,
  LGBM_SE ncol,
  LGBM_SE is_rawscore,
  LGBM_SE is_leafidx,
479
  LGBM_SE is_predcontrib,
Guolin Ke's avatar
Guolin Ke committed
480
  LGBM_SE num_iteration,
481
  LGBM_SE parameter,
Guolin Ke's avatar
Guolin Ke committed
482
483
  LGBM_SE out_result,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
484
485
486
487
488
489
490
491

/*!
* \brief save model into file
* \param handle handle
* \param num_iteration, <= 0 means save all
* \param filename file name
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
492
493
494
495
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterSaveModel_R(LGBM_SE handle,
  LGBM_SE num_iteration,
  LGBM_SE filename,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
496

497
498
499
500
501
502
503
504
505
506
507
508
509
510
/*!
* \brief create string containing model
* \param handle handle
* \param num_iteration, <= 0 means save all
* \param out_str string of model
* \return 0 when succeed, -1 when failure happens
*/
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterSaveModelToString_R(LGBM_SE handle,
  LGBM_SE num_iteration,
  LGBM_SE buffer_len,
  LGBM_SE actual_len,
  LGBM_SE out_str,
  LGBM_SE call_state);

Guolin Ke's avatar
Guolin Ke committed
511
512
513
514
515
516
517
/*!
* \brief dump model to json
* \param handle handle
* \param num_iteration, <= 0 means save all
* \param out_str json format string of model
* \return 0 when succeed, -1 when failure happens
*/
Guolin Ke's avatar
Guolin Ke committed
518
519
520
521
522
523
LIGHTGBM_C_EXPORT LGBM_SE LGBM_BoosterDumpModel_R(LGBM_SE handle,
  LGBM_SE num_iteration,
  LGBM_SE buffer_len,
  LGBM_SE actual_len,
  LGBM_SE out_str,
  LGBM_SE call_state);
Guolin Ke's avatar
Guolin Ke committed
524

525
#endif  // LIGHTGBM_R_H_