IRIScope#

IRIScope è una libreria Python industry-grade per l’analisi forense della localizzazione basata su celle telefoniche. Progettata per investigatori, periti e professionisti forensi, offre strumenti precisi per analizzare dati di copertura cellulare e ricostruire percorsi di movimento.

Avvertimento

IRIScope è attualmente in fase alpha. L’installazione è disponibile esclusivamente tramite clonazione del repository.

Caratteristiche Principali#

Analisi Geometrica Precisa: Calcolo esatto di settori angolari e fasce di distanza
Verifica POI: Compatibilità tra punti di interesse e aree di copertura
Analisi Temporale: Gestione del gap temporale tra osservazioni
Ricostruzione Percorsi: Path reconstruction con routing stradale
Report Professionali: Generazione automatica di relazioni tecniche
Visualizzazioni: Mappe HTML interattive e file KML per Google Earth

Installazione Rapida#

Con uv e just (setup completo):

git clone https://github.com/pythonwoods/iriscope.git && cd iriscope && just setup

Solo con uv (senza just):

git clone https://github.com/pythonwoods/iriscope.git
cd iriscope && uv venv && uv sync --extra dev

Solo con pip (metodo tradizionale):

git clone https://github.com/pythonwoods/iriscope.git
cd iriscope && python -m venv .venv && source .venv/bin/activate && pip install -e ".[dev]"

Vedi la guida completa per tutti i metodi disponibili.

Esempio di Utilizzo#

Metodo ad alto livello (Consigliato):

from iriscope.analysis import ForensicInvestigation

# Carica configurazione ed esegue analisi completa (KML, HTML, Report CTU)
investigation = ForensicInvestigation.from_config("caso_rapina.toml", output_dir="output/perizie")
result = investigation.run(case_name="Rapina_Piazza_Venezia")

print(f"Relazione CTU generata: {result.ctu_report_path}")

Metodo a basso livello:

from iriscope import CellLocationAnalyzer

analyzer = CellLocationAnalyzer()
cell_data, kml_path = analyzer.analyze_and_generate_kml(
    antenna_lat=41.084157,
    antenna_lon=14.435263,
    azimuth_start=310.0,
    azimuth_width=120.0,
    distance_min=575.0,
    distance_max=684.18,
    output_path="analysis.kml",
)

Uso da Linea di Comando#

# Genera visualizzazione KML
iriscope analyze kml \
    --lat 41.084157 --lon 14.435263 \
    --azimuth 310.0 --width 120.0 \
    --min 575.0 --max 684.18 \
    --output analysis.kml

# Esegui analisi forense completa
iriscope analyze forensic \
    --lat 41.084157 --lon 14.435263 \
    --azimuth 310.0 --width 120.0 \
    --min 575.0 --max 684.18 \
    --case investigation_2024