Agent I Solutions

Home

Products

Documentation

Download

Support

 

Download

Overview

Overview

Products

Agent Environment

Eclipse Plug-in

Archive

Documentation

Language Specification

Tutorial

Composer User Guide

The download page allows you to download all the necessary products and documentation to build Brahms models, simulate/execute these models and analyze the run-time results of these models. 

Currently the Composer, Compiler, Virtual Machine and Agent Viewer are bundled as part of the Brahms Agent Environment in one installation file. No separate distribution files are present for the products.

The Brahms Agent Environment has an installation program that can be run to install the product. The documentation is compressed in zip files requiring an unzip tool. A popular tool used to unzip zip files is winzip. The Brahms Agent Environment is now supported fully on Windows 2000/XP, Linux, Sparc/Solaris and soon Mac OS X.  Note that the Agent Viewer included with the Agent Environment requires either MySQL 4.1.x or MySQL 5.0.51 or later. MySQL is not included with the Agent Environment package.

The software is currently only available for research or non-commercial purposes. To download the software please register yourself with us and we will send you a user name and password allowing you to download the software. We will also send you a license file in order for you to use the Brahms Agent Environment. If you have already registered and don't have a license file or have an expired license file please send an e-mail to register@agentisolutions.com and include your registered name. We'll send you a (new) license file.

Note: The software is owned by the the Brahms Patent Holders. The software is licensed to NASA. Release of the software for commercial purposes is not yet approved. If you would like to be notified when the software becomes available for commercial purposes please submit the information request form.


Products

Brahms Agent Environment V1.2.7

The Brahms Agent Environment contains all components necessary to build, simulate/run and analyze agent models. The components included in the package are the Brahms compiler V2.21.8, virtual machine V4.0.44, Composer V1.7.5 and Agent Viewer V1.8.7. The Brahms Agent Environment provides an API for developing external agents and activities. The documentation and some examples are included in the installation. 

Windows 2000/XP (29 May 2008):

Linux (Intel) (tested on Fedora Core 8) (29 May 2008)

Mac OS X (29 May 2008)

Solaris (Sparc/Intel) (29 May 2008)

  • Available on request (send an e-mail to support).

Patches

The following patch can be applied to the Brahms Agent Environment version 1.2.7 on any of the supported platforms. Extract the zip file into the Brahms/Agent Environment directory.

Patch 1 December 2008
- Added JAPI enhancements to simplify accessing and setting values for beliefs, facts, parameters, and variables. Additional methods were added to IActiveInstance, IWorldState, and AbstractExternalActivity.
- Added a State Viewer and breakpoint activity to allow modelers to inspect the state of an actor at runtime. A breakpoint activity was added to the BaseGroup and BaseClass concepts. An actor can anywhere in the body of a workframe have the actor perform that activity. When that activity is performed the State Viewer is displayed, displaying the frame instantiation agenda for that actor (current, available, interrupted, impassed frame instantiations). For an actor its current belief set can be displayed and for a frame instantiation its details including variable bindings.
- Added methods to obtain BrahmsGroupDescriptor and BrahmsClassDescriptor from the JAPI class.
- Enabled support for starting, pausing, resuming, stopping the Brahms VM using the JAPI.
- Fixed an issue in the Agent Viewer where the display text in history elements could not be greater than 255 characters, the maximum size is now 65K.
- Fixed the getValue methods in the descriptors to return null when the attribute value is unknown.
- Fixed a possible NullPointerException in resetting an external agent when shutting down the virtual machine.
- Fixed an issue in logging reporting failures via the agent monitor when no cause/exception is present. Now just using the message as the cause
- Changed the checksum routines used in the VerifyChecksum and CopyFile activities for empty files, now returning the checksum value of 0 for an empty file.
- Fixed the copy file activity to supporting copying of large files > 64MB.
- Changed the virtual machine to no longer invoke the start/stop methods on an external agent if the external agent failed to initialize.
- Updated the retract belief activities to now also allow for a 'fromActor' argument to be passed to retract a belief from an actor other than the actor performing the retractBelief activity. This allows for retraction of beliefs from data objects that do not have any behavior. BaseGroup and BaseClass include additional retractBelief and retractBeliefValue declarations.
- Added the ability to set the network interface to use to join a multicast group; property name: multicast.interface. This can be a useful property on multihomed hosts with a firewall configured to permit multicasting only on a single interface.
- Fixed the multicast tester to verify that the content of a received packet is indeed a string before extracting the value.
- Added addProcessListener and removeProcessListener methods to the IVMController interface in the JAPI.
- Fixed an issue with unknown preconditions when they use a variable for the collection index in the condition for a map type attribute. Those preconditions were incorrectly evaluated.
- Fixed Get/SetCommunicativeActProperty Java activities to support the value unknown.
- Added a BrahmsGroupDescriptor similar to BrahmsClassDescriptor to easily obtain belief values for attributes/relations declared for an agent of that group.
- Added set/get value methods to the BrahmsClassDescriptor and BrahmsGroupDescriptor that now also allow you to specify the lhsConcept for the belief from/for which to obtain/set the value.
- Fixed a NullPointerException in the Brahms/Java conversion API where the converters did not check for a null Brahms/Java instance mapping.
- Fixed an issue in the Brahms/Java conversion API where the converters did not properly prevent circular loops.
- Updated the CI Interface and CI Process Manager with additional failure monitoring support.


 


Brahms Eclipse Composer Plug-in V1.0.12

In addition to the Brahms Composer you can now also download and install an Eclipse plug-in for Brahms. It does not have all of the features offered by the Composer, its feature set consists of package management, source code editing, and compilation supporting the enhanced source code editing features expected in Eclipse. The plug-in does not yet offer the design views nor does it offer an integrated agent viewer. The plug-in has been tested with Eclipse version 3.2 and 3.3.

New Installation

To download and install the Eclipse plug-in:

1. Start Eclipse.

2. Go to 'Help->Software Updates...->Find and Install...'.

3. Select 'Search for new features to install'.

4. Press the button 'New Remote Site...'

5. Enter a name (Brahms Composer Plug-in) and for the URL enter: 'http://www.agentisolutions.com/eclipse'

6. Back in the 'Install' dialog you should see the name you entered in the list of sites to include in the search. Make sure that site is selected and press the 'Finish' button.

7. A dialog is displayed listing the features available from that site. In this case there is only one feature - 'Composer'. Select that feature and click next to step through the installation process.

8. After installation you will be asked to restart Eclipse. After the restart you will be able to open the Brahms Perspective by selecting 'Window->Open Perspective->Other...'. You should see Brahms in the list of perspectives.

9. Create new projects using the 'File->New' menu.

Plug-in Update

If you already installed the plug-in and want to update it:

1. Start Eclipse.

2. Go to 'Help->Software Updates...->Manage Configuration'.

3. Open the Eclipse SDK folder as well as the Eclipse installation folder. You should see 'Brahms Composer Plug-in <version>' listed. Select this item.

4. Click the link 'Scan for Updates'

5. In the Updates select the site (http://www.agentisolutions.com/eclipse/site.xml' and press 'Next'

6. Accept the license, press 'Next' and on the second page press 'Finish'.

7. The update will now be installed. After installation you will be asked to restart Eclipse. Do so and the update will be available.

Top


Documentation

Top


Questions or problems regarding this web site should be directed to the Webmaster.
Copyright © 2001-2008 NASA Ames Research Center. All rights reserved.
Last modified: Monday December 01, 2008.