docs/user_guide.md

Guida Utente - Applicazione di Grafologia Forense

Introduzione

Benvenuti nell'applicazione di Grafologia Forense, uno strumento completo per l'analisi e la verifica di firme e documenti. Questa applicazione combina tecniche di elaborazione delle immagini, machine learning e sistemi di recupero delle informazioni per fornire un'analisi dettagliata di firme e documenti.

Funzionalità Principali

L'applicazione è organizzata in diverse sezioni, ciascuna dedicata a specifiche funzionalità:

1. Pre-elaborazione

Questa sezione permette di caricare e pre-elaborare le immagini di firme e documenti. Il processo di pre-elaborazione include:

• Conversione in scala di grigi
• Normalizzazione dell'immagine
• Riduzione del rumore
• Binarizzazione

Come utilizzare:

1. Caricare un'immagine utilizzando il pulsante di upload
2. Cliccare su "Pre-elabora"
3. Visualizzare i risultati della pre-elaborazione

2. Comparazione Firme

Questa sezione permette di confrontare due firme per determinare il loro grado di similarità. L'analisi include:

• Estrazione di caratteristiche dalle firme
• Calcolo di metriche di similarità
• Generazione di un report dettagliato

Come utilizzare:

1. Caricare due immagini di firme
2. Cliccare su "Confronta"
3. Analizzare il report di similarità generato

3. Analisi Font e Inchiostro

Questa sezione analizza il tipo di font e l'inchiostro utilizzato in un documento. L'analisi include:

• Rilevamento delle regioni di testo
• Estrazione del testo
• Analisi del font (serif/sans-serif, monospaced, grassetto, corsivo)
• Analisi dell'inchiostro (tipo, colore, stampato/manoscritto)

Come utilizzare:

1. Caricare un'immagine contenente testo
2. Cliccare su "Analizza"
3. Esaminare il report dettagliato sul font e l'inchiostro

4. Misurazione e Profilazione

Questa sezione fornisce strumenti per misurare vari aspetti di un documento, come:

• Spazio tra le linee
• Spazio tra le parole
• Margini
• Inclinazione dei caratteri
• Profilo di pressione

Come utilizzare:

1. Caricare un'immagine di un documento
2. Cliccare su "Misura"
3. Analizzare le misurazioni e i grafici generati

5. Miglioramento Immagini

Questa sezione offre vari filtri e tecniche per migliorare la qualità delle immagini:

• Miglioramento del contrasto
• Sharpening
• Rilevamento dei bordi
• Evidenziazione dei punti di pressione
• Effetto rilievo
• Mappa di calore

Come utilizzare:

1. Caricare un'immagine
2. Selezionare il tipo di miglioramento desiderato
3. Cliccare su "Migliora"
4. Visualizzare l'immagine migliorata

6. Machine Learning

Questa sezione include due strumenti basati su machine learning:

6.1 Rilevamento Anomalie

Utilizza algoritmi di Isolation Forest per rilevare anomalie nelle firme.

Come utilizzare:

1. Caricare un'immagine di firma
2. Cliccare su "Rileva Anomalie"
3. Analizzare il report che indica se la firma è anomala

6.2 Verifica Firme

Utilizza una rete neurale siamese per verificare se due firme appartengono alla stessa persona.

Come utilizzare:

1. Caricare due immagini di firme
2. Cliccare su "Verifica"
3. Analizzare il report che indica la probabilità che le firme siano della stessa persona

7. Sistema RAG

Questa sezione permette di caricare, consultare e gestire documenti utilizzando un sistema RAG (Retrieval Augmented Generation).

7.1 Caricamento Documenti

Come utilizzare:

1. Caricare un documento (PDF, DOCX, PPTX, TXT)
2. Cliccare su "Carica"
3. Verificare che il documento sia stato indicizzato correttamente

7.2 Query

Come utilizzare:

1. Inserire una domanda o query nel campo di testo
2. Cliccare su "Esegui Query"
3. Leggere la risposta generata in base ai documenti caricati

7.3 Gestione Documenti

Come utilizzare:

1. Cliccare su "Lista Documenti" per vedere tutti i documenti caricati
2. Per eliminare un documento, inserire l'ID del documento e cliccare su "Elimina Documento"

Consigli per Ottenere Risultati Ottimali

1. Qualità delle immagini: Utilizzare immagini ad alta risoluzione per ottenere risultati migliori.
2. Illuminazione: Assicurarsi che le immagini siano ben illuminate e non abbiano ombre eccessive.
3. Contrasto: Le immagini con buon contrasto tra testo/firma e sfondo producono risultati migliori.
4. Formati supportati: L'applicazione supporta i formati immagine più comuni (JPG, PNG) e vari formati di documento (PDF, DOCX, PPTX, TXT).

Limitazioni

1. Il sistema RAG funziona in modalità di sola ricerca, senza generazione di risposte AI.
2. I modelli di machine learning richiedono un addestramento specifico per casi d'uso particolari.
3. L'analisi del font e dell'inchiostro potrebbe non essere accurata per scritture molto stilizzate o inusuali.

Risoluzione dei Problemi

Se riscontri problemi con l'applicazione, prova le seguenti soluzioni:

1. Immagini non caricate correttamente: Verifica che il formato dell'immagine sia supportato e che la dimensione non sia eccessiva.
2. Errori nell'analisi: Prova a migliorare la qualità dell'immagine o a utilizzare la sezione di pre-elaborazione prima dell'analisi.
3. Prestazioni lente: Le operazioni di machine learning possono richiedere tempo, specialmente su immagini di grandi dimensioni.

Per ulteriori informazioni o assistenza, consulta la documentazione tecnica o contatta il supporto.