== MAS-Output ==

[[TracNav(doc/tec/mastoc|nocollapse)]]

[[NoteBox(note,This page is part of the **Multi Agent System** (MAS) documentation. \\ It contains an overview of MAS-related PALM output. \\ For an overview of all MAS-related pages\, see the **[wiki:doc/tec/mas MAS main page]**.)]]

There are four kinds of MAS-related data that can be used to analyse MAS-runs.

 * **NetCDF Output**\\ All agent output data is written to the file [wiki:doc/app/iofiles#DATA_AGT_NETCDF DATA_AGT_NETCDF].

 * **Warning Message**\\ During a PALM run using the MAS a warning message ([wiki:doc/app/errmsg#PA0420 PA0420]) can occur (in the console or job protocol). If this is the case, [wiki:doc/app/iofiles#DATA_AGT_NETCDF DATA_AGT_NETCDF] will be missing data. Use the informative message [wiki:doc/app/errmsg#PA0457 PA0457] to adjust the allocated file size prior to your next simulation

 * **Informative Message**\\ At the end of each PALM run using the MAS an informative message ([wiki:doc/app/errmsg#PA0457 PA0457]) about the maximum number of agents during the simulation is given (in the console or job protocol). Use it to adjust [wiki:doc/app/agent_parameters#dim_size_agtnum_manual dim_size_agtnum_manual] to save memory or avoid data loss during your next simulation.

 * **CPU_MEASURES**\\ 
    * **mas**                Total MAS run time
    * **mas_data_output**    MAS data output (high rms is expected as output is done on one PE only)
    * **mas_move_exch_sort** Moving agents to their respective grid cells, exchange between PEs and sorting of agent arrays
    * **mas_social_forces**  Agent interaction with obstacles and each other
    * **mas_timestep**       Time integration of Agent velocities and positions

**NOTE:** Large load imbalances between PEs are very possible when using the MAS. This results from the utilized storage scheme.