##################  libORF  - library On Random Fields ####################

version 1.0 beta
In this repository you can find implementations of various machine learning algorithm, using Object Oriented Matlab.
The library is written for self-educational purposes, without considering speed and scalability.
Since the implementations are in Matlab, speed and scalability is an issue, where I tried to manage some of them by making use of GPU or writing mex functions. Therefore, you may experience some scalability problems. 
Following algorithms and models are provided along with some static utility classes:
- Naive Bayes, Linear Regression, Logistic Regression, Softmax Regression, Linear Support Vector Machine, Non-Linear Support Vector Machine (with RBF kernel),
Feed-forward Neural Network, Embedding Neural Network, Convolutional Neural Network, Sparse Autoencoders, Denoising Autoencoders, 
Contractive Autoencoders, Stacked Sparse Autoencoders, Self-Taught Learner and Restricted Boltzmann Machines are tested with this version.
- Rest of the methods are not tested hence not supplied and the progress is as follows: 	
	+ Deep Belief Nets with Restricted Boltzmann Machines (not tested)
	+ Bayes Nets (tested - refactoring)
	+ Hidden Markov Models (tested - refactoring)
	+ Conditional Random Fields (work in progress)

PREREQUISITES
- What you may need is an optimizer function if you want to use some external optimizer such as minfunc (by Mark Schmidt), which is included along with the toolbox http://www.di.ens.fr/~mschmidt/Software/minFunc.html.
- For running examples you need sample datasets (currently maintained also in github) which can be downloaded from the link below ~80mb. If the link is broken feel free to contact me. After downloading data archive, extract all the files into libORF/data/ folder.https://www.dropbox.com/s/kagevr66n69yhhm/data.rar

USAGE:
libORF is written using object oriented matlab, just instantiate and call appropriate methods.
A full documentation is not supplied with this beta version, but the code is well commented, for me at least :)
Please refer to example scripts for sample usage in the main directory by simply calling run_<method>.m

If you use libORF in your work, please cite the web-page: www.ceng.metu.edu.tr/~e1697481/libORF.html, or buy me a beer.

25 May 2014
Orhan Firat