{"id":296,"date":"2021-03-11T13:43:30","date_gmt":"2021-03-11T12:43:30","guid":{"rendered":"http:\/\/blog.uclm.es\/felixvillanueva\/?p=296"},"modified":"2021-03-11T13:43:30","modified_gmt":"2021-03-11T12:43:30","slug":"argumentos-de-entrada-en-simulaciones-de-ns3","status":"publish","type":"post","link":"https:\/\/blog.uclm.es\/felixvillanueva\/2021\/03\/11\/argumentos-de-entrada-en-simulaciones-de-ns3\/","title":{"rendered":"Argumentos de entrada en simulaciones de NS3"},"content":{"rendered":"

Para ahorrarte trabajo, puedes configurar mediante argumentos de entrada muchos par\u00e1metros o atributos de tu simulaci\u00f3n, tanto de los m\u00f3dulos que usas de NS3, como definir tus propios par\u00e1metros. Por ejemplo, si vas a simular el tr\u00e1fico en una red lorawan con topolog\u00eda en estrella, con la pasarela en el medio, puedes poner como par\u00e1metro configurable el n\u00famero de nodos o el radio de la estrella. Este ejemplo es el que vamos a utilizar para explicar c\u00f3mo gestionar los argumentos de entrada. El archivo que usaremos es el lorawan.cc del repositorio<\/a>. Necesitar\u00e1s instalar el m\u00f3dulo de lorawan como indicamos aqu\u00ed<\/a><\/p>\n

Si copiamos el archivo lorawan.cc al directorio scratch de nuestra instalaci\u00f3n NS3 podemos ver qu\u00e9 argumentos podemos definir por la linea de comandos mediante la opci\u00f3n –PrintHelp, esto es:
\n
\n$ .\/waf --run \"lorawan --PrintHelp\"
\nlorawan [Program Options] [General Arguments]
\n[...]
\nProgram Options:
\n--radio: Radio of the disc where random put the nodes [20]
\n--numnodes: Num. nodes in the grid for simulating [20]<\/code><\/p>\n


\n<\/code>General Arguments:
\n--PrintGlobals: Print the list of globals.
\n--PrintGroups: Print the list of groups.
\n--PrintGroup=[group]: Print all TypeIds of group.
\n--PrintTypeIds: Print all TypeIds.
\n--PrintAttributes=[typeid]: Print all attributes of typeid.
\n--PrintHelp: Print this help message.
\n<\/code>
\nComo podemos ver, despu\u00e9s de los mensajes de compilaci\u00f3n (sustituidos por […]), podemos ver que el programa lorawan tiene definidos dos opciones, el radio y el numnodes, indicando el radio de la estrella y el n\u00famero de nodos respectivamente. El n\u00famero por defecto en ambos casos y si no indicamos esas opciones es 20. Si queremos simular 3 nodos en una topolog\u00eda en estrella con un radio de 10 metros, solo tendremos que indicarlo en l\u00ednea de argumentos:
\n$ .\/waf --run \"lorawan --numnodes=3 --radio=10\"
\n[...]
\n<\/code>
\nSi analizamos el archivo lorawan.cc, la definici\u00f3n de argumentos es relativamente sencilla, en primer lugar se indica que vamos a parsear la l\u00ednea de comandos en busca de atributos y se definen las variables que almacenar\u00e1n los valores que se pasen por l\u00ednea de comandos:
\n
\n#include \"ns3\/command-line.h\"
\n[...]
\ndouble radio = 20.0;
\nint numnodes = 20;
\n<\/code>
\nA continuaci\u00f3n se definen los valores esperados en l\u00ednea de argumentos, en nuestro ejemplo, lo hacemos mediante una funci\u00f3n que definimos antes del main y a\u00f1adimos al final. En esta funci\u00f3n creamos la variable que almacenar\u00e1 y parsear\u00e1 los argumentos y a\u00f1adimos nuestros dos argumentos esperados mediante AddValue:
\n
\nCommandLine setupcmd(){
\nCommandLine cmd;
\ncmd.AddValue (\"radio\", \"Radio of the disc where random put the nodes\", radio);
\ncmd.AddValue (\"numnodes\", \"Num. nodes in the grid for simulating\",numnodes);
\nreturn cmd;
\n}
\n<\/code>
\ncomo puedes ver indicamos el nombre, una peque\u00f1a ayuda y las variables que van a almacenar los valores.
\nFinalmente, parseamos la l\u00ednea de comandos:
\n
\n[..]
\nCommandLine cmd =setupcmd();
\ncmd.Parse (argc, argv);
\n[..]
\n<\/code>
\nCon lo que en las variables definidas a tal efecto, guardaremos los valores que le pasemos.<\/p>\n

Aparte de poder definir nuestros propios argumentos de entrada para configurar nuestras simulaciones, muchos m\u00f3dulos que usamos tienen sus propios atributos configurables por l\u00edneas de comandos. Por ejemplo, si queremos ver un listado de todos los m\u00f3dulos disponibles, podemos verlos con la opci\u00f3n –PrintTypeIds
\n
\n.\/waf --run \"lorawan --PrintTypeIds\"
\nWaf: Entering directory `\/home\/felix\/tools\/ns-allinone-3.30\/ns-3.30\/build'
\nWaf: Leaving directory `\/home\/felix\/tools\/ns-allinone-3.30\/ns-3.30\/build'
\nBuild commands will be stored in build\/compile_commands.json
\n'build' finished successfully (1.112s)
\nRegistered TypeIds:
\nns3::A2A4RsrqHandoverAlgorithm
\nns3::A3RsrpHandoverAlgorithm
\n[..]
\nns3::LoraChannel
\nns3::LoraInterferenceHelper
\nns3::LoraNetDevice
\nns3::LoraPhy
\nns3::LoraRadioEnergyModel
\nns3::LoraTag
\nns3::LoraTxCurrentModel
\n[...]
\n<\/code>
\nEn esa larga lista, podemos explorar qu\u00e9 atributos son configurables mediante la opci\u00f3n –PrintAttributes y el identificador o nombre del m\u00f3dulo. Por ejemplo, si queremos saber qu\u00e9 atributos puedo especificar mediante l\u00ednea de comandos del m\u00f3dulo de ns3 LoraRadioEnergyModel, podemos ejecutar:
\n
\n$ .\/waf --run \"lorawan --PrintAttributes=ns3::LoraRadioEnergyModel\"
\nWaf: Entering directory `\/home\/felix\/tools\/ns-allinone-3.30\/ns-3.30\/build'
\nWaf: Leaving directory `\/home\/felix\/tools\/ns-allinone-3.30\/ns-3.30\/build'
\nBuild commands will be stored in build\/compile_commands.json
\n'build' finished successfully (1.063s)
\nAttributes for TypeId ns3::LoraRadioEnergyModel
\n--ns3::LoraRadioEnergyModel::RxCurrentA=[0.0112]
\nThe radio Rx current in Ampere.
\n--ns3::LoraRadioEnergyModel::SleepCurrentA=[1.5e-06]
\nThe radio Sleep current in Ampere.
\n--ns3::LoraRadioEnergyModel::StandbyCurrentA=[0.0014]
\nThe default radio Standby current in Ampere.
\n--ns3::LoraRadioEnergyModel::TxCurrentA=[0.028]
\nThe radio Tx current in Ampere.
\n--ns3::LoraRadioEnergyModel::TxCurrentModel=[0]
\nA pointer to the attached tx current model.<\/code><\/p>\n


\n<\/code><\/code>
\nDonde podemos ver que podemos definir la corriente de env\u00edo, recepci\u00f3n, dormir, etc.<\/p>\n","protected":false},"excerpt":{"rendered":"

Para ahorrarte trabajo, puedes configurar mediante argumentos de entrada muchos par\u00e1metros o atributos de tu simulaci\u00f3n, tanto de los m\u00f3dulos que usas de NS3, como definir tus propios par\u00e1metros. Por ejemplo, si vas a simular el tr\u00e1fico en una red … Sigue leyendo →<\/span><\/a><\/p>\n","protected":false},"author":182,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4,5,6],"tags":[10,11,26,27,29,35,38],"class_list":["post-296","post","type-post","status-publish","format-standard","hentry","category-ns3","category-simulacion","category-tutorial","tag-argumentos","tag-atributos","tag-iot","tag-iot-ns3-ejemplo","tag-lorawan","tag-redes","tag-simulacion"],"_links":{"self":[{"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/posts\/296","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/users\/182"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/comments?post=296"}],"version-history":[{"count":0,"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/posts\/296\/revisions"}],"wp:attachment":[{"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/media?parent=296"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/categories?post=296"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.uclm.es\/felixvillanueva\/wp-json\/wp\/v2\/tags?post=296"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}