8 releases (4 breaking)

0.7.0 Oct 16, 2023
0.6.1 Dec 3, 2022
0.6.0 Jun 15, 2022
0.5.1 Mar 1, 2022
0.3.0 Jan 20, 2021

#121 in Algorithms

Download history 376/week @ 2023-08-17 340/week @ 2023-08-24 249/week @ 2023-08-31 256/week @ 2023-09-07 182/week @ 2023-09-14 228/week @ 2023-09-21 113/week @ 2023-09-28 131/week @ 2023-10-05 222/week @ 2023-10-12 177/week @ 2023-10-19 238/week @ 2023-10-26 198/week @ 2023-11-02 181/week @ 2023-11-09 170/week @ 2023-11-16 191/week @ 2023-11-23 141/week @ 2023-11-30

713 downloads per month
Used in 13 crates




linfa-datasets provides a collection of commonly used datasets ready to be used in tests and examples.

The Big Picture

linfa-datasets is a crate in the linfa ecosystem, an effort to create a toolkit for classical Machine Learning implemented in pure Rust, akin to Python's scikit-learn.

Current State

Currently the following datasets are provided:

Name Description #samples, #features, #targets Targets Reference
iris The Iris dataset provides samples of flower properties, belonging to three different classes. Only two of them are linearly separable. It was introduced by Ronald Fisher in 1936 as an example for linear discriminant analysis. 150, 4, 1 Multi-class classification here
winequality The winequality dataset measures different properties of wine, such as acidity, and gives a scoring from 3 to 8 in quality. It was collected in the north of Portugal. 441, 10, 1 Multi-class classification here
diabetes The diabetes dataset gives samples of human biological measures, such as BMI, age, blood measures, and tries to predict the progression of diabetes. 1599, 11, 1 Regression here
linnerud The linnerud dataset contains samples from 20 middle-aged men in a fitness club. Their physical capability, as well as biological measures are related. 20, 3, 3 Regression here

The purpose of this crate is to faciliate dataset loading and make it as simple as possible. Loaded datasets are returned as a linfa::Dataset structure with named features. The crate also includes helper functions for reading arrays from CSV files.

Additionally, this crate provides utility functions to randomly generate test datasets.

Using a dataset

To use one of the provided datasets in your project add the linfa-datasets crate to your Cargo.toml and enable the corresponding feature:

linfa-datasets = { version = "0.x", features = ["winequality"] }

You can then use the dataset in your working code:

let (train, valid) = linfa_datasets::winequality()

Reading from a file

linfa-datasets is also capable of reading 2D arrays from CSV files:

use std::fs::File;
use std::io::Read;

let file = File::open("data.csv.gz").unwrap();
// Read the array from a GZipped CSV file with a header and separated by commas
let array = linfa_datasets::array_from_gz_csv(file, true, b',').unwrap();

Data generation

To generate datasets randomly, enable the generate feature on linfa-datasets. The API is in the generate module of the crate.


~88K SLoC