README.md

In makeyourownmaker/pmlblite: Interface to the Penn Machine Learning Benchmarks Data Repository

pmlblite

pmlblite is an R interface to the Penn Machine Learning Benchmarks (PMLB) data repository

If you like pmlblite, give it a star, or fork it and contribute!

Usage

Check available data sets and download data from the PMLB repository:

library(pmlblite)

# Data set names
classification_dataset_names
regression_dataset_names

# Data set summaries
classification_summary
regression_summary

# Download features and labels for iris data set in single data frame
iris <- fetch_data('iris')
iris

# Download features and labels for iris data set in separate data structures
iris <- fetch_data('iris', return_X_y=TRUE)
iris$x # data frame
iris$y # vector

Installation

Should work with any recent version of R.

install.packages("devtools") # Install devtools package if necessary
library(devtools)
devtools::install_github("makeyourownmaker/pmlblite")

Details

The PMLB repository contains a curated collection of data sets for evaluating and comparing machine learning algorithms. These data sets cover a range of applications, and include binary/multi-class classification problems and regression problems, as well as combinations of categorical, ordinal, and continuous features. There are approximately 290 data sets included in the PMLB repository and there are no missing values in these data sets.

All binary and multiclass classification data sets are in the classification category, and all regression data sets are in the regression category.

Data set format

All data sets are stored in a common format:

• First row is the column names
• Each following row corresponds to an individual observation
• The target column is named target
• All columns are tab (\t) separated
• All files are compressed with gzip to conserve space

The python interface to the PMLB repository is great but can't be used from the R language.

This R library includes summaries of the classification and regression data sets but does not include any of the PMLB data sets. The data sets can be downloaded using the fetch_data function which is similar to the corresponding PMLB python function.

Further info:

?fetch_data
?regression_summary
?classification_summary

Citing

If you use PMLB in a scientific publication, please consider citing the following paper:

Randal S. Olson, William La Cava, Patryk Orzechowski, Ryan J. Urbanowicz, and Jason H. Moore (2017). PMLB: a large benchmark suite for machine learning evaluation and comparison. BioData Mining 10, page 36.

I have no affiliation with the authors of PMLB or the University of Pennsylvania.

Roadmap

• Add tests
• Submit library to CRAN

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Integration of other data repositories are particularly welcome.

Alternatives

• Penn Machine Learning Benchmarks
• OpenML Approximately 2,500 datasets - available for download using R module
• UC Irvine Machine Learning Repository
• mlbench: Machine Learning Benchmark Problems
• Rdatasets: An archive of datasets distributed with R
• datasets.load: Visual interface for loading datasets in RStudio from all installed (unloaded) packages
• stackoverflow: How do I get a list of built-in data sets in R?

License

GPL-2

makeyourownmaker/pmlblite documentation built on Feb. 13, 2020, 11:46 p.m.