Accord.NET Framework

Welcome to the Accord.NET GitHub repository. The Accord.NET project provides standard machine learning, statistics, artificial intelligence, computer vision, image processing methods to .NET, be it on Microsoft Windows, Xamarin, Unity3D, Windows Store applications or mobile.

Following a big refactoring after the merge with the AForge.NET project, the framework now offers a unified API for learning/training machine learning models that is both easy to use and extensible. It is based on the following pattern:

Instantiate a desired learning algorithm that provides a .Learn(x, y) method;
Call the learning algorithm's Learn(x, y) method with the data you have;
It will return you a trained model that you can use to Transform(), Decide(), Score(), compute Probabilities() or LogLikelihoods() for new data.

For more information, please see the getting started guide, and check the wiki. Note: the wiki has been gradually updated/rewritten followed the recent merge/refactoring. Please do not hesitate to edit it if you would like!

Installing

To install the framework in your application, please use NuGet. If you are on Visual Studio, right-click on the "References" item in your solution folder, and select "Manage NuGet Packages." Search for Accord.MachineLearning (or equivalently, Accord.Math, Accord.Statistics or Accord.Imaging depending on your initial goal) and select "Install."

If you would like to install the framework on Unity3D applications, download the framework binaries for .NET 3.5 from the framework releases page. Add the framework binaries to your Plugins folder, but remove any assemblies that might have external dependencies, such as Accord.Video and Accord.Audio. Finally, find and add the System.ComponentModel.DataAnnotations assembly from your system as well.

Sample applications

The framework comes with a wide range of sample applications to help get you started quickly. If you downloaded the framework sources or cloned the repository, open the Samples.sln solution file in the Samples folder.

Building

With Visual Studio 2013

Please download and install the following dependencies:

T4 Toolbox for Visual Studio 2013 https://visualstudiogallery.msdn.microsoft.com/791817a4-eb9a-4000-9c85-972cc60fd5aa
Sandcastle Help File Builder (with VS2013 extension) https://github.com/EWSoftware/SHFB/releases
NUnit Test Adapter https://visualstudiogallery.msdn.microsoft.com/6ab922d0-21c0-4f06-ab5f-4ecd1fe7175d

Then navigate to the Sources directory, and open the Accord.NET.sln solution file.

With Visual Studio 2015

Please download and install the following dependencies:

VS2013 C++ platform toolset (for compiling some unit tests only) Any free/pro/trial VS2013 version that includes C++ should work.
T4 Toolbox for Visual Studio 2015 https://visualstudiogallery.msdn.microsoft.com/34b6d489-afbc-4d7b-82c3-dded2b726dbc
Sandcastle Help File Builder (with VS2015 extension) https://github.com/EWSoftware/SHFB/releases
NUnit Test Adapter https://visualstudiogallery.msdn.microsoft.com/6ab922d0-21c0-4f06-ab5f-4ecd1fe7175d

Then navigate to the Sources directory, and open the Accord.NET.sln solution file.

With MonoDevelop, for running on Linux

# Install Mono
sudo apt-get install mono-complete monodevelop monodevelop-nunit

# Clone the repository
git clone https://github.com/accord-net/framework.git

# Enter the directory
cd framework

# Build the framework solution using Mono
mdtool build -c:"NET40" Sources/Accord.NET.Mono.sln

Contributing

If you would like to contribute, please do so by helping update the project's Wiki pages. While you can also make a donation, fill bug reports and contribute code in the form of pull requests, priority is being given to the documentation.

Join the chat at https://gitter.im/accord-net/framework

helitonjr / framework