{"id":9225,"date":"2022-02-16T08:45:44","date_gmt":"2022-02-16T07:45:44","guid":{"rendered":"https:\/\/gis.oneteam.it\/?p=9225"},"modified":"2022-02-15T16:02:12","modified_gmt":"2022-02-15T15:02:12","slug":"arcgis-notebook-codice-in-documenti-interattivi-su-web","status":"publish","type":"post","link":"https:\/\/gis.oneteam.it\/index.php\/2022\/02\/16\/arcgis-notebook-codice-in-documenti-interattivi-su-web\/","title":{"rendered":"ArcGIS Notebook: Codice in Documenti Interattivi su Web"},"content":{"rendered":"

Partiamo dalle basi: Che cos’\u00e8 un Notebook?<\/strong><\/p>\n

Jupyter Notebook \u00e8 un progetto open-source nato per fornire un ambiente di sviluppo facile, interattivo e orientato al web. Pi\u00f9 semplicemente, il Notebook ci permette di creare un documento in cui scrivere testo, aggiungere immagini ma soprattutto eseguire codice e vedere i risultati attraverso tabelle, widget e mappe dinamiche.<\/p>\n

La domanda seguente \u00e8: A cosa mi serve un Notebook?<\/strong><\/p>\n

Nasce in ambiente accademico perch\u00e9 fornisce in un unico documento sia la descrizione teorica del proprio lavoro, sia il workflow operativo. Oltretutto i comandi sono replicabili: all’apertura del Notebook viene creata un’istanza che ci permetter\u00e0 di modificare ed eseguire le linee di codice inserite nel documento, vedendo i risultati nella riga seguente.\u00a0Si pu\u00f2 comprendere che i vantaggi di presentare il proprio lavoro in un foglio interattivo e replicabile sono imparagonabili.<\/p>\n

Ora vedremo come tutto questo si sposa alla perfezione nel mondo ESRI<\/strong>, in particolar modo su ambiente web come ArcGIS Online<\/strong> o ArcGIS Enterprise<\/strong> (Portal),\u00a0utilizzando il Notebook\u00a0con Python<\/em> come linguaggio di programmazione.<\/p>\n

Abbiamo gi\u00e0 affrontato l’argomento “Jupyter Notebook in ArcGIS Pro<\/em>” in un articolo precedente. Nel caso che ve lo siate persi, potete recuperarlo da qui<\/a>.<\/strong><\/span><\/span><\/p>\n

Accesso e Struttura<\/h1>\n

Jupyter Notebook<\/em> pu\u00f2 essere installato sul vostro computer e utilizzarlo tramite una pagina del browser oppure lo troverete gi\u00e0 integrato in ArcGIS Pro<\/em>.<\/p>\n

Per sfruttare a pieno le sue funzionalit\u00e0 web potete accedere anche da ArcGIS Online:\u00a0<\/em>lo trovate gi\u00e0 presente nella toolbar sotto la voce “Appunti”<\/em>. Se invece siete orientati alle soluzioni On-Premises potete\u00a0installarlo sui vostri server <\/span>e federarlo con il vostro Portal. Ritroverete la stessa icona “Appunti” nella toolbar.<\/p>\n

 <\/p>\n

\"\"<\/p>\n

Entrati in questa sezione troverete una nuova pagina dove saranno listati tutti i Notebook creati in precedenza oppure potrete accedere agli esempi messi a disposizione da ESRI.<\/p>\n

\"\"<\/p>\n

 <\/p>\n

Per creare un nuovo elemento sar\u00e0 sufficiente selezionare il bottone in alto a destra “Nuovi appunti”<\/em> e decidere tra 3 opzioni a seconda delle risorse richieste. Le impostazioni Standard<\/strong> sono sufficienti per la maggior parte dei processi, se invece necessitiamo di maggiore potenza computazionale possiamo scegliere Avanzato<\/strong> consumando 3 crediti per ogni ora di utilizzo.<\/p>\n

Ovviamente la creazione di un nuovo oggetto finir\u00e0 nella nostra repository visualizzabile tramite il tasto “Contenuto”<\/em> presente nella toolbar. L’elemento sar\u00e0 listato come ogni servizio o web-app che creiamo in AGOL (ArcGIS Online).<\/p>\n

\"\"<\/p>\n

 <\/p>\n

Creato il documento verremo reindirizzati all’interfaccia del Notebook che risulta molto semplice ed intuitiva. Possiamo aggiungere celle testuali (markdown<\/em>) oppure celle di codice (code<\/em>) ed eseguirle premendo SHIFT+INVIO<\/strong>. Sotto alla cella comparir\u00e0 il risultato che potremo cliccare e navigare grazie alla sua interattivit\u00e0.<\/p>\n

\"\"<\/p>\n

 <\/p>\n

Se siete sprovvisti di ArcGIS Online<\/em> e volete comunque provare Jupyter Notebook,<\/em> potete accedere qui<\/a> e verr\u00e0 creata un’istanza nel vostro browser.<\/p>\n

Funzionalit\u00e0<\/h1>\n

Il Notebook avviato su AGOL si basa su Python ed essendo modulare possiamo espandere le sue funzioni importando pacchetti. Chiaramente per le componenti cartografiche utilizzeremo i moduli di ArcGIS, in particolare arcpy<\/strong> per le funzioni di analisi e arcgis.gis<\/strong> per le funzioni di gestione, ma nulla vieta di utilizzare le migliaia di altre librerie gi\u00e0 presenti. Per vedere quali librerie sono gi\u00e0 installate rimandiamo a questo link.<\/a><\/p>\n

Il Notebook ci da accesso a qualsiasi comando che ritroviamo in ArcGIS Pro o su ArcGIS Online, compresa la gestione dei contenuti e utenti. Quindi potremmo utilizzarlo per creare dei flussi di lavoro da far revisionare ed eseguire a chiunque tramite una pagina web, senza dover necessariamente possedere il software sul proprio pc <\/span>ed essere formati sul suo utilizzo.<\/p>\n

Tramite il comando:<\/p>\n

\r\n\r\nfrom arcgis.gis import GIS\r\ngis = GIS("home") <\/pre>\n
Ci verranno chieste le credenziali e avremo accesso al nostro portale di ArcGIS Online, nel quale potremo listare tutti i contenuti:<\/p>\n
\r\n\r\nfrom IPython.display import display\r\n\r\nitems = gis.content.search('')\r\nfor item in items:\r\ndisplay(item)<\/pre>\n
Viceversa, se volessimo effettuare il login<\/span> <\/span>al nostro Portal potremo utilizzare il seguente codice:<\/p>\n
 \r\ngis = GIS("URL di Portal","Username","Password")\r\n<\/pre>\n
Per creare una nuova mappa ed avere come risultato un widget dinamico sar\u00e0 sufficiente eseguire:<\/p>\n
\r\nmap = gis.map("Via Giovanni Gioacchino Winckelmann, 2, 20146 Milano MI")\r\n\r\nmap\r\n\r\n<\/pre>\n
Una volta connessi ad un portale sar\u00e0 possibile creare nuovi servizi, aggiungere dati, cancellare vecchi elementi, gestire gli utenti o effettuare qualsiasi operazione che solitamente siamo abituati a fare tramite GUI<\/em>. Per una panoramica di tutte le funzionalit\u00e0 possibili vi rimandiamo alla documentazione ufficiale<\/a>, mentre se volete imparare esercitandovi esistono anche molti esempi di flussi di lavoro da scaricare qui<\/a>.<\/p>\n
Oltre alle funzionalit\u00e0 sopra citate vorremmo evidenziare la possibilit\u00e0 di schedulare<\/strong> l’esecuzione del nostro Notebook. Essendo hostato su cloud non \u00e8 legato all’accensione del nostro computer e possiamo eseguirlo quotidianamente notificandoci per mail (o addirittura per SMS) i risultati. In questo caso dovremo utilizzare i WebHook<\/a>\u00a0che saranno argomento di futuri post. Per schedulare l’esecuzione vi consiglio di seguire questa guida<\/a>.<\/p>\n
Sample<\/h1>\n
Ora che abbiamo preso dimestichezza con lo strumento vediamo i Notebook messi a disposizione da ESRI come esempio. Entrando in Arcgis Online ed selezionando “Appunti”\u00a0<\/em>potremo spostarci su “Appunti campione ESRI”<\/em>. Chiaramente possiamo utilizzare dati in locale oppure appoggiarci a servizi caricati sul nostro portale. Anche i dati provenienti da Living Atlas sono supportati.<\/p>\n
Carichiamo “Construction Permit” e commentiamo i diversi passaggi:<\/p>\n
\"\"<\/p>\n
La prima operazione \u00e8 sempre l’importazione dei moduli che ci serviranno per eseguire le nostre funzioni. In particolare il modulo arcgis.gis<\/strong> \u00e8 necessario per fare il login in Arcgis Online.<\/p>\n
\"\"<\/p>\n
Ora potremo ricercare contenuti nel portale inserendo delle chiavi di ricerca nel titolo e nella tipologia di oggetto, in questo caso Feature Layer<\/em>. Assegniamo il risultato ad una variabile per poterlo riutilizzare in seguito.<\/p>\n
\"\"<\/p>\n
Creiamo una nuova mappa ed andiamo ad inserire il layer cercato in precedenza. L’oggetto generato sar\u00e0 dinamico e ci permette di spostarci nella mappa, interrogare i dati, aggiungere widget proprio come in una mappa di Arcgis Online.<\/p>\n
\"\"<\/p>\n
Il grande vantaggio \u00e8 poter raccontare i nostri dati seguendo un ragionamento e consentendo all’utente di interagire con essi. Apriamo la tabella degli attributi utilizzando il modulo pandas<\/strong> che ha moltissime funzioni per i dati tabellari.<\/p>\n
\"\"<\/p>\n
In questo modo potremo aggiungere grafici che sintetizzano i dati ed avere un riscontro in mappa filtrando tra gli elementi interessati.<\/p>\n
\"\"<\/p>\n
Per finire generiamo un’altra mappa con i dati risultanti dalla nostra analisi e tematizziamo per classi. Questo oggetto potr\u00e0 essere salvato nella nostra repository e generare un link che punta direttamente alla mappa.<\/p>\n
Conclusioni<\/h1>\n
Il Notebook \u00e8 uno strumento molto<\/span><\/span> versatile. Pu\u00f2 essere utilizzato in modalit\u00e0 debug, scrivendo comandi ed analizzando i risultati passo per passo. Lo consigliamo vivamente per chi muove i primi passi verso la programmazione.<\/p>\n
Inoltre \u00e8 possibile aggiungere estensioni al vostro ambiente del Notebook per inserire componenti utili come ad esempio<\/span>\u00a0il variable inspector\u00a0<\/em><\/p>\n
In ambiente GIS lo consigliamo a chi deve eseguire script lato server ed ottenere diversi output intermedi. Soprattutto per chi lavora in team multidisciplinari risulta comodo poter documentare le righe di codice che vengono eseguite e generare un report finale.<\/p>\n
Per maggiori informazioni sul mondo Esri contatta lo staff GIS di One Team via mail scrivendo a\u00a0gis@oneteam.it<\/a>\u00a0o chiamaci allo 0247719331.<\/p>\n
Iscriviti<\/a>\u00a0al blog per non perderti i prossimi appuntamenti!<\/p>\n
\"\"<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Partiamo dalle basi: Che cos’\u00e8 un Notebook? Jupyter Notebook \u00e8 un progetto open-source nato per fornire un ambiente di sviluppo facile, interattivo e orientato al web. Pi\u00f9 semplicemente, il Notebook ci permette di creare un documento in cui scrivere testo, aggiungere immagini ma soprattutto eseguire codice e vedere i risultati attraverso tabelle, widget e mappe…<\/p>\n","protected":false},"author":1,"featured_media":8884,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[4,8,738,29],"tags":[688,80,787,447,470],"class_list":["post-9225","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-arcgis-enterprise","category-arcgis-online","category-esri-app","category-python","tag-arcgis-notebooks","tag-arcgis-online","tag-jupyter","tag-portal","tag-python"],"post_mailing_queue_ids":[],"_links":{"self":[{"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/posts\/9225","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/comments?post=9225"}],"version-history":[{"count":24,"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/posts\/9225\/revisions"}],"predecessor-version":[{"id":9296,"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/posts\/9225\/revisions\/9296"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/media\/8884"}],"wp:attachment":[{"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/media?parent=9225"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/categories?post=9225"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gis.oneteam.it\/index.php\/wp-json\/wp\/v2\/tags?post=9225"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}