Changelog
Source:NEWS.md
hdnom 6.0.4
CRAN release: 2024-09-05
Bug fixes
- Fixed C code compatibility issues with
_R_USE_STRICT_R_HEADERS_
(upcoming default in R 4.5.0) (#13):- Defined
STRICT_R_HEADERS
. - Replaced
Calloc
andFree
withR_Calloc
andR_Free
. - Included
float.h
forFLT_EPSILON
.
- Defined
hdnom 6.0.2
CRAN release: 2023-04-24
Improvements
- Use all samples instead of a much smaller set of samples in some code examples as a temporary fix for reverse dependency check errors which result in the null model. A proper fix will involve updating the logic to use
ncvsurv()
in a pathwise manner instead of with a single value of lambda.
hdnom 6.0.0
CRAN release: 2019-06-23
This version is a major refactor of the package, with several technical adjustments to improve the functional interface, code structure, and execution performance. As a result, a few critical API-breaking changes have been made. Please update your previous code that calls hdnom accordingly. For the detailed changes, please check the updated items below.
Improvements
General
- Renamed exported functions. Most of the exported function have been renamed to be more meaningful and succinct. For example,
hdcox.*()
are renamed asfit_*()
,hdnom.nomogram()
is renamed asas_nomogram()
,hdnom.validate()
is renamed asvalidate()
, and so on. - Removed the dependency on
rms
, by reusing a minimal set of code fromrms
for nomogram construction and plotting. This results in clearer code structure, better maintainability, and faster package installation/loading speed. Also removed other non-essential package dependencies. - The first argument for
print
functions are now returned invisbily, to make it easier to use them in a pipe.
Model Fitting
- The components in the model fitting function returns are now unified across model types. For example, the model object can all be accessed by
fit$model
, and the selected “optimal” hyperparameters can be accessed byfit$lambda
. The model type is now stored explicitly asfit$type
.
Nomograms
-
as_nomogram
(previouslyhdnom.nomogram()
) now accepts the fitted model objects directly instead of the$model
component. It now will recognize the model type automatically, thus the previous argumentsmodel.type
has been deprecated. so that it is easier to chain the function calls together usingmagrittr
. - In
as_nomogram
, the previousddist
argument is not needed anymore and has been removed. There is also no more need to set adatadist
object as a into the global options variable (which was required in therms
user flow). - The new nomogram implementation prints and plots the nomogram for the penalized regression models directly. This supersedes the old implementation, which fits an OLS model to regress the linear predictors on the same set of predictors selected by the penalized Cox regression model, aiming to approximate the penalized model. The numerical or visual difference is minimal, though.
Visualizations
- Add a new ggplot2 theme
theme_hdnom()
and applies it to most of the validation, calibration, and comparison plots for a consistent, cleaner look across plots within the package.
hdnom 5.0 (2018-05-13)
CRAN release: 2018-05-14
Improvements
- Exported the survival curve prediction functions (
glmnet.survcurve()
,ncvreg.survcurve()
,penalized.survcurve()
) and Breslow baseline hazard estimator functions (glmnet.basesurv()
,ncvreg.basesurv()
,penalized.basesurv()
). - New URL for the documentation website: https://nanx.me/hdnom/.
hdnom 4.6 (2017-01-07)
CRAN release: 2017-01-08
Bug Fixes
- Fixed issues in parameter tuning and cross-validation procedures for fused lasso models (nanxstats/hdnom@afc49c9). The user-visible change is that two parameters
lambda1
andlambda2
instead of a single “lambda” are now required to fit, validate, and calibrate fused lasso models.
hdnom 4.5 (2016-12-24)
CRAN release: 2016-12-25
Bug Fixes
- Fixed vanishing axis problem in Kaplan-Meier plot
hdnom.kmplot()
under ggplot2 2.2.0, which is caused by a previous workaround for a bug introduced in ggplot2 2.1.0. - Fixed potential convergence issues for examples under ncvreg >= 3.7-0 new convergence criterion, by increasing
max.iter
forncvsurv
to a substantially higher value (5e+4). - Fixed single lambda support issues in
ncvsurv
under ncvreg >= 3.7-0.
hdnom 4.0 (2016-07-05)
CRAN release: 2016-07-05
Improvements
- More concrete examples for several functions.
- Introduce argument
ylim
forplot.hdnom.validate()
,plot.hdnom.external.validate()
, andplot.hdnom.compare.validate()
(#4).
hdnom 3.6 (2016-03-24)
CRAN release: 2016-03-25
hdnom 3.0 (2016-01-03)
CRAN release: 2016-01-04
New Features
Package
- New function
hdnom.compare.validate()
for model comparison by validation - New function
hdnom.compare.calibrate()
for model comparison by calibration - New function
hdnom.external.validate()
for external validation - New function
hdnom.external.calibrate()
for external calibration - New
predict
andprint
methods forhdcox.model
objects - New function
hdnom.kmplot()
: Kaplan-Meier analysis for risk groups using internal/external calibration results - New function
hdnom.logrank()
: Log-rank test for risk groups using internal/external calibration results