I file FITS della Biblioteca
23 Maggio 2022
La Biblioteca adotta la registered convention "Hierarchical
Grouping",
in tal modo diviene possibile definire associazioni gerarchiche tra
le varie HDU di file FITS. Utilizzando questa convenzione è
possibile archiviare a lungo termine non solo le rappresentazioni
digitali delle varie immagini di un manoscritto, ma anche l'insieme di queste come collezioni di immagini appartenenti a una medesima segnatura secondo
ordinamento di foliazione.
La registered convention è anche menzionata nella norma 11845:2022 in
due diversi use case presenti in appendice, ed è diffusa
prevalentemente in ambito astronomico.
Evidenziamo qui che tale convenzione permette anche di preservare più strutture
permettendo dunque di introdurre diversi ordinamenti e strutture
gerarchiche tra gli oggetti digitali.
L'implementazione scelta dalla Biblioteca realizza per ogni immagine acquisita un file
FITS con le chiavi elencate nel paragrafo successivo, e per ogni
esemplare digitalizzato (manoscritto, incunabolo, etc …) un file
FITS aggiuntivo, chiamato "file aggregante" che lega le immagini
dell'esemplare stesso.
Il file aggregante comprende in tutto 4 HDU, ossia:
- Primary HDU, descrive il contenuto del file.
- TABLE HDU, contiene i legami gerarchici tra i file FITS e i puntamenti ai file FITS della segnatura.
- TABLE HDU, contiene il dizionario completo di tutte le chiavi locali, sono presenti le descrizioni dettagliate di ogni chiave presente nei singoli file FITS
- FOREIGN HDU, contiene il file PREMIS che descrive i metadati di conservazione relativi all’esemplare digitalizzato.
Header keywords
Ogni immagine acquisita viene convertita in un file FITS a singolo HDU, particolare attenzione viene posta al requisito di omogeneità richiesto da UNI 11845:2022: ogni file contiene lo stesso numero di chiavi nello stesso ordine, fanno eccezione soltanto le ultime chiavi relative ai tutor coinvolti nel processo di digitalizzazione il cui numero può variare. Segue la lista completa delle chiavi inserite nell'header di ogni file FITS immagine insieme ad una descrizione del significato di ogni chiave e del modo di popolare il valore della chiave stessa. Le chiavi custom o chiavi standard utilizzate in modo peculiare sono evidenziate in grassetto e descrite in maggior dettaglio, per tutte le altre chiavi si rimanda alla documentazione originale del formato FITS 4.0.Le nuove chiavi di seguito illustrate sono frutto di una revisione del progetto di digitalizzazione realizzata nel 2022, vedi anche Il progetto (fase attuale).
Chiave |
Descrizione |
SIMPLE |
Prima chiave obbligatoria per ogni file FITS, impostata al valore “T” attesta la conformità del file al formato. |
BITPIX |
Numero di bit utilizzati per ogni pixel. Nel progetto BAV è pari a 8 salvo eccezioni. |
NAXIS |
Numero di dimensioni. Nel progetto BAV è pari a 3 (X,Y,colore) salvo eccezioni. |
NAXIS1 |
Lunghezza dell'asse 1, corrisponde alla risoluzione X dell'immagine. |
NAXIS2 |
Lunghezza dell'asse 2, corrisponde alla risoluzione Y dell'immagine. |
NAXIS3 |
Lunghezza dell'asse 3, Nel progetto BAV è pari a 3 (canale rosso, verde e blu) salvo eccezioni. |
UNIKEY |
Chiave che attesta la conformità del file FITS alla norma UNI 11845:2022 |
EXTEND |
Segnala la possibile presenza di altre HDU nel file. |
HDUNAME |
Identificativo unico dell’immagine, corrispondente al suo filename. Ha il duplice scopo di racchiudere un minimo contenuto semantico (segnatura, folio, eccezioni) e di costituire un identificativo unico dell’immagine digitale che viene richiamato nel file aggregante. |
GRPID1 |
Attesta l’appartenenza del file ad un gruppo. Popolato sempre con il valore numerico “-1” dichiara che la descrizione del gruppo è fornita nella prima estensione di tipo “TABLE” del file localizzato dalla chiave GRPLC1. |
GRPLC1 |
URI che permette di localizzare il file aggregante. La parte finale dell’URI coincide con il filename del file aggregante a sua volta riflesso nel valore della chiave GRPNAME del file aggregante. |
LONGSTRN |
Indica che la OGIP long string convention potrebbe essere utilizzata. |
CREATOR |
Identifica il software (nome e versione) creatore del file FITS |
INSTRUME |
Corrisponde a una composizione dei tag TIFF "Make" e "Model" |
PROGRAM |
Identifica il software (nome e versione) creatore del file TIFF oggetto di conversione |
DATE-OBS |
Data e ora dell'acquisizione dell'immagine |
DATE |
Data e ora di creazione del file FITS |
EXPTIME |
Exposure Time, ricavabile dal tag exif ExposureTime |
REFERENC |
URI di pubblicazione. |
ORIGIN |
Copyright notice |
OBJECT |
Descrizione minima dell'oggetto digitalizzato, Nel progetto BAV coincide con la segnatura di appartenenza. |
COLORMAP |
Colors mapping, popolato con il valore “RGB” o “GRAY” nel caso di immagini monocromatiche. |
CTYPE1 |
Sempre popolato con il valore " " nel progetto BAV, indica una trasformazione lineare di coordinate da pixel all'unità indicata nel valore della chiave CUNIT1 |
CTYPE2 |
Sempre popolato con il valore " " nel progetto BAV, indica una trasformazione lineare di coordinate da pixel all'unità indicata nel valore della chiave CUNIT2 |
CTYPE3 |
Coincide con il valore della chiave “COLORMAP”. La BAV utilizza qui la stessa convenzione adottata dal software Aladin e dall'archivio HST. |
CRPIX1 |
Posizione del reference point nell'asse 1. Nel progetto BAV è sempre pari a 0.0. |
CRPIX2 |
Posizione del reference point nell'asse 2. Nel progetto BAV è sempre pari a 0.0. |
CRPIX3 |
Posizione del reference point nell'asse 3. Nel progetto BAV è sempre pari a 0.0. |
CRVAL1 |
Valore della coordinata specificata dal valore della chiave CTYPE1 al reference point indicato da CRPIX1. Nel progetto BAV è sempre pari a 0.0. |
CRVAL2 |
Valore della coordinata specificata dal valore della chiave CTYPE2 al reference point indicato da CRPIX2. Nel progetto BAV è sempre pari a 0.0. |
CRVAL3 |
Valore della coordinata specificata dal valore della chiave CTYPE3 al reference point indicato da CRPIX3. Nel progetto BAV è sempre pari a 0.0. |
CUNIT1 |
Unità di misura dei valori indicati nelle chiavi CRVAL1 e CDELT1. Nel progetto BAV è sempre pari a "mm", ossia millimetri. |
CUNIT2 |
Unità di misura dei valori indicati nelle chiavi CRVAL2 e CDELT2. Nel progetto BAV è sempre pari a "mm", ossia millimetri. |
CUNIT3 |
Unità di misura dei valori indicati nelle chiavi CRVAL3 e CDELT3. Nel progetto BAV è sempre pari a " ". |
CDELT1 |
Incremento di coordinate al reference point, indica il fattore di conversione da pixel all'unità indicata dal valore della chiave CUNIT1. Nel progetto BAV è sempre pari a 25.4/XResolution, dove XResolution è il valore del tag tiff omonimo indicante i dpi dell'asse X. |
CDELT2 |
Incremento di coordinate al reference point, indica il fattore di conversione da pixel all'unità indicata dal valore della chiave CUNIT2. Nel progetto BAV è sempre pari a 25.4/YResolution, dove YResolution è il valore del tag tiff omonimo indicante i dpi dell'asse Y. |
CDELT3 |
Incremento di coordinate al reference point, nel progetto BAV è sempre pari a 1.0. |
DATASUM |
Valore utile per il controllo di integrità della parte dati di questo HDU |
CHECKSUM |
Valore utile per il controllo di integrità dell'intero HDU (header+dati) |
IMGURESL |
Resolution Unit, popolato con il valore “INCH” |
IMGXRESL |
Horizontal resolution, indica il valore di DPI in pollici come fornito dai metadati dell’immagine acquisita. |
IMGYRESL |
Vertical resolution, indica il valore di DPI in pollici come fornito dai metadati dell’immagine acquisita. |
BAV01 |
Contributor, indica l’ente o la persona fisica che hanno finanziato l’acquisizione dell’oggetto digitale |
BAV02 |
Lens model, indica l’obiettivo usato nello scatto dell’immagine, ricavabile dal tag exif LensModel |
BAV03 |
Aperture Value, valore del diaframma, ricavabile dal tag exif ApertureValue |
BAV04 |
ISO speed, ricavabile dal tag exif ISOSpeed o ISOSpeedRatings |
BAV05 |
Host PC, identificativo unico del computer utilizzata nelle operazioni di acquisizione dell’immagine. |
BAV06 |
ICC profile hex bytes |
BAV07 |
Scanner ID, identificativo unico dello strumento utilizzato nelle operazioni di acquisizione dell’immagine. |
BAV08 |
Operator, nome o identificativo unico della persona fisica autrice dell’acquisizione dell’immagine |
BAV09 |
Number of tutors in approval workflow |
BAV09_1 |
Tutor 1 full name |
BAV09_2 |
Tutor 1 approval date |
BAV09_{2*(n-1)+1} |
Tutor n full name, il valore tra parentesi graffe va inteso come una operazione da svolgere (esempio per il Tutor 4 il nome della chiave è BAV09_7) |
BAV09_{2*(n-1)+2} |
Tutor n approval date, il valore tra parentesi graffe va inteso come una operazione da svolgere (esempio per il Tutor 4 il nome della chiave è BAV09_8) |
Le chiavi utilizzate all'inizio del progetto sono visionabili al seguente link:
Keyword FITS (2015)