Resurse¶
Pregătire înainte de workshop
Folosim Google Colab pentru ușurință — nimic de instalat, totul rulează în browser pe infrastructura Google, cu un cont Google obișnuit.
Pentru cine vrea un mod avansat de coding (offline, IDE complet, integrare AI și versionare), recomandăm VS Code + AI assistants + GitHub — detaliate mai jos în secțiunile Tutorial avansat: Conda + VS Code, Git & GitHub și Unelte AI gratuite pentru cod.
Ce-ți trebuie¶
- Un cont Google (Gmail-ul tău e suficient).
- Un browser modern — Chrome, Firefox, Edge.
- Conexiune internet — Colab rulează în cloud.
Atât. Restul îl rezolvăm vineri dimineața.
Conturi gratuite recomandate¶
Pentru lucrul cu date reale dincolo de exemplele din workshop, înregistrează-te înainte la:
| Serviciu | De ce e util | Link |
|---|---|---|
| Google Earth Engine | Petabyte-scale satellite data, integrare directă cu Colab | signup.earthengine.google.com |
| Copernicus Climate Data Store | API key pentru ERA5 și alte reanalize | cds.climate.copernicus.eu |
| Copernicus Marine | Date Marea Neagră (SST, valuri, curenți) | marine.copernicus.eu |
| Microsoft Planetary Computer | Catalog STAC + Sentinel/Landsat fără descărcare | planetarycomputer.microsoft.com |
Pro tip: înregistrează-te cu 1-2 zile înainte
Înregistrarea pe Copernicus durează ~5 min, dar API key-urile pot ajunge cu întârziere de câteva ore. Fă-ți contul în avans ca să nu pierzi timp vineri dimineața.
Cum funcționează un notebook Colab¶
Pe fiecare pagină de modul, vei vedea un buton galben Open in Colab. Click → notebook-ul se deschide într-un tab nou, conectat la contul tău Google.
Comenzi utile:
- Shift+Enter rulează celula curentă
- Ctrl+M+B adaugă o celulă nouă sub
- File → Save a copy in Drive păstrează modificările tale (default-ul nu salvează în repo!)
Salvează prima copie imediat
Prima dată când deschizi un notebook, salvează imediat o copie în Drive. Altfel, orice ai schimbat se pierde când închizi tab-ul.
Tutorial: Colab pas cu pas¶
Ghid rapid pentru prima ta sesiune — de la zero la notebook rulat în 5 minute.
-
Deschide notebook-ul — click pe butonul Open in Colab de pe pagina modulului, sau mergi direct la colab.research.google.com și deschide un fișier (File → Open notebook).
-
Conectează runtime-ul — click pe butonul Connect din dreapta sus (sau Runtime → Connect to hosted runtime). Vei vedea indicatorii RAM/Disk când e gata.
-
Rulează celulele în ordine — Shift+Enter pe fiecare celulă, de sus în jos. Nu sări peste celula de instalare pachete (
!pip install ...). -
Instalează pachete lipsă — dacă apare
ModuleNotFoundError, adaugă o celulă la început cu: -
Salvează copia ta — File → Save a copy in Drive. Fă asta imediat după ce deschizi notebook-ul.
-
Descarcă fișiere generate — panoul Files (iconița dosar din stânga) → click dreapta pe fișier → Download.
-
Partajează rezultatele — butonul Share din dreapta sus, exact ca un Google Doc.
Runtime se resetează după inactivitate
Dacă lași Colab-ul nefolosit ~90 de minute, runtime-ul se oprește și toate variabilele și fișierele din /content se pierd. Va trebui să reinstalezi pachetele și să rerulezi celulele. Datele salvate în Drive rămân.
GPU gratuit
Pentru calcule mai grele: Runtime → Change runtime type → T4 GPU. Disponibil gratuit, cu limite de utilizare zilnică.
Linkuri utile
- colab.research.google.com — interfața principală
- Colab FAQ — întrebări frecvente
- Colab keyboard shortcuts — Ctrl+M+H în Colab afișează lista completă
Tutorial avansat: Conda + VS Code (local)¶
Pentru cei care vor să lucreze offline, cu seturi mari de date sau preferă un IDE complet. Același cod ca în Colab, rulat pe mașina ta.
Pas 1 — Instalează Miniconda
Descarcă și instalează Miniconda (versiunea Python 3.11+). Miniconda e mai ușoară decât Anaconda — include doar conda și Python.
Pas 2 — Creează environmentul
Pas 3 — Instalează pachetele workshop-ului
pip install earthengine-api geemap pystac-client planetary-computer \
xarray rioxarray netCDF4 cartopy cdsapi \
numpy pandas matplotlib scipy statsmodels pymannkendall \
jupyterlab ipykernel
Pas 4 — Înregistrează kernel-ul în Jupyter
Pas 5 — Instalează VS Code
Descarcă VS Code. După instalare, deschide panoul Extensions (Ctrl+Shift+X) și instalează:
- Python — Microsoft
- Jupyter — Microsoft
Pas 6 — Deschide repo-ul
Clonează repo-ul sau descarcă ZIP de pe GitHub, apoi în VS Code: File → Open Folder → selectează folderul delta-hub-workshop-2026.
Pas 7 — Selectează kernel-ul conda
Deschide un fișier .ipynb. Click pe selectorul de kernel (dreapta sus) → Select Another Kernel → Python Environments → Python (delta-hub).
Pas 8 — Rulează notebook-ul
Shift+Enter celulă cu celulă, sau Run All din bara de sus.
Autentificare GEE local
Prima dată, rulează în terminal (cu environmentul activat):
Se deschide un browser pentru aprobare — după asta, autentificarea e salvată local.CDS API key local
Creează fișierul ~/.cdsapirc (acasă, nu în repo) cu:
AI-assisted coding în Colab¶
Colab are integrare nativă cu Gemini (gratuit cu cont Google). Pentru ce vom discuta în Modul 4, concluziile sunt valabile pentru orice asistent (Gemini, Claude, GitHub Copilot, ChatGPT).
Dacă vrei să folosești Claude în paralel: claude.ai (gratuit pentru uz limitat).
Git & GitHub — versionare și colaborare¶
Git este instrumentul standard pentru a urmări modificările codului. GitHub este platforma unde stocăm și partajăm repo-urile.
Instalare¶
-
Git (CLI)
Instrumentul de bază, rulează în terminal.
-
GitHub Desktop
Interfață vizuală — recomandat dacă nu ești familiar cu terminalul.
-
Cont GitHub
Gratuit. Necesar pentru a accesa și salva repo-ul workshop-ului.
GitHub Education — gratuit pentru studenți și profesori
Cu o adresă de email instituțională (@s.unibuc.ro, @unibuc.ro etc.) și legitimație de student / adeverință încărcată la verificare, primești gratuit pachetul GitHub Student Developer Pack sau GitHub Teacher Toolbox:
- GitHub Copilot Pro gratuit (în loc de tier-ul limitat) — completare cod nelimitată și chat nelimitat în VS Code.
- Repo-uri private nelimitate, GitHub Pro, GitHub Codespaces ore extinse.
- Credite și licențe la zeci de servicii (JetBrains, Namecheap, DigitalOcean, MongoDB ș.a.).
Cum aplici: intră pe github.com/settings/education/benefits, încarci legitimația de student sau dovada de afiliere academică și aștepți verificarea (de obicei câteva zile).
Comenzi esențiale (5 suficiente pentru workshop)¶
# Clonează repo-ul workshop pe calculatorul tău
git clone https://github.com/DeltaHUB-UB/delta-hub-workshop-2026
# Vezi ce fișiere s-au schimbat
git status
# Marchează fișierele pentru commit
git add fisier.py # un singur fișier
git add . # tot ce s-a schimbat
# Salvează modificările cu un mesaj
git commit -m "Adaug analiza temperaturii la Sulina"
# Trimite modificările pe GitHub
git push
Clonează repo-ul înainte de workshop
Vei avea toate notebook-urile și materialele offline.GitHub vs Google Drive
Git urmărește modificările în timp (cine, ce, când). Nu e un simplu loc de stocare — e un jurnal complet al proiectului. Ideal pentru cod; mai puțin util pentru fișiere binare mari (.nc, .tif > 100 MB).
Unelte AI gratuite pentru cod¶
Toate instrumentele de mai jos au tier gratuit și pot fi folosite fără card bancar.
În VS Code¶
| Unealtă | Ce face | Tier gratuit | Link |
|---|---|---|---|
| GitHub Copilot | Completare cod + chat în editor | 2 000 completări/lună, 50 mesaje chat/lună | marketplace: GitHub Copilot |
| Codeium | Completare cod nelimitată | Complet gratuit, fără limite | marketplace: Codeium |
| Continue | Chat cu orice model (Claude, GPT, Ollama local) | Open-source, gratuit | marketplace: Continue |
Instalare rapidă (GitHub Copilot):
- Deschide VS Code → Ctrl+Shift+X → caută
GitHub Copilot→ Install - Sign in cu contul GitHub
- Merge automat: sugestii inline în timp ce scrii, Tab pentru a accepta
Activare GitHub Copilot gratuit: → github.com/features/copilot → Start for free
În browser¶
-
Claude (Anthropic)
Excelent la cod Python și explicații. Tier gratuit disponibil.
-
ChatGPT
GPT-4o mini gratuit. Bun pentru debugging rapid.
-
Google Gemini
Integrat nativ în Colab. Disponibil din butonul ✦ din orice notebook.
-
GitHub Copilot Chat
Accesibil direct pe github.com la orice fișier de cod sau PR.
Cum să folosești AI eficient pentru cod de mediu
Specifică întotdeauna contextul: biblioteca (xarray, geopandas), formatul datelor (NetCDF, GeoTIFF) și zona geografică. Un prompt bun:
Folosind xarray, calculează media lunară a temperaturii dintr-un Dataset
cu dimensiunile (time, lat, lon) și salvează rezultatul ca NetCDF.