Graphical User Interface for Puglia Sostenibile.
Puglia Sostenibile is a portable software that enables the user to monitor semantic consistency with the Sustainable Development Goals (also known as SDGs) within institutional documents such as, for instance, laws, strategies, planning acts, etc. , written in italian.
The sensitivity towards the relationships between man and environments, and of individuals among them, as well as the perception of responsibility towards future generations have progressively increased in decision-makers over the last few decades, leading to orient the action of instituzions and individuals in a decisive way towards Sustainable Development.
In September 2015, all 193 United Nations Countries, including Italy, conceived an action plan to contribute to global development, promote human well-being and protect the environment.
The need to guarantee a better present and future for our Planet and the people who inhabit it has resulted in the definition and sharing of Sustainable Development Goals - whose acronym is SDGs - to be achieved by 2030: this gives rise to the Agenda 2030 which aims to act collectively in a sustainable way towards 17 goals divided into 169 targets in relation to the various domains of social and economic development.
For further informations consult the United Nations web page.
Computer Science plays a key role in handle social and environmental challenges with regard to a sustainable future.
Similarly to the European Commission's platform, KnowSDGs, which currently refers to European Regulations, written in English, Puglia Sostenibile is capable of verifying how much a document is lexically consistent with what is stated in the Agenda 2030.
The software has been "trained", in particular, through the analysis of the more than 2000 Regional Laws, enacted in Puglia in the last 50 years.
The activity is part of the institutional collaboration between Apulian Regional Council, represented by the President Loredana Capone, and the Study and Support Section for Legislation and Guarantee Policies, at UNIBA (University of Bari, Aldo Moro) and, in particular, it was carried out as a part of an internal internship at the headquarters of the Intelligent Systems Laboratory of the local DIB (Computer Science Department), chaired by Prof. Giuseppe Pirlo all under the supervision of Dr. Michele Chieco and Dr. Gabriella Calvano.
The use of the software, although tested on the Apulian Regional Laws, can be extended to other similar documents of different territorial levels or to other texts in general: by loading the document, the software will return the SDGs based on the analysis of the text.
As in the case of the KnowSDGs European platform, the analysis carried out by the software is based on the recurrence of words and their associations and not on a content evaluation which can, instead, be the subject of specific comparative studies between the text in question and the Agenda 2030.
In the foreground of the logo you can notice the shape of a tree that brings to mind the idea of Nature and the complexity of mechanisms and interrelations that connect living beings with each other and with the environment.
In fact, sustainability should not be considered only in reference to acting positively for the sake of the environment but also in relationships, in equity, in mutual care.
Branches emerge from the trunk of the tree, the ends of which are shaped into arrows; each arrow points towards different directions that represent various declinations of sustainability and which, although divergent, all arise from the same principle: the common good can only be reached though common action.
Th Earth, behind the tree, is the presence that must always remind us of our condition of being inhabitants of the same place with limited resources that encourage us to take common action for their protection, if we want its good, and, at the same time, it stimulates to obatin that much-needed change.
And it's exactly for this reason that, behind the tree, we glimpse the Earth which has an ambivalent meaning: it spurs us to act for her good and, at the same time, stimulates a common action to obtain that much-needed change.
The logo was designed by the graphic expert Nicola Surgo.
Puglia Sostenibile is easy as a pie!
And to provide a better experience, it comes with an intelligible yet pleasant graphical user interface.
You can either choose to download the executable PugliaSostenibile.exe or charge it via command line.
If you choose to download the .exe, the software is ready to be used while if you choose the command line option please read the section below for a correct execution.
First thing, since the progam is Python 3 based, you need to install it on your machine.
Beware: current packages versions are NOT compatible with Python 3.10. Please install Python 3.9 or below.
Open the command prompt and jump to the PugliaSostenibileGUI folder.
Assuming the folder is in "C:\PugliaSostenibileGUI" you just need to type in the command line the following instructions:
cd "C:\\PugliaSostenibileGUI"
py PugliaSostenibile_GUI.py
If it is the first launch of the program or the program detects missing packages, an installation window will pop-up asking you the authorization to download and install these lasts. Please make sure that your device has network connectivity.
Check the box and click on the "Avanti" button: Puglia Sostenibile will, finally, open.
Puglia Sostenibile can be divided into six main sections:
- Home Page: it's the main page. You can simply upload the document (allowed extensions: '.pdf', '.docx', 'txt' only) by clicking on the "Seleziona Documento" button. Then, press "Start" and the software will compute the three first most relevant SDGs.
You can, also, find the occurrences of a keyphrase: you just need to insert it in the box, click on the "Cerca" button and the software will tell you how many times it occurs into the document;
- Info Page: In this section you can find informations about the Agenda 2030 and Puglia Sostenibile;
- Advanced Page: In this page you can change some advanced properties:
- Grammage: To understand this feature, you need to know that Puglia Sostenibile computes the most relevant SDGs by means of the Cossim Similarity. This last is based on a TFIDF matrix between all of the SDGs and the law. To perform the computation, each content needs to be divided into keyphrases. Is given the user the opportunity to choose the grammage of the keyphrase which is the maximum number of words by which each keyphrase is composed of. By default the Grammage is setted to unigram (each keyphrase is composed by one token, only) but you can also choose bigram, in which case each keyphrase will be composed by one or two tokens.
- SGDs vs Targets: by default the software reveals the three most relevant SDGs but it is also given to you the chance to find out the most relevant Targets by checking the pertinent button.
- Agenda 2030 Page: in this page you can consult the Agenda 2030;
- Contacts Page: if you encounter any troubles with something or want to submit some feedback, in this section you can find the contacts you need: any suggestions for improvement are welcome!
- Browes SDGs Page: at any moment, if you need to consult the SDGs you can simply click on the "Sfoglia gli SDGs" button and a window will instantly pop-up allowing you to discover the related goal and targets.
Puglia Sostenibile is an UWP (Universal Windows Platform) this means that it is compatible with several windows version, according to the windows SDK requirements.
The following libraries were used to create Puglia Sostenibile:
- it-core-news-sm module
- nltk
- numpy
- pandas
- PyMuPDF (GUI purposes)
- PyPDF2
- python-docx
- scikit-learn
- scipy
- spacy
- tkinter (GUI purposes)
- tkPDFViewer (GUI purposes)
Italiano
Interfaccia grafica per Puglia Sostenibile.
Puglia Sostenibile è un'applicazione' portabile che permette all'utente di monitorare la coerenza semantica con gli Obiettivi di Sviluppo Sostenibile (acronimo OSS o SDGs) all'interno di documenti istituzionali quali, ad esempio, leggi, strategie, atti di programmazione, ecc., scritti in lingua italiana.
La sensibilità verso le relazioni tra uomo e ambiente, e degli individui tra loro, e la percezione della responsabilità verso le future generazioni sono progressivamente aumentate nei decisori nel corso degli ultimi decenni portando ad orientare l'azione delle istituzioni e dei singoli in modo deciso verso lo Sviluppo Sostenibile.
Nel settembre 2015, tutti i 193 Paesi delle Nazioni Unite , tra cui l’Italia, hanno concepito un piano d’azione per contribuire allo sviluppo globale, promuovere il benessere umano e proteggere l’ambiente.
Il bisogno di garantire un presente ed un futuro migliore al nostro Pianeta e alle persone che lo abitano è sfociato nella definizione e condivisione di Obiettivi di Sviluppo Sostenibile (Sustainable Development Goals – il cui acronimo inglese è SDGs) da raggiungere entro il 2030: è nata, così l’Agenda 2030 che si propone di agire collettivamente in modo sostenibile verso 17 obiettivi, o goal, declinati in 169 traguardi, anche detti target, in relazione ai vari domini dello sviluppo sociale ed economico.
Per maggiori informazioni consultare la pagina delle Nazioni Unite.
La Computer Science gioca un ruolo fondamentale nell’essere d’ausilio a sfide sociali ed ambientali con riguardo ad un futuro sostenibile.
Similarmente a quanto sviluppato dalla Commissione Europea, con la sua piattaforma KnowSDGs , che fa attualmente riferimento a normative Europee, scritte in lingua inglese, Puglia Sostenibile è un software in grado di verificare quanto un documento sia coerente lessicalmente con quanto enunciato nell'Agenda 2030. Il software è stato "addestrato", in particolare, attraverso l'analisi delle oltre 2000 leggi regionali, emanate in Puglia negli ultimi 50 anni.
L'attività si inquadra nella collaborazione istituzionale tra Consiglio Regionale della Puglia, rappresentato dalla Presidente Loredana Capone, e dalla Sezione Studio e Supporto alla Legislazione e alle Politiche di Garanzia, all’UNIBA (Università degli Studi di Bari, Aldo Moro) e, in particolare, è stata svolta nell'ambito di un tirocinio interno approntato presso la sede del Laboratorio di Sistemi Intelligenti della locale Facoltà di Informatica (DIB), presieduto dal Prof. Giuseppe Pirlo il tutto sotto la supervisione del Dr. Michele Chieco e della D.ssa Gabriella Calvano.
L'uso del software, per quanto testato sulle leggi regionali della Puglia, è estendibile ad altri documenti analoghi di diverso livello territoriale o ad altri testi in generale: caricando il documento, il software restituirà gli SDGs sulla base dell'analisi del testo.
Come nel caso della piattaforma europea KnowSDGs, l'analisi effettuata dal software è basata sulla ricorrenza di parole e loro associazioni e non su una valutazione contenutistica che può, invece, essere oggetto di studi specifici di comparazione tra il testo in esame e l'Agenda 2030.
Nel logo, in primo piano si nota la figura di un albero che richiama alla mente l’idea della Natura e della complessità di meccanismi ed interrelazioni che collegano i viventi tra loro e con l'ambiente.
Infatti, la sostenibilità non va intesa solo in riferimento all’agire positivamente solo per il bene dell’ambiente ma anche nelle relazioni, nell'equità, nella cura reciproca.
Dal tronco dell’albero fuoriescono rami le cui estremità si plasmano in frecce; ogni freccia punta verso direzioni differenti che rappresentano varie declinazioni della sostenibilità e che, seppur divergenti, nascono tutte quante da uno stesso principio: il bene comune è raggiungibile solo tramite un’azione comune.
La Terra, alle spalle dell'albero, è la presenza che deve ricordarci sempre la nostra condizione di essere tutti abitanti di uno stesso luogo con risorse limitate che spronano ad un'azione comune per la loro salvaguardia, se vogliamo il suo bene, ed allo stesso tempo stimola per l’ottenimento di quel tanto agognato cambiamento.
Il logo è stato realizzato dall’esperto di grafica Nicola Surgo.
Puglia Sostenibile è molto semplice da usare!
Per garantire all'utente una migliore esperienza, l'applicazione dispone di una interfaccia grafica piacevole ed intelligibile.
Puoi decidere se effettuare il download del file eseguibile PugliaSostenibile.exe o se avviarlo via linea di comando.
Se scegli di scaricare il file .exe., il software è direttamente pronto all'uso mentre se scegli l'opzione della linea di comando puoi leggere la sezione successiva che ti guiderà per una corretta esecuzione.
Per prima cosa, poiché il programma è basato su Python 3, è necessario scaricare quest'ultimo sulla tua macchina.
Attenzione: le versioni delle attuali librerie non sono compatibili con Python 3.10. Sarà, quindi, necessario installare Python 3.9 o versioni precedenti.
Apri il prompt dei comandi e vai nella cartella in cui hai scaricato Puglia Sostenibile.
Supponendo che la cartella si trovi in "C:\PugliaSostenibileGUI" devi soltanto riportare le seguenti istruzioni nel prompt:
cd "C:\\PugliaSostenibileGUI"
py PugliaSostenibile_GUI.py
Se è la prima volta che avvii il programma oppure è stata rilevata la mancanza di alcune librerie propedeutiche all'avviamento del software, apparirà una finestra in cui ti vengono chieste le autorizzazioni per scaricare ed installare queste ultime.
Per favore, assicurati di essere connesso ad internet.
Spunta la relativa casella e clicca sul pulsante "Avanti": al termine del caricamento si aprirà, finalmente, Puglia Sostenibile.
Puglia Sostenibile è diviso in sei sezioni principali:
- Home Page: è la pagina principale. Ti basta caricare il documento (formati: '.pdf', '.docx', 'txt') cliccando semplicemente sul pulsante "Seleziona Documento". In seguito, clicca su "Start" ed il software computerà i primi tre SDGs più rilevanti.
Puoi anche cercare le occorrenze di una parola chiave: devi soltanto digitarla nell'apposita box, cliccare sul pulsante "Cerca" ed il software ti mostrerà quante volte appare nel testo;
- Informazioni: In questa sezione puoi scoprire informazioni sull'Agenda 2030 e su Puglia Sostenibile;
- Avanzate: In questa pagina puoi cambiare alcune proprietà avanzate:
- Grammatura (utente esperto): Per capire questa proprietà, devi sapere che Puglia Sostenibile calcola gli SDGs più rilevanti facendo uso della Similarità del Coseno. Quest'ultima si basa su di una matrice TFIDF tra tutti gli SDGs e la legge stessa. Per eseguire la computazione, ogni contenuto testuale necessita di essere diviso in parole chiave. È data all'utente l'opportunità di scegliere la grammatura di queste ultime ossia il numero massimo di parole da cui è composta ogni parola chiave. Di default la grammatura è impostata su unigram (ogni parola chiave è composta da una singola parola) ma è, comunque, possibile scegliere l'opzione bigram, nel cui caso ogni parola chiave sarà composta da una o, al massimo, due parole.
- SGDs vs Targets: di default il software rileva i tre SDGs più rilevanti ma, se l'utente vuole scoprire nello specifico i Target più affini alla legge caricata, lo può fare semplicemente cliccando sull'apposito pulsante.
- Agenda 2030: in questa pagina è possibile consultare l'Agenda 2030;
- Contatti: se riscontri difficoltà o errori nell'utilizzo del software o vuoi semplicemente inviare un feedback, in questa sezione trovi tutti i contatti necessari ogni suggerimento per il miglioramento è benvenuto!
- Sfoglia gli SDGs: in qualsiasi momento, se hai bisogno di consultare gli SDGs puoi farlo semplicemente cliccando sul pulsante "Sfoglia gli SDGs" ed una finestra comparirà all'istante permettendoti di scoprire l'obiettivo ed i vari traguardi ad esso correlati.
Puglia Sostenibile è una UWP (Piattaforma Windows Universale) il che significa che è compatibile con diverse versioni di windows, in accordo ai requisiti di windows SDK.
Le librerie utilizzate per la creazione di Puglia Sostenibile sono le seguenti:
- il modulo it-core-news-sm
- nltk
- numpy
- pandas
- PyMuPDF (per la GUI)
- PyPDF2
- python-docx
- scikit-learn
- scipy
- spacy
- tkinter (per la GUI)
- tkPDFViewer (per la GUI)