Skip to content
modelDown generates a website with HTML summaries for predictive models
R TeX
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
docs Regenerate pkgdown docs Jun 2, 2019
inst/extdata Fix tests on travis Mar 26, 2019
man Fix whitespaces in doc Jun 14, 2019
misc Reupload images May 13, 2019
paper_images Update JOSS paper_images Jun 2, 2019
scripts
tests #22 Add check for character variables in explainer dataset Apr 14, 2019
.Rbuildignore Make example simple and fast Jun 12, 2019
.gitattributes
.gitignore
.travis.yml Add OSX to travis check May 13, 2019
DESCRIPTION Remove LICENSE file Jun 4, 2019
NAMESPACE Fix tests on travis Mar 26, 2019
README.md Syntax issue on paragraph 59 Sep 2, 2019
_pkgdown.yml Updated figures and README May 8, 2019
cran-comments.md Update CRAN comments Jun 1, 2019
modelDown.Rproj Copy from gitlab May 27, 2018
paper.bib
paper.md

README.md

modelDown

CRAN_Status_Badge DOI Travis-CI Build Status Coverage Status

modelDown generates a website with HTML summaries for predictive models. Is uses DALEX explainers to compute and plot summaries of how given models behave. We can see how well models behave (Model Performance, Auditor), how much each variable contributes to predictions (Variable Response) and which variables are the most important for a given model (Variable Importance). We can also compare Concept Drift for pairs of models (Drifter). Additionally, data available on the website can be easily recreated in current R session (using archivist package).

pkgdown documentation: https://ModelOriented.github.io/modelDown/

An example website for regression models: https://mi2datalab.github.io/modelDown_example/

Getting started

Do you want to start right now ? Check out our getting started guide.

Or just simply install it like below:

Stable version: devtools::install_github("ModelOriented/modelDown")

And if you want to get the latest changes:

Development version: devtools::install_github("ModelOriented/modelDown@dev")

Contributing

If you spot a bug or you have a feature proposal feel free to create an issue in this repository. We are also open to contributions in a form of pull requests. Just follow steps below:

  1. Open a new issue (specify an issue type as a label - a bug or an enhancement).

Additionally you can:

  1. Start a new branch from the dev branch. It should be named bugfix/XX-short-description or feature/XX-short-description where XX is an issue number.
  2. Create commits with descriptive messages starting with #XX.
  3. Create a pull request of the created branch to the dev branch.
  4. Wait for a review from one of the modelDown maintainers.

Help us build better software!

Index page

Index page presents basic information about data provided in explainers. You can also see types of all explainers given as parameters. Additionally, summary statistics are available for numerical variables. For categorical variables, tables with frequencies of factor levels are presented.

Auditor

Module shows plots generated by auditor package.

Drifter

Results of drifter package are displayed in this tab. In order to see the comparison charts, you have to provide pair of explainers as parameters (for example: list(explainer_glm_old, explainer_glm_new)).

Model Performance

Module shows result of function model_performance.

Variable Importance

Output of function variable_importance is presented in form of a plot as well as a table.

Variable Response

For each variable, plot is created by using function variable_response. Plots can be easily navigated using links on the left side. One can provide names of variables to include in the module with argument vr.vars (if argument is not used, plots for all variables of first explainer are generated).

Loading data in R

In each tab you can find links with R commands. If you execute them, you can load relevant objects into current R session (archivist package is necessary). By default data is stored and loaded from local repository. If you wish to store data on GitHub repository, please provide argument remote_repository_path. After generating modelDown website, repository folder must be placed under this path.

Acknowledgments

Work on this package is financially supported by Warsaw University of Technology, Faculty of Mathematics and Information Science.

You can’t perform that action at this time.