Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 347 Commits
.github		.github
algorithms		algorithms
datasets		datasets
docs/website		docs/website
src		src
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTE.md		CONTRIBUTE.md
Cargo.toml		Cargo.toml
LICENSE-APACHE2		LICENSE-APACHE2
LICENSE-MIT		LICENSE-MIT
README.md		README.md
build.rs		build.rs
mascot.svg		mascot.svg

Repository files navigation

Linfa

linfa (Italian) /sap (English):
Thevital circulating fluid of a plant.

linfa aims to provide a comprehensive toolkit to build Machine Learning applications with Rust.

Kin in spirit to Python'sscikit-learn, it focuses on common preprocessing tasks and classical ML algorithms for your everyday ML tasks.

Website |Community chat

Current state

Where doeslinfa stand right now?Are we learning yet?

linfa currently provides sub-packages with the following algorithms:

Name	Purpose	Status	Category	Notes
bayes	Naive Bayes	Tested	Supervised learning	Contains Bernouilli, Gaussian and Multinomial Naive Bayes
clustering	Data clustering	Tested / Benchmarked	Unsupervised learning	Clustering of unlabeled data; contains K-Means, Gaussian-Mixture-Model, DBSCAN and OPTICS
ensemble	Ensemble methods	Tested	Supervised learning	Contains bagging
elasticnet	Elastic Net	Tested	Supervised learning	Linear regression with elastic net constraints
ftrl	Follow The Regularized Leader - proximal	Tested / Benchmarked	Partial fit	Contains L1 and L2 regularization. Possible incremental update
hierarchical	Agglomerative hierarchical clustering	Tested	Unsupervised learning	Cluster and build hierarchy of clusters
ica	Independent component analysis	Tested	Unsupervised learning	Contains FastICA implementation
kernel	Kernel methods for data transformation	Tested	Pre-processing	Maps feature vector into higher-dimensional space
linear	Linear regression	Tested	Partial fit	Contains Ordinary Least Squares (OLS), Generalized Linear Models (GLM)
logistic	Logistic regression	Tested	Partial fit	Builds two-class logistic regression models
nn	Nearest Neighbours & Distances	Tested / Benchmarked	Pre-processing	Spatial index structures and distance functions
pls	Partial Least Squares	Tested	Supervised learning	Contains PLS estimators for dimensionality reduction and regression
preprocessing	Normalization & Vectorization	Tested / Benchmarked	Pre-processing	Contains data normalization/whitening and count vectorization/tf-idf
reduction	Dimensionality reduction	Tested	Pre-processing	Diffusion mapping, Principal Component Analysis (PCA), Random projections
svm	Support Vector Machines	Tested	Supervised learning	Classification or regression analysis of labeled datasets
trees	Decision trees	Tested / Benchmarked	Supervised learning	Linear decision trees
tsne	Dimensionality reduction	Tested	Unsupervised learning	Contains exact solution and Barnes-Hut approximation t-SNE

We believe that only a significant community effort can nurture, build, and sustain a machine learning ecosystem in Rust - there is no other way forward.

If this strikes a chord with you, please take a look at theroadmap and get involved!

BLAS/Lapack backend

Some algorithm crates need to use an external library for linear algebra routines. By default, we use a pure-Rust implementation. However, you can also choose an external BLAS/LAPACK backend library instead, by enabling theblas feature and a feature corresponding to your BLAS backend. Currently you can choose between the following BLAS/LAPACK backends:openblas,netblas orintel-mkl.

Backend	Linux	Windows	macOS
OpenBLAS	✔️	-	-
Netlib	✔️	-	-
Intel MKL	✔️	✔️	✔️

Each BLAS backend has two features available. The feature allows you to choose between linking the BLAS library in your system or statically building the library. For example, the features for theintel-mkl backend areintel-mkl-static andintel-mkl-system.

An example set of Cargo flags for enabling the Intel MKL backend on an algorithm crate is--features blas,linfa/intel-mkl-system. Note that the BLAS backend features are defined on thelinfa crate, and should only be specified for the final executable.

License

Dual-licensed to be compatible with the Rust project.

Licensed under the Apache License, Version 2.0http://www.apache.org/licenses/LICENSE-2.0 or the MIT licensehttp://opensource.org/licenses/MIT, at your option. This file may not be copied, modified, or distributed except according to those terms.