[GRASS-translations] manpages italian translation: r.in.mat

[Marco Curreli]

<h2>DESCRIZIONE</h2>

<em>r.in.mat</em> importa una mappa raster di GRASS da un file MAT
versione 4 creato con Matlab o con Octave.
Se esistenti, vengono importati anche gli attributi, come il titolo
della mappa e i confini.
<br>
<br>
Per la precisione, vengono lette le seguenti variabili di array:<br>
<ul>
  <li><b> map_data</b>
  <li><b> map_name</b>
  <li><b> map_title</b>
  <li><b> map_northern_edge</b>
  <li><b> map_southern_edge</b>
  <li><b> map_eastern_edge</b>
  <li><b> map_western_edge</b>
</ul>

Le altre variabili nel file MAT verranno ignorate.<br>
<br>
La variabile "<b>map_name</b>" &egrave; opzionale; se esiste ed &egrave;
valida, la nuova mappa verr&agrave; denominata in questo modo. Se non
esiste, o viene definito un nome con l'opzione <b>output=</b>, il nome
della mappa raster verr&agrave; impostato, rispettivamente, al nome del
"<tt>file Mat</tt>" o al nome specificato (massimo 64 caratteri; si applicano
le normali regole di GRASS per l'attribuzione dei nomi).
<br>
<br>
La variabile "<b>map_title</b>" &egrave; opzionale; se &egrave; impostata viene
attribuito un titolo alla mappa.
<br>
<br>
Le variabili "<b>map_northern_edge</b>" e simili sono obbligatorie, a meno che
l'utente non debba importare i dati in una location "XY" non georeferenziata
(p.es. un'immagine). I valori di latitudine e longitudine devono essere in
formato decimale.


<h2>NOTE</h2>

<em>r.in.mat</em> importa un file MAT Versione 4. Questi file possono essere
creati con successo con le pi&ugrave; moderne versioni di Matlab e di Octave
(si vedano gli "ESEMPI" pi&ugrave; avanti).<br><br>

Ogni cosa dovrebbe essere "Endian safe", in modo che i file da importare
possano essere semplicemente copiati tra architetture di sistema differenti,
senza dover eseguire una conversione binaria (attenzione: si veda "TODO"
pi&ugrave; avanti).<br><br>

Poich&eacute; negli array di numeri interi non c'&egrave; uno standard IEEE per
<tt>NaN</tt>, per rappresentarlo all'interno di queste mappe pu&ograve; essere
usato il valore nullo di GRASS.  Normalmente Matlab salva le matrici di numeri
interi contenenti valori <tt>NaN</tt> come array di valori a virgola mobile con
precisione doppia, per cui generalmente il problema non si pone.  Per
risparmiare spazio, una volta che la mappa &egrave; caricata in GRASS si
pu&ograve; riconvertirla in una mappa con valori interi, col seguente comando:
<div class="code"><pre>
r.mapcalc int_map="int(MATFile_map)"
</pre></div>

I valori <tt>NaN</tt> nelle matrici a virgola mobile, o a virgola mobile
con precisione doppia, si dovrebbero convertire in valori nulli, come previsto.<br><br>


<em>r.in.mat</em> deve caricare in memoria l'intero array mappa
prima di scriverlo, perci&ograve; potrebbe avere problemi con gli array
di grandi dimensioni (una mappa con DCELL 3000x4000 consuma circa
100mb di RAM)<br><br>

GRASS definisce i suoi confini di mappa al bordo esterno delle celle di confine,
non alle coordinate dei suoi centroidi. In questo modo possono essere usati i
seguenti comandi di Matlab per determinare e verificare se le informazioni
sulla risoluzione della mappa sono corrette:
<div class="code"><pre>
    [rows cols] = size(map_data)
    x_range = map_eastern_edge - map_western_edge
    y_range = map_northern_edge - map_southern_edge
    ns_res = y_range/rows
    ew_res = x_range/cols
</pre></div>

<br>
Gli array Matlab sono referenziati come <tt>(row,column)</tt>,
cio&egrave; <tt>(y,x)</tt>.
<br><br>
Inoltre, <em>r.in.mat</em> e <em>r.out.mat</em> rappresentano un buon 
formato contenitore binario per trasferire mappe georeferenziate, 
anche senza usare Matlab o Octave. 

<h2>ESEMPI</h2>

In Matlab, salvare con:
<div class="code"><pre>
save filename.mat map_* -v4
</pre></div>

In Octave, salvare con:
<div class="code"><pre>
save -mat4-binary filename.mat map_*
</pre></div>

<br>

<h2>DA FARE</h2>

Un buon supporto per l'importazione dei binari mixed-endian.
<i>(Questa &egrave; un'attivit&agrave; in corso, si chiede di segnalare
ogni malfunizonamento nel sito <a href="http://trac.osgeo.org/grass/">
GRASS bug tracking system</a></i>; &egrave; necessario autenticarsi come
utente OSGeo)
<br>
Aggiungere il supporto per importare la cronologia della mappa, le informazioni
sulla categoria, la mappatura dei colori, etc., se sono disponibili.
<br>
L'opzione per importare la versione 5 dei file MAT, con la mappa e le
informazioni di supporto memorizzate in un unico array strutturato.

<h2>BACHI</h2>

In caso di problemi contattare il "GRASS Development Team".

<h2>VEDI ANCHE</h2>

<i>
<a href="r.out.mat.html">r.out.mat</a>,
<a href="r.in.ascii.html">r.in.ascii</a>, 
<a href="r.in.bin.html">r.in.bin</a>,
<a href="r.mapcalc.html">r.mapcalc</a>,
<a href="r.null.html">r.null</a>.<p>
The <a href="http://www.octave.org">Octave</a> project
</i>


<h2>AUTORE</h2>

Hamish Bowman<br> <i>
Department of Marine Science<br>
University of Otago<br>
New Zealand</i><br>

<br>
<p><i>Last changed: $Date: 2008-05-21 15:04:10 +0200 (Wed, 21 May 2008) $</i>

<!-- Tradotto da Marco Curreli <marcocurreli at tiscali dot it> 4 aprile 2009-->