S-SIN-CABA-C3-11025 Manuale_Utente

S-SIN-CABA-C3-11025
SISTEMA INFORMATIVO AGRICOLO NAZIONALE
CONTROLLI INTEGRATI IN AGRICOLTURA
IMAGE SERVER A TASSELLI ED EVOLUZIONE VIEWER
MANUALE UTENTE
Redatto Alessandro Caccia
ABACO
Verificato Alessandro D’Agata
ABACO
Approvato Alberto Bignotti
Lista di Mariano Laghezza
distribuzione Stefano Sansone
Maria Antonietta Del Moro
Mauro Segnalini
Vincenzo Palmisano
Alberto Iori
Corrado Corradi
Carmela Quaranta
Roberto Storti
Versione 1.0
del 26/03/2011
ABACO
SERV
GIS
GIS
GIS
GIS
ABACO
ABACO
ABACO
ABACO
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
1 di 8
Manuale utente Image Server a Tasselli ed Evoluzione
Viewer
S-SIN-CABA-C3 - 11025
INDICE
1.
INTRODUZIONE ................................................................................................................................................. 3
1.1.
1.2.
1.3.
1.4.
1.5.
1.6.
PREMESSA........................................................................................................................................................... 3
SCOPO................................................................................................................................................................ 3
CAMPO DI APPLICAZIONE........................................................................................................................................ 3
RIFERIMENTI ........................................................................................................................................................ 3
REGISTRO DELLE MODIFICHE ................................................................................................................................... 3
ACRONIMI E GLOSSARIO......................................................................................................................................... 3
2.
MODALITÀ DI COLLOQUIO................................................................................................................................. 4
3.
FUNZIONALITÀ .................................................................................................................................................. 5
3.1.
GENERALITÀ ........................................................................................................................................................ 5
3.2.
UTENTI ............................................................................................................................................................... 5
3.3.
VINCOLI .............................................................................................................................................................. 5
3.4.
FUNZIONI ELEMENTARI ................................................................................................................................... 5
3.4.1. Parametri di esecuzione .............................................................................................................................. 5
3.4.2. Risoluzione dei problemi ............................................................................................................................. 6
3.4.3. Utilizzo dei Tiles ........................................................................................................................................... 7
4.
CODICI E MESSAGGI........................................................................................................................................... 8
Versione 1.0
del 26/03/2011
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
2 di 8
Manuale utente Image Server a Tasselli ed Evoluzione
Viewer
S-SIN-CABA-C3 - 11025
1. INTRODUZIONE
1.1. PREMESSA
Nel presente manuale utente vengono illustrate le modalità di utilizzo del funzioni di Image Server
a Tasselli ed Evoluzione Viewer.
1.2. SCOPO
Il documento ha lo scopo di illustrare le modalità di utilizzo del software di Image Server a
Tasselli ed Evoluzione Viewer.
1.3. CAMPO DI APPLICAZIONE
Software di Image Server a Tasselli ed Evoluzione Viewer.
1.4. RIFERIMENTI
Codice
Documento
1.5. REGISTRO DELLE MODIFICHE
N° Revisione
Descrizione
Autore
Data Emissione
1
Prima Emissione
ALESSANDRO
CACCIA
04/04/2011
1.6. ACRONIMI E GLOSSARIO
Abbreviazione utilizzata
SAL
Nome completo
Stato Avanzamento Lavori
AdT
Agenzia del Territorio
CPU
HA
Central Processing Unit (unità centrale di elaborazione o
processore)
High Affidability
DB
Data Base
AS
Application Server
Versione 1.0
del 26/03/2011
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
3 di 8
Manuale utente Image Server a Tasselli ed Evoluzione
Viewer
S-SIN-CABA-C3 - 11025
2. MODALITÀ DI COLLOQUIO
Il modulo è una applicazione console client che può essere facilmente scaricata/aggiornata usando
il modulo SITIIndex.
Versione 1.0
del 26/03/2011
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
4 di 8
Manuale utente Image Server a Tasselli ed Evoluzione
Viewer
S-SIN-CABA-C3 - 11025
3. FUNZIONALITÀ
3.1. GENERALITÀ
L’image server attuale processa l’immagine da restituire al client ad ogni chiamata del servizio.
Questo comporta un carico notevole in termini di CPU, RAM e di gestione delle code di
richiesta. Nel 2011 si prevede un aumento sensibile delle utenze contemporanee che
chiederanno servizi all’image server con conseguente ulteriore aumento del carico.
Per prevenire future situazioni di blocco o di eccessiva lentezza nella restituzione delle
immagini è necessario intervenire profondamente nell’architettura dell’image server.
La soluzione tecnologica individuata è quella di evolvere l’image server in modo da “preprocessare” le immagini creando tasselli regolari in formato PNG “ready to use” per le
applicazioni client.
Questi tasselli verranno collocati in un file repository ordinato per annualità della foto e livello di
dettaglio.
I client grafici attuali DBMap e DBGis dovranno essere modificati in modo tale da poter
accedere alla nuova modalità di restituzione delle immagini raster.
Nel progetto esecutivo dovranno essere tenute in particolare considerazione le necessità in
termini di infrastrutture hardware (NAS) che la nuova architettura dell’ image server comporta.
Una volta scaricato ed installato il software mediante SITIIndex (si veda il manuale apposito per
ulteriori dettagli), cambia la modalità di esecuzione; non si può cliccare normalmente su Avvia,
dato che ECW2Tile è un software console, bensì dobbiamo cliccare con il tasto destro del
mouse sul software e scegliere l’opzione Apri Prompt dei comandi.
A questo punto siamo pronti ad utilizzare il software.
3.2. UTENTI
Qualunque utenza che abbia accesso ai servizi BO e disponga delle abilitazioni e dei ruoli
necessari.
3.3. VINCOLI
Cambia la modalità di esecuzione; non si può cliccare normalmente su Avvia in SitiIndex, dato
che ECW2Tile è un software console, bensì dobbiamo cliccare con il tasto destro del mouse sul
software e scegliere l’opzione Apri Prompt dei comandi.
3.4. FUNZIONI ELEMENTARI
3.4.1. Parametri di esecuzione
Semplicemente digitando il nome del software (ecw2tile) viene proposto all’utente il set
delle opzioni disponibili:
• --help: Riproduce la medesima schermata di aiuto che viene proposta scrivendo
ecw2tile senza parametri
• -P o --path_ecw: Path contenente gli ecw sorgente. Il path va specificato secondo i
normali standard console. Può essere racchiuso tra “ (doppi apici) per poter
includere path complessi comprendenti spazi e, quando si indica una cartella, basta
indicarne il nome, senza finire con \ l’inserimento. Si noti che la barra \ viene usata
Versione 1.0
del 26/03/2011
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
5 di 8
Manuale utente Image Server a Tasselli ed Evoluzione
Viewer
•
•
S-SIN-CABA-C3 - 11025
anche come carattere di escape, quindi se termino un path con \”, la barra verrà
considerata come escape delle virgolette, le quali verranno considerate quindi come
facenti parte del path stesso.
-O o --path_output: Path di destinazione dei file WOP prodotti. Valgono tutti i
ragionamenti e le raccomandazioni fatte per l’opzione precedente
-R o --res: Risoluzione. Numero di unità disegnate per ciascun pixel immagine alla
massima risoluzione. Naturalmente, più basse sarà il valore specificato, maggiore
sarà la risoluzione.
Esempio:
1 : Alla massima risoluzione 1 pixel lineare contiene 1 unità terreno (mt per il
sistema metrico)
0.5 : Alla massima risoluzione 1 pixel lineare contiene 50cm di territorio (0.5 mt)
0.2 : Alla massima risoluzione 1 pixel lineare contiene 20cm di territorio (0.2 mt)
•
•
•
•
•
•
•
•
-W o --tile: Dimensione delle immagini che verranno richieste dai client, di solito
500. Corrisponde alla dimensione in pixel dei tasselli prodotti.
-A o --area: Lunghezza massima coperta da un unico file WOP. Indica la
dimensione a terra (reale) del quadrato costituito dal file WOP e composto dal
gruppo di tile. Più grande è il numero e minore sarà il numero di tile prodotti, ma
sarà maggiore la dimensione in KB del file prodotto. (Default 16000 unità terreno
[mt])
--off_x: Indica l’offset in coordinate reali della x con il quale correggere la
georeferenziazione
--off_y: Indica l’offset in coordinate reali della y con il quale correggere la
georeferenziazione
Entrambi questi valori vengono usati per correggere la georeferenziazione dei file
ECW, riposizionando l’origine.
--quality: Indica il fattore di compressione dell’immagine JPG prodotta in fase di
trasformazione. (Default 80)
--overwrite: Nel caso in cui venga rilanciato il software con gli stessi parametri, se
ho già un tile nel file di output lo sovrascrivo? (Default 0 [falso]) (Valori 1 / 0)
--from: Indica l’indice di tile dal quale ripartire con il calcolo, saltando tutti i
precedenti
--debug: Se impostato a 1 visualizza il nome del file ECW che si elaborando
(rallenta parecchio) (Default 0) (Valori 1 / 0)
È importante notare che, quando si usano i parametri in forma contratta (-O, -P…) il valore
va specificato separato da uno spazio; se si usano in forma estesa (--off_x, --off_y…) i
valori vanno specificati preceduti dal simbolo di = (uguale)
ESEMPIO di esecuzione:
ecw2tile -O D:\tmp\rs\out -P D:\tmp\rs -R 0.5 -W 500 --off_x=1000000 -off_y=3500000
3.4.2. Risoluzione dei problemi
Il principale problema nel quale si può incorrere è costituito da file ECW errati. In questo
caso si deve tener nota dell’indice sul quale si ha avuto l’errore, fermare ECW2TILES per
poi farlo ripartire da un poco prima dell’indice incriminato aggiungendo ai parametri:
Versione 1.0
del 26/03/2011
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
6 di 8
Manuale utente Image Server a Tasselli ed Evoluzione
Viewer
S-SIN-CABA-C3 - 11025
... --from=[indice restart] --debug=1
Così facendo, faremo ripartire l’elaborazione dei file in modalità debug, avendo quindi un
output più completo, comprensivo dei file ECW in elaborazione. Ripartendo dall’indice
indicato, il problema dovrebbe ripresentarsi in brevissimo tempo; a questo punto basta
fermare ancora una volta l’elaborazione, individuare il file ECW incriminato e rimuoverlo
dalla cartella dei file sorgenti e riprendere ancora una volta l’esecuzione, togliendo la
modalità di debug e ripartendo sempre dal medesimo indice.
3.4.3. Utilizzo dei Tiles
Quando tutti i file WOP saranno stati prodotti correttamente, è necessario utilizzare il
software sfondi (sempre scaricabile grazie SITIIndex) per gestirli.
Una volta avviato il software ed immesse le credenziali di accesso, basta individuare la
voce relativa agli ECW elaborati ed editarla (doppio click sulla voce) o crearne una nuova
nel caso in cui non fosse già presente.
Nella interfaccia di inserimento dati esiste infatti uno spazio apposito per specificare la
posizione delle ortofoto e dei Tiles (i nostri files WOP).
Versione 1.0
del 26/03/2011
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
7 di 8
Manuale utente Image Server a Tasselli ed Evoluzione
Viewer
S-SIN-CABA-C3 - 11025
4. CODICI E MESSAGGI
NA
Versione 1.0
del 26/03/2011
SIN S.r.l
RISERVATO FORNITORE - Tutti i diritti riservati
Pagina
8 di 8