{"id":604,"date":"2022-04-05T14:43:30","date_gmt":"2022-04-05T13:43:30","guid":{"rendered":"http:\/\/perf.unime.it\/magnet\/?page_id=604"},"modified":"2022-04-20T07:49:22","modified_gmt":"2022-04-20T06:49:22","slug":"markovian-agents-deployment","status":"publish","type":"page","link":"http:\/\/perf.unime.it\/magnet\/?page_id=604","title":{"rendered":"Markovian agents deployment"},"content":{"rendered":"\n
Error m3am_NewAgent(M3AM *model, const char *agent_label, const char *class_label, Point *coordinates, Density csi);<\/strong><\/code><\/pre>\n\n\n\n
m3am_NewAgent<\/code> creates an agent, whose name is agent_label<\/code>, belonging to the class class_label<\/code> in the model referenced by model<\/code>; multiple agents are located in position coordinates<\/code> with density csi<\/code>. Parameter coordinates<\/code> is assumed to be an array whose dimensions are the space dimension declared when the model is created with m3am_NewModel<\/code>. csi<\/code> must be a non negative value, otherwise an error code is returned. If either class_label<\/code> class or message_label<\/code> message are not defined an error code is returned. Two Markovian agents with the same name cannot exist in the same model; creating a Markovian agent with an already used name returns an error code.
Returned values are as in the following:<\/p>\n\n\n\n
NOERR<\/td>no error<\/td><\/tr>
EORANGE<\/td>density value is out of range<\/td><\/tr>
ENOOP<\/td>already defined Markovian agent name<\/td><\/tr>
ENOMEM<\/td>memory allocation error<\/td><\/tr>
ENOCL<\/td>class name does not exist<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
 
<\/p>\n\n\n\n
Error m3am_AddPer(M3AM *model, const char *msg, const char *rx, const char *tx, NumStates r, NumStates c, double val);<\/strong><\/code><\/pre>\n\n\n\n
m3am_AddPer<\/code> is the main tool for setting the values of the perception functions into the model model<\/code>. A perception function per message can be defined by assigning probability val<\/code> to perceive a message msg<\/code> by the agent rx<\/code> in the state r<\/code> when the agent tx<\/code> transmits<\/em> it leaving the state c<\/code>. Message must be previously defined in the class of agent tx<\/code> with m3am_NewMSG<\/code> and generated with m3am_AddMsgGenProb<\/a><\/code>; the state c of transmitting agent is the state r<\/code> as defined in m3m_addMsgGenProb<\/a><\/code>. Both transmitting and receiving agents names must be defined, val<\/code> must be a correct probability value, and r<\/code> and c<\/code> must be valid states.
Returned values are as in the following:<\/p>\n\n\n\n
NOERR<\/td>no error<\/td><\/tr>
ENOPR<\/td>not correct probability value<\/td><\/tr>
ENOMA<\/td>agent not found<\/td><\/tr>
ENOMES<\/td>message name does not exist<\/td><\/tr>
EORANGE<\/td>state index out of range<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
 
<\/p>\n\n\n\n

It is useful to scan messages<\/em> and agent classes<\/em> one by one when perceptions functions are built. The following functions are provided to this purpose.<\/p>\n\n\n\n
Class m3am_ClassIterator(M3AM *model);<\/strong><\/code><\/pre>\n\n\n\n
m3am_ClassIterator<\/code> returns a reference to the first agent class object in the set of agent classes defined with m3am_NewClass<\/code> in the model model<\/code>.<\/p>\n\n\n\n

<\/p>\n\n\n\n
Class m3am_NextClass(Class cl);<\/strong><\/code><\/pre>\n\n\n\n
m3am_nextClass<\/code> returns a new not visited agent class from the nearest call to m3am_ClassIterator<\/code>. Note that repeated call to m3am_nextClass<\/code> iterates over the set of agent classes until all of them have been visited. A NULL value is returned when all the agent classes have been visited.<\/p>\n\n\n\n

<\/p>\n\n\n\n
short m3am_ClassIs(Class cl, const char *class_label);<\/strong><\/code><\/pre>\n\n\n\n
m3am_ClassIs<\/code> evaluates to 1 if the agent class cl<\/code> is named class_label<\/code>, otherwise it evaluate to 0. m3am_ClassIs<\/code> can be used to check the name of an agent class referenced by iterator.<\/p>\n\n\n\n

<\/p>\n\n\n\n
short m3am_ClassIsValid(Class cl)<\/strong><\/code><\/pre>\n\n\n\n
m3am_ClassIsValid<\/code> evaluates to 1 if cl references a correct agent class, otherwise it evaluates to 0.<\/p>\n\n\n\n
The following C source code visits all the agent classes defined in the model myModel, previously defined and populated with agent classes, looking for the class named “myClass”:<\/p>\n\n\n\n

myModel=m3am_NewModel(\"My_Markovian_Agent_model\", 2);
  .
  .
  .
Class c=m3am_ClassIterator( myModel );
while( m3am_ClassIsValid( c ) ) {
     if ( m3am_ClassIs( c, \"myClass\") )
           printf( \"The class agent has been found);
     c = m3am_nextClass( c );
}
\ufeff<\/code><\/pre>\n\n\n\n

<\/p>\n\n\n\n
Message m3am_MessageIterator(M3AM *model);<\/strong><\/code><\/pre>\n\n\n\n
m3am_MessageIterator<\/code> returns a reference to the first message object in the set of messages defined with m3am_NewMessage<\/code> in the model model<\/code>.<\/p>\n\n\n\n

<\/p>\n\n\n\n
Message m3am_NextMessage(Message msg);<\/strong><\/code><\/pre>\n\n\n\n
m3am_nextMessage<\/code> returns a new not visited message from the nearest call to m3am_MessageIterator<\/code>. Note that repeated calls to m3am_nextMessage<\/code> iterates over the set of messages until all messages have been visited. A NULL value is returned when all the messages have been visited.<\/p>\n\n\n\n

<\/p>\n\n\n\n
int m3am_MessageIs( Message msg, const char *message_label);<\/strong><\/code><\/pre>\n\n\n\n
m3am_MessageIs<\/code> evaluates to 1 if the message msg<\/code> is named message_label<\/code>, otherwise it evaluate to 0. m3am_MessageIs<\/code> can be used to check the name of a message referenced by iterator.<\/p>\n\n\n\n

<\/p>\n\n\n\n
short m3am_MsgIsValid(Message msg);<\/strong><\/code><\/pre>\n\n\n\n
m3am_MsgIsValid<\/code> evaluates to 1 if msg<\/code> references a correct message, otherwise it evaluates to 0.<\/p>\n\n\n\n
The following C source code visits all the messages defined in the model myModel, previously populated with messages, looking for the message named “myMessage”:<\/p>\n\n\n\n

myModel=m3am_NewModel(\"My_Markovian_Agent_model\", 2);
  .
  .
  .
Message m=m3am_MessageIterator( myModel );
while( m3am_MsgIsValid( m ) ) {
     if ( m3am_MessageIs( c, \"myMessage\") )
           printf( \"The message has been found);
     c = m3am_nextMessage( c );
}
\ufeff<\/code><\/pre>\n\n\n\n

<\/p>\n\n\n\n
\n\n\n\n\n
Prev<\/a><\/div>\n\n\n\n\n\n
Next<\/a><\/div>\n\n\n<\/div>\n","protected":false},"excerpt":{"rendered":"
m3am_NewAgent creates an agent, whose name is agent_label, belonging to the class class_label in the model referenced by model; multiple agents are […]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-604","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=\/wp\/v2\/pages\/604","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=604"}],"version-history":[{"count":29,"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=\/wp\/v2\/pages\/604\/revisions"}],"predecessor-version":[{"id":786,"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=\/wp\/v2\/pages\/604\/revisions\/786"}],"wp:attachment":[{"href":"http:\/\/perf.unime.it\/magnet\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=604"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}