Recent changes to Home

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 21 Nov 2014 16:29:15 -0000

--- v10
+++ v11
@@ -1,7 +1,7 @@
 #Behaviour Control Framework#
 Author: Philipp Allgeuer
-Version: 1.0.1
-Date: 05/11/13
+Version: 1.0.2
+Date: 21/11/14

 ##General Overview##
 The Behaviour Control Framework is a generic platform-independent C++ framework that implements a control architecture consisting of a hierarchical network of behaviour layers. These layers each contain behaviours that can inhibit one another and interact to achieve control. A full discussion of the structure and ideas behind this framework can be found in the Doxygen documentation that comes with the release. This documentation is well worth a read before you decide if the library is for you!
@@ -27,7 +27,7 @@

 Due to the rather small and efficient nature of the library, one of the first two options is recommended. Minimal benefit is expected from building a dynamic library.

-Note that as at release `v1.0.1`, the required (non-test) source files are:
+Note that as at release `v1.0.2`, the required (non-test) source files are:

 Header Files                       | Source Files
 -----------------------------------|------------------------

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 16 May 2014 16:45:04 -0000

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 16 May 2014 12:37:00 -0000

--- v8
+++ v9
@@ -68,7 +68,7 @@
 If anything is not adequately explained in the Doxygen documentation, or more details as to the inner workings of the library are required, the next place to look would be in the library source code. The code is well-commented and should be fairly self-explanatory. A good starting point is `behaviour_manager.h`. A look inside the source code for `test_behaviour_control` should also shed some light on how the library is intended to be used.

 ###Where To Get More Help?###
-If neither the Doxygen documentation nor a look into the source code can resolve your issues for whatever reason, you can contact the author at the email address given in the Bugs and Improvements section.
+If neither the Doxygen documentation nor a look into the source code can resolve your issues for whatever reason, you can contact the author at the email address given in the *Bugs and Improvements* section.

 ##Bugs and Improvements##
 I welcome all feedback, suggestions and bug reports. If you improve or fix anything about the library then I encourage you to let the author know so that the library can be improved for everyone!

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 16 May 2014 12:27:40 -0000

--- v7
+++ v8
@@ -22,12 +22,12 @@

 There are three ways of using the library:
 1) Directly include the (non-test) source files in your project, and build them with the rest of your project.
-2) Build a static library (e.g. \*.a or \*.lib) of the source code and link your project to it.
-3) Build a dynamic library (e.g. \*.so or \*.dll) of the source code and link your project to it.
+2) Build a static library (e.g. `*.a` or `*.lib`) of the source code and link your project to it.
+3) Build a dynamic library (e.g. `*.so` or `*.dll`) of the source code and link your project to it.

 Due to the rather small and efficient nature of the library, one of the first two options is recommended. Minimal benefit is expected from building a dynamic library.

-Note that as at release v1.0.1, the required (non-test) source files are:
+Note that as at release `v1.0.1`, the required (non-test) source files are:

 Header Files                       | Source Files
 -----------------------------------|------------------------
@@ -72,7 +72,7 @@

 ##Bugs and Improvements##
 I welcome all feedback, suggestions and bug reports. If you improve or fix anything about the library then I encourage you to let the author know so that the library can be improved for everyone!
-Email: pallgeuer\[at\]ais.uni-bonn.de
+Email: `pallgeuer[at]ais.uni-bonn.de`

 ##Screenshots##
 The screenshots below show the output of the `test_behaviour_control` unit test that comes with the library. This should give you a brief idea of what the Behaviour Control Framework is all about.

Home modified by Philipp Allgeuer

Philipp Allgeuer — Tue, 05 Nov 2013 12:07:12 -0000

--- v6
+++ v7
@@ -1,7 +1,7 @@
 #Behaviour Control Framework#
 Author: Philipp Allgeuer
-Version: 1.0
-Date: 27/09/13
+Version: 1.0.1
+Date: 05/11/13

 ##General Overview##
 The Behaviour Control Framework is a generic platform-independent C++ framework that implements a control architecture consisting of a hierarchical network of behaviour layers. These layers each contain behaviours that can inhibit one another and interact to achieve control. A full discussion of the structure and ideas behind this framework can be found in the Doxygen documentation that comes with the release. This documentation is well worth a read before you decide if the library is for you!
@@ -27,7 +27,7 @@

 Due to the rather small and efficient nature of the library, one of the first two options is recommended. Minimal benefit is expected from building a dynamic library.

-Note that as at release v1.0, the required (non-test) source files are:
+Note that as at release v1.0.1, the required (non-test) source files are:

 Header Files                       | Source Files
 -----------------------------------|------------------------
@@ -56,11 +56,11 @@
 ###Doxygen Documentation###
 The first place to look for help and guidance when trying to use the Behaviour Control Framework is the Doxygen documentation. This can be found in the library ZIP archive under:

-`Behaviour Control Framework vX.X/doc/Behaviour Control Framework.html`
+`Behaviour Control Framework vX.X.X/doc/Behaviour Control Framework.html`

 Or equivalently:

-`Behaviour Control Framework vX.X/doc/out/html/index.html`
+`Behaviour Control Framework vX.X.X/doc/out/html/index.html`

 The Doxygen documentation provides a complete explanation of the entire framework, including all caveats and details, and includes code samples to make the task of learning the framework a lot easier. Complete documentation of all functions, classes and namespaces of the library is also included. As such, the Doxygen documentation is intended to be the primary help resource when working with the library.

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 27 Sep 2013 14:23:47 -0000

--- v5
+++ v6
@@ -9,7 +9,13 @@
 The structure and implementation of this library focuses on the application of the inhibition-based behaviour control architecture to real-time control loops, but can reasonably be adapted for a wide variety of other artificial intelligence applications. Emphasis has been placed on having very low overhead so as not to hurt overall system performance, while still maintaining ease of use.

 ##Feature List##
-TODO
+- Small and highly efficient performance-oriented cross-platform C++ library
+- Independent code with few external dependencies
+- Can be used to implement behaviour control code in the form of a hierarchically layered behaviour-based control architecture
+- Tried and tested by the author on various robotic platforms
+- Documented using the Doxygen documentation generation tool, including code samples and a discussion of all usage caveats
+- Well-commented library source code to allow easy modification/extension by users (who are encouraged to submit improvements/bug fixes to the author, so that the library can be improved!)
+- Academic paper on the framework: *Hierarchical and State-based Architectures for Robot Behavior Planning and Control*, published in Proceedings of 8th Workshop on Humanoid Soccer Robots @ Humanoids 2013

 ##Installation##
 This library is implemented as a collection of platform-independent C++ source files. To get started (if you haven't done so already) download the latest ZIP of the library from the [SourceForge page](https://sourceforge.net/p/behaviourcontrol), and extract it to the desired location on your computer.

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 27 Sep 2013 14:06:12 -0000

--- v4
+++ v5
@@ -16,8 +16,8 @@

 There are three ways of using the library:
 1) Directly include the (non-test) source files in your project, and build them with the rest of your project.
-2) Build a static library (e.g. *.a or *.lib) of the source code and link your project to it.
-3) Build a dynamic library (e.g. *.so or *.dll) of the source code and link your project to it.
+2) Build a static library (e.g. \*.a or \*.lib) of the source code and link your project to it.
+3) Build a dynamic library (e.g. \*.so or \*.dll) of the source code and link your project to it.

 Due to the rather small and efficient nature of the library, one of the first two options is recommended. Minimal benefit is expected from building a dynamic library.

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 27 Sep 2013 14:04:26 -0000

--- v3
+++ v4
@@ -22,14 +22,17 @@
 Due to the rather small and efficient nature of the library, one of the first two options is recommended. Minimal benefit is expected from building a dynamic library.

 Note that as at release v1.0, the required (non-test) source files are:
-behaviour_control.h                 | behaviour_control.cpp
-classes/behaviour_common.h          | behaviour_common.cpp
-classes/behaviour_manager.h         | behaviour_manager.cpp
-classes/behaviour_layer.h           | behaviour_layer.cpp
-classes/behaviour.h                 | behaviour.cpp
-classes/behaviour_sensors.h         | behaviour_sensors.cpp
-classes/behaviour_actuators.h       | behaviour_actuators.cpp
-classes/behaviour_template_defns.h  | 
+
+Header Files                       | Source Files
+-----------------------------------|------------------------
+behaviour_control.h                | behaviour_control.cpp
+classes/behaviour_common.h         | behaviour_common.cpp
+classes/behaviour_manager.h        | behaviour_manager.cpp
+classes/behaviour_layer.h          | behaviour_layer.cpp
+classes/behaviour.h                | behaviour.cpp
+classes/behaviour_sensors.h        | behaviour_sensors.cpp
+classes/behaviour_actuators.h      | behaviour_actuators.cpp
+classes/behaviour_template_defns.h | 

 A sample makefile for building the static and dynamic libraries using `gcc` is included in the release. The makefile also demonstrates how the `test_behaviour_control` unit test can be built. As mentioned in the makefile however, the Behaviour Control Framework could equivalently be built using any other compiler, such as for example MSVC.

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 27 Sep 2013 14:01:48 -0000

--- v2
+++ v3
@@ -22,14 +22,14 @@
 Due to the rather small and efficient nature of the library, one of the first two options is recommended. Minimal benefit is expected from building a dynamic library.

 Note that as at release v1.0, the required (non-test) source files are:
-behaviour_control.h                 behaviour_control.cpp
-classes/behaviour_common.h          behaviour_common.cpp
-classes/behaviour_manager.h         behaviour_manager.cpp
-classes/behaviour_layer.h           behaviour_layer.cpp
-classes/behaviour.h                 behaviour.cpp
-classes/behaviour_sensors.h         behaviour_sensors.cpp
-classes/behaviour_actuators.h       behaviour_actuators.cpp
-classes/behaviour_template_defns.h
+behaviour_control.h                 | behaviour_control.cpp
+classes/behaviour_common.h          | behaviour_common.cpp
+classes/behaviour_manager.h         | behaviour_manager.cpp
+classes/behaviour_layer.h           | behaviour_layer.cpp
+classes/behaviour.h                 | behaviour.cpp
+classes/behaviour_sensors.h         | behaviour_sensors.cpp
+classes/behaviour_actuators.h       | behaviour_actuators.cpp
+classes/behaviour_template_defns.h  | 

 A sample makefile for building the static and dynamic libraries using `gcc` is included in the release. The makefile also demonstrates how the `test_behaviour_control` unit test can be built. As mentioned in the makefile however, the Behaviour Control Framework could equivalently be built using any other compiler, such as for example MSVC.

Home modified by Philipp Allgeuer

Philipp Allgeuer — Fri, 27 Sep 2013 13:57:50 -0000

--- v1
+++ v2
@@ -1,8 +1,72 @@
-Welcome to your wiki!
+#Behaviour Control Framework#
+Author: Philipp Allgeuer
+Version: 1.0
+Date: 27/09/13

-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
+##General Overview##
+The Behaviour Control Framework is a generic platform-independent C++ framework that implements a control architecture consisting of a hierarchical network of behaviour layers. These layers each contain behaviours that can inhibit one another and interact to achieve control. A full discussion of the structure and ideas behind this framework can be found in the Doxygen documentation that comes with the release. This documentation is well worth a read before you decide if the library is for you!

-The wiki uses [Markdown](/p/behaviourcontrol/wiki/markdown_syntax/) syntax.
+The structure and implementation of this library focuses on the application of the inhibition-based behaviour control architecture to real-time control loops, but can reasonably be adapted for a wide variety of other artificial intelligence applications. Emphasis has been placed on having very low overhead so as not to hurt overall system performance, while still maintaining ease of use.

-[[members limit=20]]
+##Feature List##
+TODO
+
+##Installation##
+This library is implemented as a collection of platform-independent C++ source files. To get started (if you haven't done so already) download the latest ZIP of the library from the [SourceForge page](https://sourceforge.net/p/behaviourcontrol), and extract it to the desired location on your computer.
+
+There are three ways of using the library:
+1) Directly include the (non-test) source files in your project, and build them with the rest of your project.
+2) Build a static library (e.g. *.a or *.lib) of the source code and link your project to it.
+3) Build a dynamic library (e.g. *.so or *.dll) of the source code and link your project to it.
+
+Due to the rather small and efficient nature of the library, one of the first two options is recommended. Minimal benefit is expected from building a dynamic library.
+
+Note that as at release v1.0, the required (non-test) source files are:
+behaviour_control.h                 behaviour_control.cpp
+classes/behaviour_common.h          behaviour_common.cpp
+classes/behaviour_manager.h         behaviour_manager.cpp
+classes/behaviour_layer.h           behaviour_layer.cpp
+classes/behaviour.h                 behaviour.cpp
+classes/behaviour_sensors.h         behaviour_sensors.cpp
+classes/behaviour_actuators.h       behaviour_actuators.cpp
+classes/behaviour_template_defns.h
+
+A sample makefile for building the static and dynamic libraries using `gcc` is included in the release. The makefile also demonstrates how the `test_behaviour_control` unit test can be built. As mentioned in the makefile however, the Behaviour Control Framework could equivalently be built using any other compiler, such as for example MSVC.
+
+##Dependencies##
+This library depends on the following external libraries (to avoid requiring C++11):
+- Boost [Static Assert](http://www.boost.org/doc/libs/release/libs/static_assert/)
+- Boost [Type Traits](http://www.boost.org/doc/libs/release/libs/type_traits/)
+- Boost [Utility](http://www.boost.org/doc/libs/release/libs/utility/) (specifically [`enable_if`](http://www.boost.org/doc/libs/release/libs/utility/enable_if.html))
+
+For more information, or to download the Boost Libraries, please refer to [http://www.boost.org/](http://www.boost.org/).
+
+A unit test for the library (`test_behaviour_control`) is included in the release. It is not required to build this executable in order to use the library - it is for demonstration and testing purposes only. The unit test has one additional dependency, namely the [Google Test Framework](https://code.google.com/p/googletest/).
+
+##Documentation##
+###Doxygen Documentation###
+The first place to look for help and guidance when trying to use the Behaviour Control Framework is the Doxygen documentation. This can be found in the library ZIP archive under:
+
+`Behaviour Control Framework vX.X/doc/Behaviour Control Framework.html`
+
+Or equivalently:
+
+`Behaviour Control Framework vX.X/doc/out/html/index.html`
+
+The Doxygen documentation provides a complete explanation of the entire framework, including all caveats and details, and includes code samples to make the task of learning the framework a lot easier. Complete documentation of all functions, classes and namespaces of the library is also included. As such, the Doxygen documentation is intended to be the primary help resource when working with the library.
+
+###Source Code###
+If anything is not adequately explained in the Doxygen documentation, or more details as to the inner workings of the library are required, the next place to look would be in the library source code. The code is well-commented and should be fairly self-explanatory. A good starting point is `behaviour_manager.h`. A look inside the source code for `test_behaviour_control` should also shed some light on how the library is intended to be used.
+
+###Where To Get More Help?###
+If neither the Doxygen documentation nor a look into the source code can resolve your issues for whatever reason, you can contact the author at the email address given in the Bugs and Improvements section.
+
+##Bugs and Improvements##
+I welcome all feedback, suggestions and bug reports. If you improve or fix anything about the library then I encourage you to let the author know so that the library can be improved for everyone!
+Email: pallgeuer\[at\]ais.uni-bonn.de
+
+##Screenshots##
+The screenshots below show the output of the `test_behaviour_control` unit test that comes with the library. This should give you a brief idea of what the Behaviour Control Framework is all about.
+[[project_screenshots]]
+[[project_admins]]
 [[download_button]]