php-ml/README.md

76 lines
2.9 KiB
Markdown
Raw Normal View History

2016-04-08 22:50:08 +00:00
# PHP Machine Learning library
2016-02-08 22:07:16 +00:00
2016-04-08 21:22:55 +00:00
[![Build Status](https://scrutinizer-ci.com/g/php-ai/php-ml/badges/build.png?b=develop)](https://scrutinizer-ci.com/g/php-ai/php-ml/build-status/develop)
2016-04-08 22:50:08 +00:00
[![Documentation Status](https://readthedocs.org/projects/php-ml/badge/?version=develop)](http://php-ml.readthedocs.org/en/develop/?badge=develop)
2016-04-08 21:22:55 +00:00
[![Total Downloads](https://poser.pugx.org/php-ai/php-ml/downloads.svg)](https://packagist.org/packages/php-ai/php-ml)
[![License](https://poser.pugx.org/php-ai/php-ml/license.svg)](https://packagist.org/packages/php-ai/php-ml)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/php-ai/php-ml/badges/quality-score.png?b=develop)](https://scrutinizer-ci.com/g/php-ai/php-ml/?branch=develop)
2016-02-08 22:07:16 +00:00
2016-05-02 10:07:53 +00:00
Fresh approach to Machine Learning in PHP. Note that at the moment PHP is not the best choice for machine learning but maybe this will change ...
Simple example of classification:
```php
use Phpml\Classifier\KNearestNeighbors;
$samples = [[1, 3], [1, 4], [2, 4], [3, 1], [4, 1], [4, 2]];
$labels = ['a', 'a', 'a', 'b', 'b', 'b'];
$classifier = new KNearestNeighbors();
$classifier->train($samples, $labels);
$classifier->predict([3, 2]);
// return 'b'
```
2016-02-08 22:07:16 +00:00
2016-04-08 21:22:55 +00:00
## Documentation
2016-02-08 22:20:08 +00:00
2016-04-08 22:53:18 +00:00
To find out how to use PHP-ML follow [Documentation](http://php-ml.readthedocs.org/).
2016-02-08 22:07:16 +00:00
## Installation
2016-04-08 21:22:55 +00:00
Currently this library is in the process of developing, but You can install it with Composer:
```
composer require php-ai/php-ml
```
2016-02-08 22:07:16 +00:00
2016-05-02 10:07:53 +00:00
## Features
* Classification
2016-05-02 11:49:19 +00:00
* [k-Nearest Neighbors](http://php-ml.readthedocs.io/en/latest/machine-learning/classification/k-nearest-neighbors/)
* [Naive Bayes](http://php-ml.readthedocs.io/en/latest/machine-learning/classification/naive-bayes/)
2016-05-02 10:07:53 +00:00
* Regression
2016-05-02 11:49:19 +00:00
* [Least Squares](http://php-ml.readthedocs.io/en/latest/machine-learning/regression/least-squares/)
2016-05-02 10:07:53 +00:00
* Clustering
2016-05-02 11:49:19 +00:00
* [k-Means](http://php-ml.readthedocs.io/en/latest/machine-learning/clustering/k-means)
* [DBSCAN](http://php-ml.readthedocs.io/en/latest/machine-learning/clustering/dbscan)
2016-05-02 10:07:53 +00:00
* Cross Validation
2016-05-02 11:49:19 +00:00
* [Random Split](http://php-ml.readthedocs.io/en/latest/machine-learning/cross-validation/random-split)
* Datasets
* [CSV](http://php-ml.readthedocs.io/en/latest/machine-learning/datasets/csv-dataset)
* Ready to use:
* [Iris](http://php-ml.readthedocs.io/en/latest/machine-learning/datasets/demo/iris/)
* Math
* [Distance](http://php-ml.readthedocs.io/en/latest/math/distance/)
* [Matrix](http://php-ml.readthedocs.io/en/latest/math/matrix/)
2016-02-08 22:07:16 +00:00
2016-05-02 10:07:53 +00:00
## Contribute
2016-02-08 22:07:16 +00:00
2016-05-02 10:07:53 +00:00
- Issue Tracker: github.com/php-ai/php-ml/issues
- Source Code: github.com/php-ai/php-ml
2016-02-08 22:07:16 +00:00
2016-05-02 10:07:53 +00:00
After installation, you can launch the test suite in project root directory (you will need to install dev requirements with Composer)
2016-02-08 22:07:16 +00:00
```
bin/phpunit
```
## License
PHP-ML is released under the MIT Licence. See the bundled LICENSE file for details.
## Author
2016-05-02 10:07:53 +00:00
Arkadiusz Kondas (@ArkadiuszKondas)