Često postavljana pitanja
Pitanja i odgovori
Za osobu koja preuzima projekt. Klikni na pitanje da se otvori odgovor.
Strah i sigurnost
Mogu li nešto slučajno pokvariti?
Praktički ne. Svi podaci su na disku, a povijest izmjena čuva git — uvijek se može vratiti na prije. Pokretanje koda čita podatke; nove datoteke sprema u zasebne mape (npr. rezultati/). Ako te nešto plaši, samo pitaj prije nego napraviš.
Trebam li znati programirati da bih ovo koristila?
Ne za osnovno korištenje. Za pokretanje je dovoljno slijediti Kako pokrenuti (ili dvoklik na pokreni_jupyter.bat). Kod je tu ako te zanima Obilazak koda objašnjava ga običnim jezikom.
Trebam li internet?
Za čitanje ove dokumentacije — ne, radi offline. Za prvo postavljanje (instalacija Pythona i paketa) — da. Za LLM dio (Doprinos 1, korak 3) — da, jer se šalje upit Claude modelu.
Pojmovi
Što je Python i zašto ga trebamo?
Python je programski jezik u kojem je pisan sav kod projekta (obrada podataka, karte, statistika). Mora biti instaliran da bi se kod pokrenuo. Instalira se jednom (vidi Kako pokrenuti).
Što je .venv (virtualno okruženje)?
To je „zasebna kutija" u koju se instaliraju paketi samo za ovaj projekt, da ne smetaju ostatku računala. Ne dira se ručno. Ako se obriše, ponovno se napravi po uputama.
Što je shapefile / karta naselja?
To je datoteka s geografskim oblicima — u našem slučaju granice svih 6758 naselja Hrvatske (CROATIA_HR_Naselja_ADMIN3.shp). Koristimo je da naziv mjesta iz teksta pretvorimo u koordinate na karti.
Što je Jupyter notebook (.ipynb)?
Dokument u kojem se kod piše i pokreće po dijelovima (ćelijama), a otvara se u web pregledniku. Zgodan za analizu jer odmah vidiš rezultat svakog koraka. Pokreće se naredbom jupyter notebook.
Što je API ključ i je li siguran?
API ključ je poput lozinke koja dopušta korištenje Claude modela (za LLM dio). Spremi se u datoteku .env, koja je namjerno isključena iz gita — nikad se ne dijeli i ne završava u povijesti. Nikome ga ne šalji.
Kad nešto ne radi
Dobijem grešku pri pokretanju — što sad?
Prvo provjeri je li na početku retka (.venv) (znak da je okruženje uključeno). Zatim pogledaj tablicu grešaka na dnu stranice Kako pokrenuti. Ako i dalje puca, prepiši točan tekst greške i pošalji ga — s točnim tekstom lako je pomoći.
Notebook javlja „No such file" s putanjom /content/drive/...
To je stara Google Colab putanja iz naslijeđenih notebookova. Ne radi lokalno dok se ne zamijeni. Novi kod (u doprinos1_geolokacija/) već koristi lokalne putanje pa nema taj problem.
Kako znam da je okruženje ispravno?
Pokreni python provjera_okruzenja.py. Ako na kraju piše „SVE RADI", sve je u redu (učitani su svi paketi, tablica i karta).
Što ako preselim projekt na drugo računalo?
Prekopiraj cijelu mapu (bez .venv). Na novom računalu instaliraj Python, pa napravi okruženje po uputama (Kako pokrenuti, poglavlje „Prvo postavljanje"). Putanje u kodu se računaju automatski pa rade i na novom mjestu.
Podaci i rad
Gdje su podaci?
U folderima splitech\ (vatrogasne intervencije, HVZ izvješća, Facebook) i vatrogasci\ (objave grupe + karta naselja). Popis i objašnjenje svake datoteke: Mapa projekta.
Što je „gold set" i moram li ga ja popuniti?
To je tablica s točnim odgovorima (mjesto + vrijeme) prema kojoj mjerimo koliko dobro rade regex i LLM. Računalo je već upisalo prijedloge; osoba samo potvrdi ili ispravi zelena polja u datoteci doprinos1_geolokacija/rezultati/gold_set_za_oznacavanje.xlsx. Upute su i u samom Excelu.
Koga da pitam ako zapnem?
Petra (ili Claudea). Najbrže je poslati: što si radila, što se dogodilo i točan tekst greške (može i screenshot).
Nema tvog pitanja ovdje? Javi ga — dodat ćemo ga na ovu stranicu.