Upload 71 files

ISTRUZIONI_CARICAMENTO_REV5.md

@@ -0,0 +1,12 @@
+# Istruzioni di caricamento REV5
+
+1. Aprire il repository dello Space che mantiene lo slug gia utilizzato nelle schede.
+2. Verificare che l'hardware selezionato sia ZeroGPU.
+3. Eliminare o sovrascrivere i file della revisione precedente.
+4. Caricare tutto il contenuto di questa cartella, conservando la struttura `assets/` e `dataset/`.
+5. Eseguire **Factory reboot**.
+6. Nei build log verificare il precaricamento di `Uminosachi/FastSAM/FastSAM-s.pt`.
+7. Nei container log verificare che l'applicazione resti attiva e che non compaia l'errore `No @spaces.GPU function detected during startup`.
+8. Provare in ordine: PDF 6-9, matrice pixel 9-11, HSV 11-14, FastSAM 11-14.
+
+Nel modulo FastSAM la fotografia deve comparire automaticamente dentro il pannello. Fare click sulla pianta, controllare il punto rosso e premere il pulsante verde.

MANIFEST_SHA256.txt

@@ -0,0 +1,70 @@
+e0c1edaa83a3c419eb884b51c4b3e2de519de48b46420caa7c694ed802add437  ./.gitattributes
+1f7f03347a308182ed09b0259c5ebb0ffd934fdf4e513b0c7ac73a084b695237  ./CHANGELOG_REV5_ZEROGPU_CPU.md
+2cf251e4db544ae2b6a5ca1e0a91dd1e4975e72cfa6119b5ffd366bb1f869c27  ./ISTRUZIONI_CARICAMENTO_REV5.md
+cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30  ./LICENSE
+f248798ad0c9a4bfd5e55f0b9fe41208f69791241ac1e506f2ce8b3e8ffc934a  ./NOTE_RUNTIME_ZEROGPU_CPU.md
+24e9d2b153b1ca34540111d83dc01f30700348a7706404d0f6546b2e4f1343cc  ./README.md
+51fbe08f35cbc5bbf8a3ef94319d1eaf48b3d009db2e02d2c6d6c92318aaf9a2  ./TEST_REPORT_REV5_ZEROGPU_CPU.md
+4180f6cce89dafd0665dcfd5b3f0c7be639773dba333c6afcb81324413bbe485  ./THIRD_PARTY_NOTICES.md
+86b4307fc7072dcd17c5ba8ba091b80dc5395dc09ece98f139f9b99318e26924  ./app.py
+2728fc9fcc6e2eec751fdd07979a85b78cd2143399216a6ee25f659d697ebdda  ./assets/11-14/Approfondimenti_tecnici_docenti.pdf
+1219c20c7528e57b3268d44ba4b58be8fbcfcaf886a0e8b6063eeb36224c54cc  ./assets/11-14/Guida_confronto_segmentazioni.pdf
+d49cff20b915ce9abbda6f3d965943e5d7132ca17b78f6edf51a8a64d8a94c34  ./assets/6-9/Guida_piante_a_quadretti.pdf
+652a025e925f569ff3b7f43aace7853b5836d81595ede75937866adb9bd0148c  ./assets/9-11/Guida_pixel_e_verde.pdf
+3cbf7a3a59db1ed1178f04158ad60cd823c1313733991cbe2ee632566caf2c19  ./assets/comuni/Scheda_esperimento.pdf
+cf68fe5a8d9832899f1fb5a54ec80a360de516412f3395bb541b95fd2081d549  ./assets/comuni/Tutorial_setup_sperimentale.pdf
+053c47c13a9a5a1078eb8185ed241ec83ec88a0cb07b9d249604b0641390452b  ./assets/screenshots/01_panoramica_annotata.png
+3b7d3488f27001d7e28592b63ec8b7ab282fbeed7c462835e1c66b226ba68038  ./assets/screenshots/02_6-9_annotata.png
+e632679adb93072130bf918c15eda320bf3121d7c2b6e47ed39ba9ba50bcbf6e  ./assets/screenshots/03_9-11_annotata.png
+e87b250aee8461036afc13a05f6eaa10b94addacf6224f25047a7d28231d0203  ./assets/screenshots/04_11-14_annotata.png
+92fbb748fcc4bcfbe1b5c52543178079be009226e1006e57ff389cf3650c5fa3  ./assets/screenshots/06_dataset_annotata.png
+979217f1646608311a4410e8da602d5297797b39c30742bb99f5b61367240f6f  ./dataset/NS_A_06.jpg
+8459b06b0d05facf5b74d7e082f840f4d6bf9d4724f42ff77615b80b352b15ff  ./dataset/NS_A_09.jpg
+0c87b83ec1a38f4d08bf7cbde9482969468c8a71ff94934af8b64df9760005de  ./dataset/NS_A_11.jpg
+271a1f0cdd76b7eb683747a6a87ba8757b457c379f4b5c4de84a0f30e16bf8cd  ./dataset/NS_A_14.jpg
+ef2824d31cc2ecb4d7c64444c25b6cb8daefcf507f5f8a9535281fb6f1a26307  ./dataset/NS_A_16.jpg
+100bde90f86358e654bdc859063538e2d81d1734b9d19a8821515848750dac7d  ./dataset/NS_A_19.jpg
+23dc67f193a118a96bab623e417633ae1855702b5c896bd62f05c1f8d4bfbb96  ./dataset/NS_A_23.jpg
+18a0ccdca3bac951acee48d7fb7dcc3a05bafd07184c3e1fa755ad5e95208f9d  ./dataset/NS_A_26.jpg
+4f10b89b982673f07fb621c83b42cf90968fb2bd38431f2ca164e7e8f6b184a5  ./dataset/NS_B_06.jpg
+91d211349148a734a328e20ee104bdb05df1ec40d1ed0e904976d7ae66aa899c  ./dataset/NS_B_09.jpg
+1e87f675f83ebb5dff71de72dbf21c1f904663670acf538f33589ea3521f4416  ./dataset/NS_B_11.jpg
+5eff5b2cbfffa1ea97fbfd2ea0df35c64ca3ad50a4a00904422e9eb8d41b9ed8  ./dataset/NS_B_14.jpg
+2196d77fdcee556595ba8c0d0d083617b68e6da50a1eaa2a589a39d299ddde38  ./dataset/NS_B_16.jpg
+7dc07f0ddad78013fd84a637f6b5a29e0add642ce7091b9e7a8ddf1162c26ba0  ./dataset/NS_B_19.jpg
+e64856f91b552e748457f5ec96d7601846088aa85a52152f1abe94d8b51730fc  ./dataset/NS_B_23.jpg
+2772ae3eb7087e04223dbffe2107d9903cd8aacdd40bd0b3559cbd3f3f0d80e4  ./dataset/NS_B_26.jpg
+684847990cb8eaf985d2f57bdd81852c67e8d1bd38e122b6cff15933e09f5734  ./dataset/NS_C_06.jpg
+b6c08fbf118c3af18a46ff2922ac7e269de9582dabb2ae3b1c32aefbf47fceab  ./dataset/NS_C_09.jpg
+72a11eda756cd48bfcb71886c4132cdf5751df18ca8d1e8e5930c2877318a83c  ./dataset/NS_C_11.jpg
+ad4db49b400a5f6c1b184d2d12fa9283b8e8f2c389169235de0c5e94262dbf49  ./dataset/NS_C_14.jpg
+58d962bbcfdb8000eba0730c67a195b07e8e1a803fa30dba2a141a00b3d3377a  ./dataset/NS_C_16.jpg
+5aef103edd73e7cd2776b4202e7d20f53568315aff9aa09f08781e2eb0731632  ./dataset/NS_C_19.jpg
+d821a6ecef12f5382e789000681dff2027da76956a7a3e319fa4ad7d285227c3  ./dataset/NS_C_23.jpg
+f49b14148dd19211af4956c8e665232dfd7a5a51033dda5e8519b38f972260f1  ./dataset/NS_C_26.jpg
+0e4efe4ac5109accb5155f92c98cf2a814a91ace7be78f3ec6e51dd0d63a2783  ./dataset/README_dataset.md
+a9906bfe5f45baf6ddbb1916ef1c479e80f8e2e2c645a290b17e437c263a6eb5  ./dataset/S_A_06.jpg
+8124a2a068f0e96a845ea96134638256e0ce6338588d98083377a77e158092f1  ./dataset/S_A_09.jpg
+770d8581a4d389226c4cc0f8d14591e3ec5f9e7eb17c11310ad7e9cd876604b4  ./dataset/S_A_11.jpg
+76e8fd2a2f23462f9927a05155bff659b0a6d44f8d6d951b476c25a9af70b1e9  ./dataset/S_A_14.jpg
+9f3a856fef3e72481c597e43ed7980002d693a640c848580084d690db95ae1a0  ./dataset/S_A_16.jpg
+62fad9758b38746bc4caf69f3082453c66b762cc155da05c158d127bba672410  ./dataset/S_A_19.jpg
+cca0627aca1fcf7ea70ab65f5122cae52b144910298d9f6c590ea157f24b71e5  ./dataset/S_A_23.jpg
+305343c1dec147fd0c22f4b219302d294806c712c657dfc1589758fb44492784  ./dataset/S_A_26.jpg
+a1cf53ceb47fe32156c75bdf5bd05e0730bc79927546ee4ba18d881d39db04d2  ./dataset/S_B_06.jpg
+a558851c38c5b16617b7d6105732aeb1594bfbbc5a91712eaa681d90ea1fc918  ./dataset/S_B_09.jpg
+02c3f1f8d42a0f09c7a647693424197bb7b7d0e4906a6ad381e3ab6a9595d827  ./dataset/S_B_11.jpg
+b5df5263c402a7e50e4952719ae5c3aa1f3aad0d991a491e93fa5dd2a06fdac1  ./dataset/S_B_14.jpg
+37b68fbebda31d9ad3edddcfb65fb73b5eb6bc56dc197cb970f68d43e6cfdec0  ./dataset/S_B_16.jpg
+2175491a0857af05e18c25f4e534358876c5bcbfb1e2fbd3efed699a66bf1d34  ./dataset/S_B_19.jpg
+0a6b032ccf190c9bc54049161ecdcf071713635b4929e1c2fbf973713cf15613  ./dataset/S_B_23.jpg
+ca00c2025e630c8c82235e0a9a01a8568b4e0ddcdb3d4bc6a2cc70b326fb9de0  ./dataset/S_B_26.jpg
+2a7483d8840be3bc22efc13f67fd1734c14338023b8a24a1ec12313437f8d826  ./dataset/S_C_06.jpg
+785b1de8fc80a52751fc7554029014b0cd0bdfb716830c531decabf2284cdc33  ./dataset/S_C_09.jpg
+efc33bfbb229c3e2076ac6433337bca3ccb039c4cf66b51cbc5a3fa94307a8f8  ./dataset/S_C_11.jpg
+e36bdbad098249b8b5b59a9a95c6574eee8d564202b88aa49ccb44c2ebd97bfc  ./dataset/S_C_14.jpg
+ec36860a1cac5eda3c10a745a7d8c8afd78c1caee16e05cd65a8b2b542c59b1f  ./dataset/S_C_16.jpg
+ee9111fe634934cf0f2ee500efc3aea3288b7c6e793fe36e780acf205bccee55  ./dataset/S_C_19.jpg
+4e7045ded7f4aca9fbb69c8bb5513c5ce3887669d32fe3aed28e6369e51360be  ./dataset/S_C_23.jpg
+5218323ac29cbe93e472edc2e45481d7e65983c5d236ad9a889653c5c42d3406  ./dataset/S_C_26.jpg
+24e57909eb3ddc7f1271256abff7065e61807ed9a50669ac13438b540e0d0965  ./requirements.txt

NOTE_RUNTIME_ZEROGPU_CPU.md

@@ -0,0 +1,23 @@
+# Nota runtime: ZeroGPU con elaborazione CPU
+
+Questa versione e pensata per uno Space configurato come **ZeroGPU**, mantenendo tuttavia tutte le funzioni didattiche, compreso FastSAM, sul processo CPU.
+
+## Struttura
+
+- `@spaces.GPU` e presente su una funzione minima non collegata all'interfaccia. Serve a superare il controllo di avvio del runtime ZeroGPU.
+- FastSAM viene chiamato con `device="cpu"`.
+- La funzione decorata non viene richiamata dall'interfaccia; l'uso ordinario non richiede una sessione GPU dinamica.
+- Il peso `FastSAM-s.pt` viene precaricato durante il build tramite `preload_from_hub` e risolto dalla cache con `hf_hub_download`.
+
+## Pubblicazione
+
+1. Lasciare lo Space su hardware ZeroGPU.
+2. Sostituire integralmente i file del repository.
+3. Eseguire un Factory reboot.
+4. Controllare che il container non riporti `No @spaces.GPU function detected during startup`.
+5. Verificare una funzione CPU semplice.
+6. Nel modulo 11-14 aprire FastSAM, selezionare il punto nella copia sincronizzata e premere il pulsante.
+
+## Limite della soluzione
+
+La funzione decorata e un'ancora di compatibilita e non un percorso di inferenza GPU. Se Hugging Face dovesse modificare il controllo del runtime, questa parte potra richiedere un aggiornamento. Il percorso FastSAM CPU rimane indipendente dalla quota ZeroGPU.

TEST_REPORT_REV5_ZEROGPU_CPU.md

@@ -0,0 +1,23 @@
+# Report test REV5 - ZeroGPU con FastSAM CPU
+
+## Verifiche eseguite
+
+- compilazione Python di `app.py`: superata;
+- import dell'applicazione e costruzione dell'interfaccia Gradio: superati;
+- avvio locale e risposta HTTP sulla porta 7860: superati;
+- presenza della funzione `@spaces.GPU`: verificata nel sorgente;
+- componenti FastSAM nella configurazione Gradio: copia cliccabile visibile, output maschera e sovrapposizione inizialmente nascosti;
+- sincronizzazione della fotografia e registrazione del punto: verificate;
+- metodo HSV e dataset: verificati su `NS_A_14.jpg`;
+- percorso FastSAM completo: verificato con un modello simulato, compresi ridimensionamento, ritorno alla dimensione originale, aggiornamenti visibili e stato della sovrapposizione;
+- PDF `Guida_confronto_segmentazioni.pdf`: rigenerato e verificato tramite rendering;
+- schermata annotata 11-14: aggiornata e verificata visivamente.
+
+## Verifiche da completare nello Space
+
+- build ZeroGPU con precaricamento effettivo di `FastSAM-s.pt`;
+- controllo che il runtime accetti l'ancora `@spaces.GPU` non collegata alla UI;
+- inferenza reale FastSAM su CPU nel container Hugging Face;
+- tempi di risposta su immagini grandi e con piu utenti.
+
+Dopo il caricamento e necessario un **Factory reboot**, non un semplice restart, per eliminare la cache delle revisioni precedenti.

THIRD_PARTY_NOTICES.md

@@ -0,0 +1,18 @@
+# Componenti di terze parti
+
+Il codice e i documenti originali di questo pacchetto sono distribuiti secondo quanto indicato nel file `LICENSE`. Dipendenze, modelli e materiali riutilizzati conservano le rispettive licenze e condizioni d'uso.
+
+## FastSAM e Ultralytics
+
+- Il modulo 11-14 usa l'API `ultralytics` per eseguire FastSAM.
+- Il file `FastSAM-s.pt` non e incluso fisicamente nell'archivio: viene precaricato durante il build dal repository pubblico `Uminosachi/FastSAM` e conservato nella cache Hugging Face.
+- Il checkpoint e un file PyTorch basato su pickle; usare esclusivamente il repository indicato e verificare le condizioni di sicurezza e licenza prima della pubblicazione istituzionale.
+- Riferimenti: `https://github.com/CASIA-LMC-Lab/FastSAM`, `https://docs.ultralytics.com/models/fast-sam/`, `https://huggingface.co/Uminosachi/FastSAM`.
+
+## Gradio, Spaces, OpenCV, Pillow, ReportLab e Hugging Face Hub
+
+L'interfaccia, la compatibilita ZeroGPU, l'elaborazione delle immagini, la generazione dei PDF e il recupero del checkpoint utilizzano i pacchetti indicati in `requirements.txt`.
+
+## Materiali CREA-OF riutilizzati
+
+`Tutorial_setup_sperimentale.pdf`, `Scheda_esperimento.pdf` e le 48 immagini del dataset derivano dal precedente Space indicato nel documento di progetto. Prima della pubblicazione istituzionale verificare crediti, autorizzazioni e licenza dei materiali fotografici.