ArcGIS Notebooks sunt construite pe baza Jupyter Notebook, o aplicație web open-source care permite utilizatorilor să creeze și să partajeze documente ce conțin cod Python executabil, vizualizări și text explicativ. ArcGIS Notebooks sunt integrate în ArcGIS Pro, oferind posibilitatea de a efectua analize geospațiale și de a vizualiza imediat rezultatele într-un context geografic.

Toată funcționalitatea Python din ArcGIS Pro este accesibilă prin intermediul ArcGIS Notebooks, inclusiv:

• Funcționalitatea de bază Python
• Biblioteca standard Python
• ArcPy
• ArcGIS API for Python
• Numeroase biblioteci terțe incluse în ArcGIS Pro

Crearea unui Notebook nou

• În panglică, accesați fila Analysis.
• În grupul Geoprocessing, faceți clic pe săgeata derulantă de la butonul Python.
• Selectați Python Notebook.

Alternativ

• Navigați la fila Insert din panglică.
• Faceți clic pe New Notebook.

Notebook-ul se va deschide într-o filă nouă în ArcGIS Pro și va fi salvat cu extensia .ipynb în directorul proiectului.

Rularea codului Python în Notebook

• Faceți clic în interiorul celulei goale din notebook pentru a începe să scrieți cod Python.
• În bara de instrumente de deasupra celulei, apăsați butonul Run pentru a executa codul.
• Un număr (de exemplu, [1]) va apărea între parantezele pătrate din stânga celulei, indicând ordinea de execuție.
• O nouă celulă goală este adăugată sub celula executată.

Exemplu: Listarea tuturor straturilor din harta activă

ArcPy permite interacțiunea cu straturile adăugate în harta activă din ArcGIS Pro. Pentru a vă asigura că straturile cu care lucrați sunt prezente în harta curentă, se poate utiliza următorul cod Python.

Explicație:

• arcpy.mp.ArcGISProject("CURRENT") se conectează la proiectul ArcGIS Pro deschis în prezent.
• listMaps()[0] preia prima hartă din proiect.
• listLayers() extrage toate straturile din harta selectată. După rularea codului, notebook-ul va afișa straturile disponibile în harta activă.

Notă: Atunci când scrieți import arcpy în ArcGIS Notebook, în directorul proiectului este creat automat un folder numit ipynb_checkpoints. Acest folder este utilizat pentru a stoca versiunile de verificare (checkpoints) ale notebook-urilor pe care le-ați creat.

Sfaturi de bază pentru utilizarea Python Notebooks

• Mai multe linii de cod pot fi adăugate într-o singură celulă apăsând Enter după fiecare linie.
• Spre deosebire de fereastra interactivă Python, apăsarea tastei Enter nu execută linia imediat.
• Dacă o celulă este executată folosind Ctrl+Enter, o nouă celulă este inserată automat.
• Dacă este executată utilizând butonul Run, o nouă celulă este creată dedesubt.
• Variabilele trebuie atribuite înainte de a putea fi utilizate.

1. Datorită integrării Python direct în ArcGIS Pro, utilizatorii pot beneficia de funcționalități open-source, inclusiv:

• Crearea DataFrame-urilor Pandas pentru manipularea datelor.
• Vizualizarea datelor utilizând Matplotlib.
• Gestionarea seturilor mari de date cu ajutorul Dask.

Exemplu: Crearea unui histogramă a înălțimilor barajelor

Acest exemplu demonstrează cum se poate extrage informația privind înălțimea dintr-un strat din ArcGIS Pro, cum se poate converti într-un Pandas DataFrame și cum se poate afișa o histogramă folosind Matplotlib.

Rezultatul va afișa o histogramă ce ilustrează distribuția înălțimilor barajelor. Axa X reprezintă înălțimea barajului (în metri), iar axa Y indică numărul de baraje din fiecare interval de înălțime.

 2. În loc să ruleze analize separate în ArcGIS Pro și Jupyter, ArcGIS Notebooks le permit utilizatorilor să stocheze și să gestioneze notebook-uri direct în cadrul proiectelor ArcGIS Pro, asigurând accesul facil la toate notebook-urile relevante.

3. Codul scris într-un ArcGIS Notebook poate fi exportat într-un script Python (fișiere .ipynb), care poate fi deschis, modificat și executat în afara ArcGIS Pro.

4. Rularea notebook-urilor în diverse medii, precum ArcGIS Enterprise și ArcGIS Online (în prezent în versiune beta), este posibilă atâta timp cât bibliotecile necesare sunt disponibile.

Versiunea software 
Această documentație se bazează pe ArcGIS Pro, versiunea 3.4.2.

Credite 
Creditele pentru stratul Example layer revin GlobalDamWatch.org. 
Vezi: https://www.globaldamwatch.org/database