Skip to content
A Toolkit for the Construction of Modeling Packages
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
R Remove unused `validate_intercept()` Mar 21, 2019
graphics
man-roxygen
man
tests
vignettes Tweak image size and spacing Mar 27, 2019
.Rbuildignore
.gitignore Separate README into two vignettes Feb 20, 2019
.travis.yml Fix silly clock error on r-devel Mar 7, 2019
DESCRIPTION
NAMESPACE Add `validate_predictors_are_numeric()` Mar 21, 2019
README.Rmd
README.md
_pkgdown.yml
codecov.yml
hardhat.Rproj

README.md

hardhat

Travis build status Codecov test coverage Lifecycle: experimental CRAN status

Introduction

hardhat is a developer focused package designed to ease the creation of new modeling packages, while simultaneously promoting good R modeling package standards as laid out by the set of opinionated Conventions for R Modeling Packages.

hardhat has four main goals:

  • Easily, consistently, and robustly preprocess data at fit time and prediction time with mold() and forge().

  • Provide one source of truth for common input validation functions, such as checking if new data at prediction time contains the same required columns used at fit time.

  • Provide extra utility functions for additional common tasks, such as adding intercept columns, standardizing predict() output, and extracting valuable class and factor level information from the predictors.

  • Reimagine the base R preprocessing infrastructure of stats::model.matrix() and stats::model.frame() using the stricter approaches found in model_matrix() and model_frame().

The idea is to reduce the burden of creating a good modeling interface as much as possible, and instead let the package developer focus on writing the core implementation of their new model. This benefits not only the developer, but also the user of the modeling package, as the standardization allows users to build a set of “expectations” around what any modeling function should return, and how they should interact with it.

Installation

You can install the released version of hardhat from CRAN with:

# no you cannot
install.packages("hardhat")

And the development version from GitHub with:

# install.packages("devtools")
devtools::install_github("DavisVaughan/hardhat")

Vignettes

To learn about how to use hardhat, check out the vignettes:

  • vignette("mold", "hardhat"): Learn how to preprocess data at fit time with mold().

  • vignette("forge", "hardhat"): Learn how to preprocess new data at prediction time with forge().

  • vignette("package", "hardhat"): Learn how to use mold() and forge() to help in creating a new modeling package.

You can’t perform that action at this time.