SteerSuite

Welcome! SteerSuite is a set of test cases, tools, and a C++ library for developing and evaluating agent steering AI behaviors.

The SteerSuite web page is steersuite.eecs.yorku.ca

On the web page you can find a description of SteerSuite, download the latest version of SteerSuite, read the latest documentation, and join the discussion group.

Please send us any comments and feedback about how to make SteerSuite easier to use. Your input is greatly appreciated.

Enjoy!

Documentation

If you want to build your own documentation from this package, read the file documentation/readme.txt for more information. Otherwise, the latest documentation can be found at the SteerSuite web page.

The documentation includes:

• The User Guide explains how to use most features of SteerSuite.
• The Reference Manual contains a comprehensive listing of SteerSuite components.
• The Code Reference is doxygen-generated documentation of the C++ code.

Directory structure

The directory structure of this package is as follows:

build           - Unix scripts and Visual Studio 2012 solution file
                  to compile all components of SteerSuite.

documentation   - raw unprocessed documentation and instructions for
                  building the documentation.

external        - external dependencies that are (legally) included
                  for convenience, but NOT part of SteerSuite.

kdtree          - Spatial Database module for a kdtree type spatial
                  databse.

navmeshBuilder  - Module to build navigation meshes during runtime.
                  Uses Recast.

pprAI           - source directory for the PPR steering module, a
                  demo steering algorithm for SteerSim.

rvo2AI          - source directory for the ORCA steering module,
                  based on the RVO2 steering algorithm library.

reactiveAI      - source directory for the reactive steering module,
                  a demo steering algorithm for SteerSim (just the
                  reactive appraoch of PPR).

socialForcesAI  - source directory for the social foces steering
                  module, an implementation of the social forces
                  steering algorithm.

simpleAI        - source directory for the simpleAI module, a basic
                  demo plugin for SteerSim.

steerbench      - source directory for SteerBench, a tool used to
                  score and analyze steering AI.

steerlib        - source directory for SteerLib, a shared library
                  containing most of SteerSuite's functionality.

steersim        - source directory for SteerSim, a modular
                  simulation tool.

steertool       - source directory for SteerTool, a utility for
                  useful miscellaneous tasks.

testcases       - XML test cases and the XML schema describing the
                  test case format.

Compiling SteerSuite

Below are quick instructions for compiling with default options. For more complete instructions, refer to the SteerSuite User Guide.

As with any graphics library you will need to make sure you already have the OpenGL libraries on your computer. For example on Ubuntu 14.04 you will want to install the following:

freeglut3-dev build-essential libx11-dev libxmu-dev libxi-dev libgl1-mesa-glx libglu1-mesa libglu1-mesa-dev libglew1.6-dev mesa-utils libglew-dev premake4

This will install OpenGL and GLEW.

On Windows you will need to download glut32.lib and the opengl header files and put them in your Visual Studio library path.

Note: The build system has been updated and now uses premake4. You are going to need to have this installed to be able to build the software.

Windows 7/8 with Visual Studio 2012

Run premake4 --platform=x64 vs2012 and choose Debug/Release and 32/64 bit mode. Most components should compile successfully, and all compiled components will be in the build/bin folder.

Linux/Unix

First run the following:

cd build
premake4 gmake
cd gmake

Then run make config=[debug|release], depending on your preference for the type of build.

All components are copied into the build/bin and build/lib directories.

Mac OS X

For now, the process is the same as Linux/Unix. With OS X version 10.4 or earlier, you may need to use an LD_LIBRARY_PATH environment variable for the executable to properly link with shared and dynamic libraries.

Contact information

Contact Information:

• Glen Berseth glenpb@cse.yorku.ca
• Mubbasir Kapadia mubbasir@cs.ucla.edu
• Petros Faloutsos pfal@cse.yorku.ca
• Glenn Reinman reinman@cs.ucla.edu

SteerSuite web page: steersuite.eecs.yorku.ca

Forum (Google Group): groups.google.com/forum/#!forum/steersuite

Please report bugs by opening an issue on github. For any other queries please use the forum.

Copyright and license

SteerSuite, SteerBench, SteerBug, SteerSim, and SteerLib are Copyright (c) 2008-2014 Shawn Singh, Glen Berseth, Mubbasir Kapadia, Petros Faloutos, and Glenn Reinman.

See license.txt for the complete license.

NOTE: The contents of the external/ directory are NOT part of SteerSuite. Each component in external/ has its own authors, copyright, and license, and those souces are only included for convenience.

Credits

Refer to the SteerSuite web page for credits and acknowledgements.