From 271d1ffdf847aeda0d7aa3351bd3fc1ee952dbe6 Mon Sep 17 00:00:00 2001 From: James Lamb Date: Fri, 14 Jun 2024 16:14:06 -0500 Subject: [PATCH] release v4.4.0 (#6439) --- .appveyor.yml | 2 +- R-package/R/lgb.Booster.R | 4 ++++ R-package/R/lgb.Dataset.R | 3 +++ R-package/R/lgb.model.dt.tree.R | 3 +++ R-package/configure | 18 +++++++++--------- R-package/cran-comments.md | 6 ++++++ R-package/man/lgb.dump.Rd | 6 ++++-- R-package/man/lgb.model.dt.tree.Rd | 6 ++++-- R-package/man/lgb.save.Rd | 6 ++++-- R-package/man/lgb.slice.Dataset.Rd | 2 ++ R-package/pkgdown/_pkgdown.yml | 2 +- VERSION.txt | 2 +- docs/Parameters.rst | 2 ++ include/LightGBM/config.h | 1 + python-package/pyproject.toml | 2 +- 15 files changed, 46 insertions(+), 19 deletions(-) diff --git a/.appveyor.yml b/.appveyor.yml index 3c12ebaa36f8..33b860bf8a49 100644 --- a/.appveyor.yml +++ b/.appveyor.yml @@ -1,4 +1,4 @@ -version: 4.3.0.99.{build} +version: 4.4.0.{build} image: Visual Studio 2015 platform: x64 diff --git a/R-package/R/lgb.Booster.R b/R-package/R/lgb.Booster.R index 7f0ccc31dd49..bce9e785bf4e 100644 --- a/R-package/R/lgb.Booster.R +++ b/R-package/R/lgb.Booster.R @@ -1309,6 +1309,8 @@ lgb.load <- function(filename = NULL, model_str = NULL) { #' For example, passing \code{start_iteration=5, num_iteration=3} for a regression model #' means "save the fifth, sixth, and seventh tree" #' +#' \emph{New in version 4.4.0} +#' #' @return lgb.Booster #' #' @examples @@ -1373,6 +1375,8 @@ lgb.save <- function( #' For example, passing \code{start_iteration=5, num_iteration=3} for a regression model #' means "dump the fifth, sixth, and seventh tree" #' +#' \emph{New in version 4.4.0} +#' #' @return json format of model #' #' @examples diff --git a/R-package/R/lgb.Dataset.R b/R-package/R/lgb.Dataset.R index 8a4a7246b16c..ed1216c7986a 100644 --- a/R-package/R/lgb.Dataset.R +++ b/R-package/R/lgb.Dataset.R @@ -1054,6 +1054,9 @@ dimnames.lgb.Dataset <- function(x) { #' @title Slice a dataset #' @description Get a new \code{lgb.Dataset} containing the specified rows of #' original \code{lgb.Dataset} object +#' +#' \emph{Renamed from} \code{slice()} \emph{in 4.4.0} +#' #' @param dataset Object of class \code{lgb.Dataset} #' @param idxset an integer vector of indices of rows needed #' @return constructed sub dataset diff --git a/R-package/R/lgb.model.dt.tree.R b/R-package/R/lgb.model.dt.tree.R index cc58011a2d11..db4ef955f866 100644 --- a/R-package/R/lgb.model.dt.tree.R +++ b/R-package/R/lgb.model.dt.tree.R @@ -6,6 +6,9 @@ #' @param start_iteration Index (1-based) of the first boosting round to include in the output. #' For example, passing \code{start_iteration=5, num_iteration=3} for a regression model #' means "return information about the fifth, sixth, and seventh trees". +#' +#' \emph{New in version 4.4.0} +#' #' @return #' A \code{data.table} with detailed information about model trees' nodes and leafs. #' diff --git a/R-package/configure b/R-package/configure index b84169b14336..32ffa32a18ee 100755 --- a/R-package/configure +++ b/R-package/configure @@ -1,6 +1,6 @@ #! /bin/sh # Guess values for system-dependent variables and create Makefiles. -# Generated by GNU Autoconf 2.71 for lightgbm 4.3.0.99. +# Generated by GNU Autoconf 2.71 for lightgbm 4.4.0. # # # Copyright (C) 1992-1996, 1998-2017, 2020-2021 Free Software Foundation, @@ -607,8 +607,8 @@ MAKEFLAGS= # Identity of this package. PACKAGE_NAME='lightgbm' PACKAGE_TARNAME='lightgbm' -PACKAGE_VERSION='4.3.0.99' -PACKAGE_STRING='lightgbm 4.3.0.99' +PACKAGE_VERSION='4.4.0' +PACKAGE_STRING='lightgbm 4.4.0' PACKAGE_BUGREPORT='' PACKAGE_URL='' @@ -1211,7 +1211,7 @@ if test "$ac_init_help" = "long"; then # Omit some internal or obsolete options to make the list less imposing. # This message is too long to be a string in the A/UX 3.1 sh. cat <<_ACEOF -\`configure' configures lightgbm 4.3.0.99 to adapt to many kinds of systems. +\`configure' configures lightgbm 4.4.0 to adapt to many kinds of systems. Usage: $0 [OPTION]... [VAR=VALUE]... @@ -1273,7 +1273,7 @@ fi if test -n "$ac_init_help"; then case $ac_init_help in - short | recursive ) echo "Configuration of lightgbm 4.3.0.99:";; + short | recursive ) echo "Configuration of lightgbm 4.4.0:";; esac cat <<\_ACEOF @@ -1341,7 +1341,7 @@ fi test -n "$ac_init_help" && exit $ac_status if $ac_init_version; then cat <<\_ACEOF -lightgbm configure 4.3.0.99 +lightgbm configure 4.4.0 generated by GNU Autoconf 2.71 Copyright (C) 2021 Free Software Foundation, Inc. @@ -1378,7 +1378,7 @@ cat >config.log <<_ACEOF This file contains any messages produced by compilers while running configure, to aid debugging if configure makes a mistake. -It was created by lightgbm $as_me 4.3.0.99, which was +It was created by lightgbm $as_me 4.4.0, which was generated by GNU Autoconf 2.71. Invocation command line was $ $0$ac_configure_args_raw @@ -2454,7 +2454,7 @@ cat >>$CONFIG_STATUS <<\_ACEOF || ac_write_fail=1 # report actual input values of CONFIG_FILES etc. instead of their # values after options handling. ac_log=" -This file was extended by lightgbm $as_me 4.3.0.99, which was +This file was extended by lightgbm $as_me 4.4.0, which was generated by GNU Autoconf 2.71. Invocation command line was CONFIG_FILES = $CONFIG_FILES @@ -2509,7 +2509,7 @@ ac_cs_config_escaped=`printf "%s\n" "$ac_cs_config" | sed "s/^ //; s/'/'\\\\\\\\ cat >>$CONFIG_STATUS <<_ACEOF || ac_write_fail=1 ac_cs_config='$ac_cs_config_escaped' ac_cs_version="\\ -lightgbm config.status 4.3.0.99 +lightgbm config.status 4.4.0 configured by $0, generated by GNU Autoconf 2.71, with options \\"\$ac_cs_config\\" diff --git a/R-package/cran-comments.md b/R-package/cran-comments.md index 404c471c1c16..137df4912c04 100644 --- a/R-package/cran-comments.md +++ b/R-package/cran-comments.md @@ -1,5 +1,11 @@ # CRAN Submission History +## v4.4.0 - Submission 1 - (TBD) + +### CRAN response + +### Maintainer Notes + ## v4.3.0 - Submission 1 - (January 18, 2024) ### CRAN response diff --git a/R-package/man/lgb.dump.Rd b/R-package/man/lgb.dump.Rd index e1790946d8f6..e356251466e5 100644 --- a/R-package/man/lgb.dump.Rd +++ b/R-package/man/lgb.dump.Rd @@ -12,8 +12,10 @@ lgb.dump(booster, num_iteration = NULL, start_iteration = 1L) \item{num_iteration}{Number of iterations to be dumped. NULL or <= 0 means use best iteration} \item{start_iteration}{Index (1-based) of the first boosting round to dump. -For example, passing \code{start_iteration=5, num_iteration=3} for a regression model -means "dump the fifth, sixth, and seventh tree"} + For example, passing \code{start_iteration=5, num_iteration=3} for a regression model + means "dump the fifth, sixth, and seventh tree" + + \emph{New in version 4.4.0}} } \value{ json format of model diff --git a/R-package/man/lgb.model.dt.tree.Rd b/R-package/man/lgb.model.dt.tree.Rd index 126ecc7b23cc..ecfee17332f5 100644 --- a/R-package/man/lgb.model.dt.tree.Rd +++ b/R-package/man/lgb.model.dt.tree.Rd @@ -12,8 +12,10 @@ lgb.model.dt.tree(model, num_iteration = NULL, start_iteration = 1L) \item{num_iteration}{Number of iterations to include. NULL or <= 0 means use best iteration.} \item{start_iteration}{Index (1-based) of the first boosting round to include in the output. -For example, passing \code{start_iteration=5, num_iteration=3} for a regression model -means "return information about the fifth, sixth, and seventh trees".} + For example, passing \code{start_iteration=5, num_iteration=3} for a regression model + means "return information about the fifth, sixth, and seventh trees". + + \emph{New in version 4.4.0}} } \value{ A \code{data.table} with detailed information about model trees' nodes and leafs. diff --git a/R-package/man/lgb.save.Rd b/R-package/man/lgb.save.Rd index 118c008464d7..3a532e9f0c32 100644 --- a/R-package/man/lgb.save.Rd +++ b/R-package/man/lgb.save.Rd @@ -14,8 +14,10 @@ lgb.save(booster, filename, num_iteration = NULL, start_iteration = 1L) \item{num_iteration}{Number of iterations to save, NULL or <= 0 means use best iteration} \item{start_iteration}{Index (1-based) of the first boosting round to save. -For example, passing \code{start_iteration=5, num_iteration=3} for a regression model -means "save the fifth, sixth, and seventh tree"} + For example, passing \code{start_iteration=5, num_iteration=3} for a regression model + means "save the fifth, sixth, and seventh tree" + + \emph{New in version 4.4.0}} } \value{ lgb.Booster diff --git a/R-package/man/lgb.slice.Dataset.Rd b/R-package/man/lgb.slice.Dataset.Rd index f2a47bcb1885..c40ec0d5bb32 100644 --- a/R-package/man/lgb.slice.Dataset.Rd +++ b/R-package/man/lgb.slice.Dataset.Rd @@ -17,6 +17,8 @@ constructed sub dataset \description{ Get a new \code{lgb.Dataset} containing the specified rows of original \code{lgb.Dataset} object + + \emph{Renamed from} \code{slice()} \emph{in 4.4.0} } \examples{ \donttest{ diff --git a/R-package/pkgdown/_pkgdown.yml b/R-package/pkgdown/_pkgdown.yml index c2d6718a2926..be3563210330 100644 --- a/R-package/pkgdown/_pkgdown.yml +++ b/R-package/pkgdown/_pkgdown.yml @@ -14,7 +14,7 @@ repo: user: https://github.com/ development: - mode: unreleased + mode: release authors: Yu Shi: diff --git a/VERSION.txt b/VERSION.txt index c42a8a79f6d1..fdc6698807a9 100644 --- a/VERSION.txt +++ b/VERSION.txt @@ -1 +1 @@ -4.3.0.99 +4.4.0 diff --git a/docs/Parameters.rst b/docs/Parameters.rst index 02f01ae4408b..40551cfd5858 100644 --- a/docs/Parameters.rst +++ b/docs/Parameters.rst @@ -414,6 +414,8 @@ Learning Control Parameters - when early stopping is used (i.e. ``early_stopping_round > 0``), require the early stopping metric to improve by at least this delta to be considered an improvement + - *New in 4.4.0* + - ``first_metric_only`` :raw-html:`🔗︎`, default = ``false``, type = bool - LightGBM allows you to provide multiple evaluation metrics. Set this to ``true``, if you want to use only the first metric for early stopping diff --git a/include/LightGBM/config.h b/include/LightGBM/config.h index b9d71aaa9882..a2a352669460 100644 --- a/include/LightGBM/config.h +++ b/include/LightGBM/config.h @@ -396,6 +396,7 @@ struct Config { // check = >=0.0 // desc = when early stopping is used (i.e. ``early_stopping_round > 0``), require the early stopping metric to improve by at least this delta to be considered an improvement + // desc = *New in 4.4.0* double early_stopping_min_delta = 0.0; // desc = LightGBM allows you to provide multiple evaluation metrics. Set this to ``true``, if you want to use only the first metric for early stopping diff --git a/python-package/pyproject.toml b/python-package/pyproject.toml index d671b5456ae6..9b9dcc0195f2 100644 --- a/python-package/pyproject.toml +++ b/python-package/pyproject.toml @@ -30,7 +30,7 @@ maintainers = [ name = "lightgbm" readme = "README.rst" requires-python = ">=3.7" -version = "4.3.0.99" +version = "4.4.0" [project.optional-dependencies] arrow = [