160 likes | 278 Views
Documentazione assistita di ABMs (Agent- Based Models ). Relatore Prof. Vittorio Scarano Dott. Carmine Spagnuolo. Candidato Simone Romano. Struttura della presentazione. Panoramica modelli di simulazione basati sugli agenti - MASON ODD Protocol e MASON Doxygen Può aiutarci?
E N D
Documentazione assistita di ABMs(Agent-BasedModels) Relatore Prof. Vittorio Scarano Dott. Carmine Spagnuolo Candidato Simone Romano
Struttura della presentazione • Panoramica modelli di simulazione basati sugli agenti - MASON • ODD Protocol e MASON • Doxygen • Può aiutarci? • Soluzione proposta: Plugin per Eclipse • Caratteristiche • Conclusioni Automatic ABMs documentation - Simone Romano
Sistemi multi-agente • Branca relativamente nuova dell’informatica: • Primi studi: anni ‘80 • Diffusione: circa metà anni ‘90 • STRUTTURA • Agenti (entità autonoma) • Ambiente Automatic ABMs documentation - Simone Romano
MASON “MASON is a fast discrete-event multiagent simulation library core in Java” STRUTTURA • Agenti - Steppable • Ambiente – SimState OBIETTIVO: Generazioneassistita di documentazione di programmi MASON Automatic ABMs documentation - Simone Romano
Idea • Procedura guidata mirata alla generazione documentazione
Come si documenta un ABMs? MASON • Definito dall’utente • Ambiente, Agenti, variabili • Lista azioni eseguite in • start() SimState • step() Steppable • Definito dall’utente • Valore iniziale delle variabili • Definito dall’utente • Pseudo-codice delle azioni elencate in 3 ODD Protocol • Purpose • Entities, State variables and scales • Processoverview and scheduling • Design concepts • Initialization • Input • Submodels
Doxygenis the de facto standard tool for generatingdocumentation from annotated C++ sources, butitalsosupportsotherpopularprogramminglanguagessuchas C, Objective-C, C#, PHP, Java, Python, IDL (Corba, Microsoft, and UNO/OpenOfficeflavors), Fortran, VHDL, Tcl, and to some extent D. AutomaticABMsdocumentation - Simone Romano
Ricreiamo ODD • Parsingdel codice • Generazione automatica di informazioni • Informazioni inserite dall’utente • Generazione commenti al codice Automatic ABMs documentation - Simone Romano
Plug-in – caratteristiche 1 • Generazione pseudocodice • Fasi Processoverview and scheduling, Submodels di ODD • Selezione colore output • Separazione tra commenti autogenerati e commenti inseriti dall’utente Definito dall’utente Generato dal plugin Generato da Doxygen
Plug-in – caratteristiche 2 • Pulizia del codice
Plug-in – caratteristiche 3 • Iterabilità • ODD object • Output type • Doxygen • Pdf-Rtf (iTextlibrary) • Txt
Flusso degli eventi • Purpose • Entities, state variables and scales • Processoverview and scheduling • Design concepts • Initialization • Input • Submodels Doxygen • Pdf • Rtf • txt New ODD object INTRO OUTPUTChoice … ODD serializedobject
Conclusioni • OBIETTIVO INIZIALE • Documentare programmi di simulazione multi-agente scritti in Java con libreria MASON • PRODOTTO REALIZZATO • Supporta l’utente durante la fase di documentazione • Struttura la documentazione secondo uno standard noto (ODD)