MAGNET 1.0 is provided with a new Application Program Interface (API). It has been designed mainly for better accessing new solution numerical methods for evaluating a model; at the same time the naming has been changed to be compliant with the usual naming adopted in most library functions.
The Markovian agents interaction mechanism supported by MAGNET is the message passing based mechanism; other mechanisms are planned to be implemented in future releases.
In the new 1.0.0 version, MAGNET uses the Gnu Scientific Library (GSL) for manipulating matrices and vectors; as such, MAGNET inherits data types about vectors and matrices, their operations, and error management from the GSL layer. Detailed documentation of GSL features can be found in the official web site and are not described here.
When a new model is designed with MAGNET a C file is produced. At time compilation GSL library are linked to the executable, thus GSL must be installed in the system where the C source file is compiled; GSL libraries are not provided with MAGNET. Current version (ver 1.0) has been tested with GSL 2.7.
API Functionalities
Groups of routines identify functionalities in MAGNET. Functions and data types are defined in the header file magnet.h
The main functionalities provided are aimed to:
- create a new Markovian agent model
- deploying agents over the space (the space is assumed n-dimensional)
- defining and starting model analysis
Specific data types are defined to this purpose.