Not Found

The requested URL was not found on this server.

Additionally, a 404 Not Found error was encountered while trying to use an ErrorDocument to handle the request.

1#@!#!123s

: / opt / remi / php82 / root / usr / share / doc / pecl / fann /

Filename : README.md

back

# PHP FANN wrapper

This is a PHP wrapper for [FANN (Fast Artificial Neural Network) library](http://leenissen.dk/fann/wp/).

## API

The API is documented on http://www.php.net/manual/en/book.fann.php where is the complete documentation for PHP FANN.

The API is very similar to the official [FANN C API](http://leenissen.dk/fann/html/files/fann-h.html). Just functions for fixed `fann_type` have not been mapped because PHP always support `float`. In addition unnecessary arguments for some functions have been left out (for example array length that is not necessary for PHP arrays).

## Installation

The extension can be installed on Linux and Windows.

### Linux

Before you start installation make sure that `libfann` is installed on your system. It's part of the main repository in the most Linux distributions (search for `fann`). If not you need to install it first. Either download it from the [official site](http://leenissen.dk/fann/wp/) or get it from your distro repository. For example on Ubuntu:
```
$ sudo apt-get install libfann-dev
```
Fann installation can be skipped if an RPM for Fedora is used (`libfann` is in the package dependencies).

If the library is re-installed manually, then all old library file should be removed before re-installing otherwise the old library version could be linked.

#### Fedora

The RPM package for PHP FANN is available in Remi's repository: http://rpms.famillecollet.com/

It is available for Fedora, RHEL and clones (CentOS, SC and others).

After downloading remi-release RPM, the package can be installed by executing following command:
```
$ sudo yum --enablerepo=remi install php-pecl-fann
```

#### PECL

This extension is available on PECL. The installation is very simple. Just run:

```
$ sudo pecl install fann
```

#### Manual Installation

It's important to have a git installed as it's necessary for recursive fetch of
[phpc](https://github.com/bukka/phpc).

First clone recursively the repository
```
git clone --recursive https://github.com/bukka/php-fann.git
```

Then go to the created source directory and compile the extension. You need to have a php development package installed (command `phpize` must be available).
```
cd php-fann
phpize
./configure --with-fann
make
sudo make install
```

If you are rebuilding the extension and see warning about Libtool version mismatch error, try to run `phpize --clean` or if it doesn't help, try
```
aclocal && libtoolize --force && autoreconf
```
and then run the compilation steps starting with `phpize` again.

Finally you need to add
```
extension=fann.so
```
to the php.ini

### Windows

Precompiled binary `dll` libraries for php-fann and libfann are available on [the PECL fann page](http://pecl.php.net/package/fann). The compiled version of libfann is 2.2.

## Examples

There are three example projects: [Logic Gates](examples/logic_gates/), [OCR](examples/ocr/) & [Pathfinder](examples/pathfinder/).

#### Logic Gates

###### Simple

The Simple example trains a single neural network to perform the XOR operation.

[simple_train.php](examples/logic_gates/simple_train.php)

[simple_train_epoch.php](examples/logic_gates/simple_train_epoch.php)

[simple_test.php](examples/logic_gates/simple_test.php)

[simple_merge.php](examples/logic_gates/simple_test.php) 


###### All

The All example trains 7 seperate neural networks to perform the AND, NAND, NOR, NOT, OR, XNOR & XOR operations.

[train_all.php](examples/logic_gates/train_all.php)

[test_all.php](examples/logic_gates/test_all.php)


#### OCR

OCR is a practical example of Optical Character Recognition using FANN. While this example is limited and does make mistakes, the concepts illustrated by OCR can be applied to a more robust stacked network that uses feature extraction and convolution layers to recognize text of any font in any size image. 

[train_ocr.php](examples/ocr/train_ocr.php)

[test_ocr.php](examples/ocr/test_ocr.php)



#### Pathfinder

Pathfinder is an example of a neural network that is capable of plotting an 8 direction step path from a starting position in a 5x5 grid to an ending position in that grid. To keep the Pathfinder example simple it is not trained to deal with walls or non-traversable terrain however it would be very easy to add that by adding additional training.

[pathfinder_train.php](examples/pathfinder/pathfinder_train.php)

[pathfinder_test.php](examples/pathfinder/pathfinder_test.php)

Name	Size	Last Modified	Owner	Permissions
examples	Dir	September 02 2024 9:38:02	root	0755
phpc	Dir	September 02 2024 9:38:02	root	0755
CREDITS	0.019 KB	February 21 2024 9:57:39	root	0644
README.md	4.327 KB	February 21 2024 9:57:39	root	0644
TODO.md	1.16 KB	February 21 2024 9:57:39	root	0644

2017 © D7net \| D704T team