Using the Backpropagation Library in your Application


Advertisements

In this small short document I’ll show you how to quickly setup the backpropagation library for you application.

Visual Studio Users

First off, you have to get the library. If you don’t have it you can get it here.

  • Start a new project on your visual studio IDE.
  • If you are having the MLBP libraries in a different folder than your project, make sure to include the (.h) header file location to the folder in your Visual Studio Configuration. Make sure to include libs folder too.Visual Studio Include FolderLib Path Visual Studio
  • Defining Global Macros: If you want to use the double precision library make sure to include into the global defines, the macro DOUBLE_PRECISION. I also recommend including the macro SHARED_LIBRARY. This in case you get linker errors.Defines Global on visual studio
  • Adding libraries to project: In order Visual Studio may find which library it should link to, first, in your project properties -> VC++ Directories, add the directory where the .lib files are stored.Visual Studio Add Library 1Visual Studio Library Adding Directory
  • Add the macro #pragma(lib,”mlbp_stsfp.lib”)  or #pragma(lib,”mlbp_stdfp.lib”) if you enabled DOUBLE_PRECISION on any of your source files.

Qt Creator Users

  • Start a new project on Qt Creator.
  • On the PRO file make sure to include with INCLUDEPATH the folder where all header files location. Example: INCLUDEPATH+=c:/mlbp/include
  • Include the linking library using with LIBS. Example: LIBS+=c:/mlbp/libs/vc_x86/mlbp_stsfp.lib
  • Defining Global Macros: If you want to use the double precision library include this statement: DEFINES+=DOUBLE_PRECISION. If you are having linker errors include macro SHARED_LIBRARY.

Now you are ready to start coding your project.

Initializing Neural Network

1. First, you have to set the name space where the library is grouped: mlbp;

using namespace mlbp;

2. Declare a variable as a bp object: the neural network object.

bp net;

3. Initialize neural network to your needs with function bp::create()

if(!net.create(PATTERN_SIZE,OUTPUT_SIZE,INPUTNEURON_COUNT))
{
        cout << "Could not create network";
        return 0;
}

4-Incialize all neuron weights to random values with function bp::setStartValues()

net.setStartValues ();

5-If you have the multithreaded version of the library and you want to use it you can do it by calling function bp::setMultiThreaded(true);

Network ready for training

Now you have, the network is ready for training. Use function bp::train() or any variation of it to start training the network. The train function is used inside a loop and all training patterns must pass inside that loop. The idea of this loop is to wait until bp::train() returns an error near close to zero.

You can do it in this way.

while( error < 0.001f )
    {
        error=0;
        for(int i=0;i<patterncount;i++)
        {
            error+=net.train(desiredOutput[i],input[i],0.09f,0.1f);
        }
        error/=patterncount;
        cout << "ERROR:" << error << endl;
    }

Or you just can do it by setting a fixed number of iterations:

for(int i=0;i<45000;i++)
    {
        error=0;
        for(int i=0;i<patterncount;i++)
        {
            error+=net.train(desiredOutput[i],input[i 0.09f,0.1f);
        }
        error/=patterncount;
        cout << "ERROR:" << error << endl;

    }

I recommend using the second way because in the first one if by any reason the network never reaches that minimum value it would hang in an infinite loop.

After Training

Training is usually intensive when you do it with large patterns. And even more when you include many of these patterns. So you may want to save all you have done. There are two ways to do it.

Using Save Function

The easiest way is by using the bp::save() function.

if(!net.save("network.net",USERID1,USERID2))
    {
        if(net.getError()==BP_E_FILEWRITE_ERROR)
        {
            cout << "Could not open file for writing";
        }
        else if(net.getError()==BP_E_EMPTY)
        {
            cout << "Network is empty";
        }
    }

Getting a linear buffer of the network

The second way is easy too and useful if you want to save the network in your own file format. You only have to call function bp::getRawData() and pass it to a bpBuffer. Use function bpBuffer::get() to get the buffer as an unsigned char array. In this way you can save the buffer on a personalized file.

bpBuffer buff;
    buff=net.getRawData();
    if(!buff.isEmpty())
    {
        FILE *f;
        fopen("yourfile.dat","rb");
        fwrite(buff.get(),sizeof(char),buff.size(),f);
        fclose(f);
    }

To create a network from a buffer, just load a bpBuffer with the unsigned char array and use bp::setRawData(bpBuffer).

bpBuffer buff;
    unsigned char *ucbuffer;
    unsigned int usize;
   LOAD ucbuffer here
   .....

    buff.set(ucbuffer,usize);
    if(!net.setRawData(buff))
    {
        if(net.getError()==BP_E_CORRUPTED_DATA)
        {
            cout << "Invalid buffer";
        }
       //...
    }

Using for Production

If your application won’t perform training every time it is used by the final user, or if it just would do it once. You only have to change the steps of starting random values of the network and training to just loading the neural network data from a file, and call bp::run every time your application would need the services of the neural network.

Check an example program here.

Check Reference Documentation here

6 thoughts on “Using the Backpropagation Library in your Application

  1. Please help me.Linker errors.What I’m doing wrong
    1>main.obj : error LNK2019: unresolved external symbol “__declspec(dllimport) public: double & __thiscall mlbp::bpArray::operator[](int)” (__imp_??AbpArray@mlbp@@QAEAANH@Z) referenced in function _main
    1>main.obj : error LNK2019: unresolved external symbol “__declspec(dllimport) public: double __thiscall mlbp::bp::trainwec(class mlbp::bpArray const &,class mlbp::bpArray const &,double,double)” (__imp_?trainwec@bp@mlbp@@QAENABVbpArray@2@0NN@Z) referenced in function _main
    1>main.obj : error LNK2019: unresolved external symbol “__declspec(dllimport) public: void __thiscall mlbp::bp::setStartValues(enum mlbp::START_VALUES,double,double,double)” (__imp_?setStartValues@bp@mlbp@@QAEXW4START_VALUES@2@NNN@Z) referenced in function _main
    1>main.obj : error LNK2019: unresolved external symbol “__declspec(dllimport) public: __thiscall mlbp::bpArray::bpArray(double const *,unsigned int,bool)” (__imp_??0bpArray@mlbp@@QAE@PBNI_N@Z) referenced in function _main
    1>main.obj : error LNK2019: unresolved external symbol “__declspec(dllimport) public: __thiscall mlbp::bpArray::bpArray(double,unsigned int)” (__imp_??0bpArray@mlbp@@QAE@NI@Z) referenced in function _main

    • Hello,

      Make sure you are linking to the correct library. if you have enabled DOUBLE_PRECISION make sure to link to library mlbp_dfp.lib, else link to library mlbp_sfp.lib. That happens when you link to the incorrect library.

      Which compiler are you using?

      • Visual Studio 2010
        I dont understand what i must do in this step “Adding libraries to project: In order Visual Studio may find which library it should link too. Add the macro #pragma(lib,”mlbp_stsfp.lib”) or #pragma(lib,”mlbp_stdfp.lib”) which is ever is the case.”
        Is that possible that the reason is this step?

        • I updated the post. Added a couple images to explain better how to make this work.

          What I am saying there, you must include the directory where the “lib” files are stored into your project settings. Just right click on your project, go to VC++ Directories, select Library Directories, and add the path where you have the lib files you downloaded. If you are compiling for 32 bits include \lib\vc_x86 or 64 bits \lib\vc_x64

          After that, on any of the source files. Preferably, a header file, include this code #pragma(lib,”mlbp_sfp.lib”) if you didn’t define DOUBLE_PRECISION, or #pragma(lib,”mlbp_dfp.lib”) if you defined DOUBLE_PRECISION.
          After you compiled the project make sure to copy the dll into the location where you compiled the executable. DLLs are located in BIN folder.

Leave a Reply

Your email address will not be published. Required fields are marked *