AI-LibNeural
view release on metacpan or search on metacpan
21222324252627282930313233343536373839404142your libraries, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge
for
this service
if
you wish), that you receive source code or can get it
in new free programs; and that you know you can
do
these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities
for
you
if
you distribute copies of the library, or
if
you modify it.
For example,
if
you distribute copies of the library, whether gratis
or
for
a fee, you must give the recipients all the rights that we gave
you. You must make sure that they, too, receive or can get the source
code. If you
link
a program
with
the library, you must provide
complete object files to the recipients so that they can relink them
with
the library,
after
making changes to the library and recompiling
it. And you must show them these terms so they know their rights.
73747576777879808182838485868788899091929394959697analogous to running a utility program or application program. However, in
a textual and legal sense, the linked executable is a combined work, a
derivative of the original library, and the ordinary General Public License
treats it as such.
Because of this blurred distinction, using the ordinary General
Public License
for
libraries did not effectively promote software
concluded that weaker conditions might promote sharing better.
However, unrestricted linking of non-free programs would deprive the
users of those programs of all benefit from the free status of the
libraries themselves. This Library General Public License is intended to
preserving your freedom as a user of such programs to change the free
libraries that are incorporated in them. (We have not seen how to achieve
this as regards changes in header files, but we have achieved it as regards
changes in the actual functions of the Library.) The hope is that this
will lead to faster development of free libraries.
The precise terms and conditions
for
copying, distribution and
modification follow. Pay
close
attention to the difference between a
"work based on the library"
and a
"work that uses the library"
. The
former contains code derived from the library,
while
the latter only
works together
with
the library.
99100101102103104105106107108109110111112113114115116117118119
Note that it is possible
for
a library to be covered by the ordinary
General Public License rather than by this special one.
GNU LIBRARY GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License Agreement applies to any software library which
contains a notice placed by the copyright holder or other authorized
party saying it may be distributed under the terms of this Library
General Public License (also called
"this License"
). Each licensee is
addressed as
"you"
.
A
"library"
means a collection of software functions and/or data
prepared so as to be conveniently linked
with
application programs
The
"Library"
, below, refers to any such software library or work
which
has
been distributed under these terms. A "work based on the
Library" means either the Library or any derivative work under
copyright law: that is to
say
, a work containing the Library or a
portion of it, either verbatim or
with
modifications and/or translated
121122123124125126127128129130131132133134135136137138139140141included without limitation in the term
"modification"
.)
"Source code"
for
a work means the preferred form of the work
for
making modifications to it. For a library, complete source code means
all the source code
for
all modules it contains, plus any associated
interface definition files, plus the scripts used to control compilation
and installation of the library.
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running a program using the Library is not restricted, and output from
such a program is covered only
if
its contents constitute a work based
writing it). Whether that is true depends on what the Library does
and what the program that uses the Library does.
1. You may copy and distribute verbatim copies of the Library's
complete source code as you receive it, in any medium, provided that
you conspicuously and appropriately publish on
each
copy an
appropriate copyright notice and disclaimer of warranty; keep intact
all the notices that refer to this License and to the absence of any
162163164165166167168169170171172173174175176177178179180181182
d) If a facility in the modified Library refers to a function or a
table of data to be supplied by an application program that uses
the facility, other than as an argument passed
when
the facility
is invoked, then you must make a good faith effort to ensure that,
in the event an application does not supply such function or
table, the facility still operates, and performs whatever part of
its purpose remains meaningful.
(For example, a function in a library to compute square roots
has
a purpose that is entirely well-
defined
independent of the
application. Therefore, Subsection 2d requires that any
application-supplied function or table used by this function must
be optional:
if
the application does not supply it, the square
root function must still compute square roots.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Library,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms,
do
not apply to those
sections
when
you distribute them as separate works. But
when
you
distribute the same sections as part of a whole which is a work based
207208209210211212213214215216217218219220221222223224225226227
Once this change is made in a
given
copy, it is irreversible
for
that copy, so the ordinary GNU General Public License applies to all
subsequent copies and derivative works made from that copy.
This option is useful
when
you wish to copy part of the code of
the Library into a program that is not a library.
4. You may copy and distribute the Library (or a portion or
derivative of it, under Section 2) in object code or executable form
under the terms of Sections 1 and 2 above provided that you accompany
it
with
the complete corresponding machine-readable source code, which
must be distributed under the terms of Sections 1 and 2 above on a
medium customarily used
for
software interchange.
If distribution of object code is made by offering access to copy
from a designated place, then offering equivalent access to copy the
source code from the same place satisfies the requirement to
distribute the source code, even though third parties are not
compelled to copy the source along
with
the object code.
5. A program that contains
no
derivative of any portion of the
234235236237238239240241242243244245246247248249250251252253254255256257258259creates an executable that is a derivative of the Library (because it
contains portions of the Library), rather than a "work that uses the
library". The executable is therefore covered by this License.
Section 6 states terms
for
distribution of such executables.
When a
"work that uses the Library"
uses material from a header file
that is part of the Library, the object code
for
the work may be a
derivative work of the Library even though the source code is not.
Whether this is true is especially significant
if
the work can be
linked without the Library, or
if
the work is itself a library. The
threshold
for
this to be true is not precisely
defined
by law.
If such an object file uses only numerical parameters, data
structure layouts and accessors, and small macros and small inline
file is unrestricted, regardless of whether it is legally a derivative
work. (Executables containing this object code plus portions of the
Library will still fall under Section 6.)
Otherwise,
if
the work is a derivative of the Library, you may
distribute the object code
for
the work under the terms of Section 6.
Any executables containing that work also fall under Section 6,
whether or not they are linked directly
with
the Library itself.
6. As an exception to the Sections above, you may also compile or
link
a
"work that uses the Library"
with
the Library to produce a
263264265266267268269270271272273274275276277278279280281282283engineering
for
debugging such modifications.
You must give prominent notice
with
each
copy of the work that the
this License. You must supply a copy of this License. If the work
during execution displays copyright notices, you must include the
copyright notice
for
the Library among them, as well as a reference
directing the user to the copy of this License. Also, you must
do
one
of these things:
a) Accompany the work
with
the complete corresponding
machine-readable source code
for
the Library including whatever
changes were used in the work (which must be distributed under
Sections 1 and 2 above); and,
if
the work is an executable linked
with
the Library,
with
the complete machine-readable "work that
uses the Library", as object code and/or source code, so that the
user can modify the Library and then relink to produce a modified
executable containing the modified Library. (It is understood
that the user who changes the contents of definitions files in the
Library will not necessarily be able to recompile the application
297298299300301302303304305306307308309310311312313314315316317
For an executable, the required form of the "work that uses the
Library" must include any data and utility programs needed
for
reproducing the executable from it. However, as a special exception,
the source code distributed need not include anything that is normally
distributed (in either source or binary form)
with
the major
components (compiler, kernel, and so on) of the operating
system
on
which the executable runs,
unless
that component itself accompanies
the executable.
It may happen that this requirement contradicts the license
restrictions of other proprietary libraries that
do
not normally
accompany the operating
system
. Such a contradiction means you cannot
use
both them and the Library together in an executable that you
distribute.
7. You may place library facilities that are a work based on the
Library side-by-side in a single library together
with
other library
facilities not covered by this License, and distribute such a combined
library, provided that the separate distribution of the work based on
the Library and of the other library facilities is otherwise
permitted, and provided that you
do
these two things:
319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360
a) Accompany the combined library
with
a copy of the same work
based on the Library, uncombined
with
any other library
facilities. This must be distributed under the terms of the
Sections above.
b) Give prominent notice
with
the combined library of the fact
that part of it is a work based on the Library, and explaining
where to find the accompanying uncombined form of the same work.
8. You may not copy, modify, sublicense,
link
with
, or distribute
the Library except as expressly provided under this License. Any
attempt otherwise to copy, modify, sublicense,
link
with
, or
distribute the Library is void, and will automatically terminate your
rights under this License. However, parties who have received copies,
or rights, from you under this License will not have their licenses
terminated so long as such parties remain in full compliance.
9. You are not required to
accept
this License, since you have not
signed it. However, nothing
else
grants you permission to modify or
distribute the Library or its derivative works. These actions are
prohibited by law
if
you
do
not
accept
this License. Therefore, by
modifying or distributing the Library (or any work based on the
Library), you indicate your acceptance of this License to
do
so, and
all its terms and conditions
for
copying, distributing or modifying
the Library or works based on it.
10. Each
time
you redistribute the Library (or any work based on the
Library), the recipient automatically receives a license from the
original licensor to copy, distribute,
link
with
or modify the Library
subject to these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible
for
enforcing compliance by third parties to
this License.
11. If, as a consequence of a court judgment or allegation of patent
infringement or
for
any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they
do
not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Library at all. For example,
if
a patent
372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420such claims; this section
has
the sole purpose of protecting the
integrity of the free software distribution
system
which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that
system
in reliance on consistent application of that
system
; it is up to the author/donor to decide
if
he or she is willing
to distribute software through any other
system
and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Library under this License may add
an explicit geographical distribution limitation excluding those countries,
so that distribution is permitted only in or among countries not thus
excluded. In such case, this License incorporates the limitation as
if
written in the body of this License.
13. The Free Software Foundation may publish revised and/or new
versions of the Library General Public License from
time
to
time
.
Such new versions will be similar in spirit to the present version,
but may differ in detail to address new problems or concerns.
Each version is
given
a distinguishing version number. If the Library
specifies a version number of this License which applies to it and
"any later version"
, you have the option of following the terms and
conditions either of that version or of any later version published by
the Free Software Foundation. If the Library does not specify a
license version number, you may choose any version ever published by
the Free Software Foundation.
14. If you wish to incorporate parts of the Library into other free
programs whose distribution conditions are incompatible
with
these,
write
to the author to ask
for
permission. For software which is
copyrighted by the Free Software Foundation,
write
to the Free
Software Foundation; we sometimes make exceptions
for
this. Our
decision will be guided by the two goals of preserving the free status
of all derivatives of
our
free software and of promoting the sharing
and reuse of software generally.
NO WARRANTY
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
OTHER PARTIES PROVIDE THE LIBRARY
"AS IS"
WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
466467468469470471472473474475476477478479480481482
License along
with
this library;
if
not,
write
to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307 USA.
Also add information on how to contact you by electronic and paper mail.
You should also get your employer (
if
you work as a programmer) or your
school,
if
any, to sign a
"copyright disclaimer"
for
the library,
if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the
library `Frob' (a library
for
tweaking knobs) written by James Random Hacker.
<signature of Ty Coon>, 1 April 1990
Ty Coon, President of Vice
That's all there is to it!
LibNeural.pm view on Meta::CPAN
798081828384858687888990919293949596979899100101102
my
$nn
= AI::LibNeural->new( 2, 4, 1 );
# teach it the logical AND
$nn
->train( [ 0, 0 ], [ 0.05 ], 0.0000000005, 0.2 );
$nn
->train( [ 0, 1 ], [ 0.05 ], 0.0000000005, 0.2 );
$nn
->train( [ 1, 0 ], [ 0.05 ], 0.0000000005, 0.2 );
$nn
->train( [ 1, 1 ], [ 0.95 ], 0.0000000005, 0.2 );
my
$result
=
$nn
->run( [ 1, 1 ] );
# result should be ~ 0.95
$result
=
$nn
->run( [ 0, 1 ] );
# result should be ~ 0.05
$nn
->save(
'and.mem'
);
=head1 ABSTRACT
Perl bindings for the libneural c++ neural netowrk library.
=head1 DESCRIPTION
Provides accessors for the libneural library as a perl object. libneural is a
LibNeural.pm view on Meta::CPAN
118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157Creates a new AI::LibNeural object from the supplied memory file.
=item $nn = AI::LibNeural->new(INTPUTS,HIDDENS,OUTPUTS)
Creates a new AI::LibNeural object with INPUTS input nodes, HIDDENS hidden
nodes, and OUTPUTS output nodes.
=item $nn->train([I1,I2,...],[O1,O2,...],MINERR,TRAINRATE)
Completes a training cycle for the given inputs I1-IN, with the expected
results of O1-OM, where N is the number of inputs and M is the number of
outputs. MINERR is the mean squared error at the output that you wish to be achieved. TRAINRATE is the learning rate to be used.
=item (O1,O2) = $nn->run([I1,I2,...])
Calculate the corresponding outputs (O1-OM) for the given inputs (I1-ON) based
on the previous training. Should only be called after the network has been
suitably trained.
=item NUM = $nn->get_layersize(WHICH)
Retrieves the number of nodes at the specified layer, WHICH. WHICH should be
one of ALL, INPUT, HIDDEN, OUTPUT. Usefully mainly with a network is loaded
from a file.
=item status = $nn->load(FILENAME)
=item status = $nn->save(FILENAME)
Loads and saves respectively the 'memory,' node configuration and weights,
of the network. FILENAME should be the location of the file in which the
memory is stored/retrieved.
=back
=head2 EXPORT
None by default
=head2 EXPORT TAGS
123456789101112131415161718192021#
# $Header$
#
AI::LibNeural version 0.02
==========================
This module provides access to the c++ library libneural.
freshmeat.net.) libneural is a simple, but useful, backpropagation neural
network. It isn
't packed with features or a speed demon, but it works and it'
s
easy to learn how to
use
.
INSTALLATION
> perl Makefile.PL
or
> perl Makefile.PL PREFIX=/some/non/
system
/place
(then setting PERL5LIB as appropriate based on ^ is a good ideal)
ignore the warnings about CC and LD being unknown parameters, then
> make all test install
( run in 0.496 second using v1.01-cache-2.11-cpan-e5176c747c2 )