###############################################################################
Advanced RTI System, ARTÌS			http://pads.cs.unibo.it
###############################################################################
		
©Copyright 2002-2013                      Gabriele D'Angelo, Michele Bracuto

University of Bologna	      Department of Computer Science and Engineering

http://pads.cs.unibo.it                                 <g.dangelo@unibo.it>

----------------------------------------------------------------------------
			Migrating Agents (mig-agents)
----------------------------------------------------------------------------

This is a quite simple model that shows how to use the GAIA/GAIA+ framework 
to simulate a set of interacting agents.

To understand the source code structure please see the comments on top of
the file: (mig-agents.c).

The most part of the user level simulation model is in the 
(user_event_handlers.c) source file. The easy way to implement a more 
complex model is to modify this example. It has been written in such a way
it should be very easy to add new variables to the state of simulated
entities and to implement new interaction types.

-------------------------------------------------------------------------------
SOURCE CODE COMPILATION:

Fist of all, it is necessary to compile the example source code, this can
be done using the provided Makefile (execute the "make" command in the 
MIGRATION-AGENTS directory). In case of errors, please check carefully the 
missing libraries or version incompatibilities.
-------------------------------------------------------------------------------

EXECUTION:

A single main script is provided for the simulator's execution. This script
is a wrapper for other specialized scripts.

run	
	executes a single run of the simulation, it blocks until
	all LPs have finished 

	mandatory input parameters = #TOT_LP #LP #IA
	#TOT_LP         total number of LPs in the simulation
	#LP             number of Logical Processes to execute in this host
	#IA             total number of Interacting Agents to simulate
			(e.g. each LP will simulate #IA / #TOT_LP devices)

	example: ./run 4 4 1000
		it runs a parallel simulation composed of 4 LPs
		in which each LP models 250 IAs
		all the LPs will be executed in this host
