Accueil

English version

Présentation

MCMAS est une bibliothèque visant à faciliter l'exécution de systèmes multi-agents (SMA) sur architectures GPU et many-core. Pour cela, la bibliothèque offre deux interfaces distinctes :

• Une interface de haut niveau consituée d'opérations génériques regroupées en plugins.
• Une interface bas niveau pour concevoir de nouveaux traitements, MCM (Many-Core Manager).

Téléchargement

Il est possible de récupérer une copie de la bibliothèque à l'aide
du logiciel git :

git clone http://mesogit.univ-fcomte.fr/glaville/mcmas.git

Des archives seront bientôt mises à disposition après la sortie d'une version stable du logiciel.

Dépendances

Pour son fonctionnement, MCMAS dépend de la disponibilité du support OpenCL sur la machine d'exécution. Ce support est généralement inclus dans les pilotes fournis par votre fabriquant, sous Windows ou Mac OS X.
Dans le cas des distributions Linux, ce support est souvent géré par un paquet indépendant.

MCMAS requiert au minimum Java 5.0 ou supérieur installé, ainsi que le logiciel Apache Ant pour la compilation des sources. Toutes les autres dépendances sont incluses dans le dépôt ou peuvent être automatiquement téléchargées, comme détaillé dans la section Installation.

Installation

En cas de récupération depuis GIT, l'archive MCMAS ne contient aucun binaire précompilé. Pour obtenir cet exécutable, il est tout d'abord nécessaire de récupérer la dernière version des dépendances du logiciel :

ant resolve

Le JAR (fichier exécutable) peut ensuite être généré à l'aide de la commande suivante. Il sera stocké dans le répertoire "lib/" de l'archive, en tant que fichier mcmas.jar, prêt à être utilisé :

ant jar

Une archive JAR contenant à la fois MCMAS et ses dépendances peut également être générée, pour faciliter la distribution de la bibliothèque avec d'autres programmes :

ant bundle

Documentation

Il est possible de générer la documentation de la bibliothèque à l'aide de la commande suivante :

ant doc

La documentation au format HTML sera alors stockée dans le sous répertoire "doc/"

Exemples

Des exemples d'utilisation de MCMAS sont disponibles dans le répertoire "src/core/examples" de l'arborescence des sources. Ces exemples comprennent en particulier la manipulation de vecteurs, ou une implémentation du jeu de la vie, pour illustrer le fonctionnement de la bibliothèque.

Trois modèles agents sont inclus avec l'archive, à titre d'exemples :

• Le modèle MIOR, dans le répertoire "src/mior"
• Le modèle Collemboles, dans le répertoire "src/collembola"
• Le modèle Proies-Prédateurs, dans le répertoire "src/preypredator"

Les deux premiers modèles reposent sur l'utilisation de l'interface MCM. Le dernier met en évidence l'utilisation de plugins MCMAS dans le cadre d'un SMA existant.