<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:"Cambria Math";
        panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0cm;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:blue;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:purple;
        text-decoration:underline;}
p.msonormal0, li.msonormal0, div.msonormal0
        {mso-style-name:msonormal;
        mso-margin-top-alt:auto;
        margin-right:0cm;
        mso-margin-bottom-alt:auto;
        margin-left:0cm;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif;}
span.Shkpostityyli18
        {mso-style-type:personal-reply;
        font-family:"Calibri",sans-serif;
        color:windowtext;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-size:10.0pt;
        font-family:"Calibri",sans-serif;
        mso-fareast-language:EN-US;}
@page WordSection1
        {size:612.0pt 792.0pt;
        margin:70.85pt 2.0cm 70.85pt 2.0cm;}
div.WordSection1
        {page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="FI" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">Hi Andrea,<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">I have understood that PAM may contain any metadata that cannot be stored into the file format itself.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">I made a test but I honestly do not know what it proves, if anything.  However, if I tell GDAL to handle GeoTIFF as read-only and make some edits with<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">gdal_edit -ro -mo DATUM=WGS84 test.tif<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">gdal_edit -ro -scale 299 -offset 10 test.tif<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">then I get a tif.aux.xml file that contains<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US"><PAMDataset><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">  <Metadata><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">    <MDI key="DATUM">WGS84</MDI><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">  </Metadata><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">  <PAMRasterBand band="1"><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">    </span>
<span lang="EN-US" style="mso-fareast-language:EN-US"><Offset>10</Offset><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">    <Scale>299</Scale><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">  </PAMRasterBand><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">  <PAMRasterBand band="2"><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">    <Offset>10</Offset><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">    <Scale>299</Scale><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">  </span>
<span lang="SV" style="mso-fareast-language:EN-US"></PAMRasterBand><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">  <PAMRasterBand band="3"><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">    <Offset>10</Offset><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">    <Scale>299</Scale><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US">  </PAMRasterBand><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US"></PAMDataset><o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">If I run the commands without -ro then the tags of the GeoTIFF file are edited and no sidecar file appears.<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US">-Jukka-<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><span lang="EN-US" style="mso-fareast-language:EN-US"><o:p> </o:p></span></p>
<p class="MsoNormal"><b><span lang="SV">Lähettäjä:</span></b><span lang="SV"> Andrea Aime <andrea.aime@geo-solutions.it>
<br>
<b>Lähetetty:</b> maanantai 27. toukokuuta 2019 18.59<br>
<b>Vastaanottaja:</b> Rahkonen Jukka (MML) <jukka.rahkonen@maanmittauslaitos.fi><br>
<b>Kopio:</b> gdal-dev@lists.osgeo.org<br>
<b>Aihe:</b> Re: [gdal-dev] Is there a reference documentation for GDALMetadata structure?<o:p></o:p></span></p>
<p class="MsoNormal"><span lang="SV"><o:p> </o:p></span></p>
<div>
<p class="MsoNormal"><span lang="EN-US">Hi Jukka,<o:p></o:p></span></p>
<div>
<p class="MsoNormal"><span lang="EN-US">thank you for following up. I believe that provides information for the PAM dataset, which<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">is normally a sidecar containing statistical information such as min/max/histograms.<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">The GDAL metadata TIFF tag instead normally contains other information, such as scale/offset,<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">band names, units, and uses a XML that has a different structure.<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">Looking into the code there is something around here:<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><a href="https://github.com/OSGeo/gdal/blob/master/gdal/frmts/gtiff/geotiff.cpp#L13726"><span lang="EN-US">https://github.com/OSGeo/gdal/blob/master/gdal/frmts/gtiff/geotiff.cpp#L13726</span></a><span lang="EN-US"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">I see explicit treatment for scale/offset and a few others, not sure if there is anything else?<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">Like, if a band had a custom name, would it show up in the GDALMetadata structure in a significant way?<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">From my previous example, things like:<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"> <Item name="Band_1">Max Band_1</Item>.  <br>
    <Item name="Band_2">Min Band_1</Item>.  <br>
    <Item name="Band_3">Mean Band_1</Item>.  <br>
    <Item name="Band_4">SD Band_1</Item>.  <br>
    <Item name="Band_5">MASD Band_1</Item>.  <br>
    <Item name="Band_6">Valid Inputs</Item>.  <o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">are they actually used or just treated as "random strings"?<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">Looking at a GDALInfo output it looks like of the second, but maybe I'm missing something:<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US" style="font-family:"Courier New"">Metadata:<br>
  AREA_OR_POINT=Area<br>
<b>  Band_1=Max Band_1</b><br>
  Band_2=Min Band_1<br>
  Band_3=Mean Band_1<br>
  Band_4=SD Band_1<br>
  Band_5=MASD Band_1<br>
  Band_6=Valid Inputs<br>
  UNITS=m<br>
...<br>
<b>Band 1</b> Block=10x10 Type=Int32, ColorInterp=Gray<br>
  NoData Value=-9999<br>
  Offset: 0,   Scale:0.0001<br>
Band 2 Block=10x10 Type=Int32, ColorInterp=Undefined<br>
  NoData Value=-9999<br>
  Offset: 0,   Scale:0.0001<br>
Band 3 Block=10x10 Type=Int32, ColorInterp=Undefined<br>
  NoData Value=-9999<br>
  Offset: 0,   Scale:0.0001<br>
Band 4 Block=10x10 Type=Int32, ColorInterp=Undefined<br>
  NoData Value=-9999<br>
  Offset: 0,   Scale:0.0001<br>
Band 5 Block=10x10 Type=Int32, ColorInterp=Undefined<br>
  NoData Value=-9999<br>
  Offset: 0,   Scale:0.0001<br>
Band 6 Block=10x10 Type=Int32, ColorInterp=Undefined<br>
  NoData Value=-9999<br>
  Offset: 0,   Scale:0.0001</span><span lang="EN-US"><o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">Cheers<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><span lang="EN-US">Andrea<o:p></o:p></span></p>
</div>
</div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
<div>
<div>
<p class="MsoNormal"><span lang="EN-US">On Mon, May 27, 2019 at 1:11 PM jratike80 <</span><a href="mailto:jukka.rahkonen@maanmittauslaitos.fi"><span lang="EN-US">jukka.rahkonen@maanmittauslaitos.fi</span></a><span lang="EN-US">> wrote:<o:p></o:p></span></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0cm 0cm 0cm 6.0pt;margin-left:4.8pt;margin-top:5.0pt;margin-right:0cm;margin-bottom:5.0pt">
<p class="MsoNormal"><span lang="EN-US">Hi,<br>
<br>
Perhaps here<br>
</span><a href="https://github.com/OSGeo/gdal/blob/master/gdal/gcore/gdalpamdataset.cpp" target="_blank"><span lang="EN-US">https://github.com/OSGeo/gdal/blob/master/gdal/gcore/gdalpamdataset.cpp</span></a><span lang="EN-US"><br>
<br>
-Jukka Rahkonen-<br>
<br>
<br>
geowolf wrote<br>
> Hi,<br>
> I was wondering if there is any documentation on what a GDALMetadata XML<br>
> structure might contain, both in terms<br>
> of element/attributes, and key names?<br>
> ...<br>
<br>
<br>
<br>
<br>
<br>
--<br>
Sent from: </span><a href="http://osgeo-org.1560.x6.nabble.com/GDAL-Dev-f3742093.html" target="_blank"><span lang="EN-US">http://osgeo-org.1560.x6.nabble.com/GDAL-Dev-f3742093.html</span></a><span lang="EN-US"><br>
_______________________________________________<br>
gdal-dev mailing list<br>
</span><a href="mailto:gdal-dev@lists.osgeo.org" target="_blank"><span lang="EN-US">gdal-dev@lists.osgeo.org</span></a><span lang="EN-US"><br>
</span><a href="https://lists.osgeo.org/mailman/listinfo/gdal-dev" target="_blank"><span lang="EN-US">https://lists.osgeo.org/mailman/listinfo/gdal-dev</span></a><span lang="EN-US"><o:p></o:p></span></p>
</blockquote>
</div>
<p class="MsoNormal"><span lang="EN-US"><br clear="all">
<o:p></o:p></span></p>
<div>
<p class="MsoNormal"><span lang="EN-US"><o:p> </o:p></span></p>
</div>
<p class="MsoNormal"><span lang="EN-US">-- <o:p></o:p></span></p>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<div>
<p style="margin:0cm;margin-bottom:.0001pt"><span lang="EN-US" style="font-family:"Arial",sans-serif">Regards, Andrea Aime == GeoServer Professional Services from the experts! Visit
</span><a href="http://goo.gl/it488V" target="_blank"><span lang="EN-US" style="font-family:"Arial",sans-serif">http://goo.gl/it488V</span></a><span style="font-family:"Arial",sans-serif">
<span lang="EN-US">for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via di Montramito 3/A 55054 Massarosa (LU) phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549
</span></span><a href="http://www.geo-solutions.it" target="_blank"><span lang="EN-US" style="font-family:"Arial",sans-serif">http://www.geo-solutions.it</span></a><span style="font-family:"Arial",sans-serif">
</span><a href="http://twitter.com/geosolutions_it" target="_blank"><span lang="EN-US" style="font-family:"Arial",sans-serif">http://twitter.com/geosolutions_it</span></a><span lang="EN-US" style="font-family:"Arial",sans-serif"> -------------------------------------------------------
<i>Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si precisa che ogni circostanza inerente alla presente email (il suo contenuto, gli eventuali allegati, etc.) è
 un dato la cui conoscenza è riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra operazione è illecita. Le sarei comunque grato se potesse darmene notizia. This email is
 intended only for the person or entity to which it is addressed and may contain information that is privileged, confidential or otherwise protected from disclosure. We remind that - as provided by European Regulation 2016/679 “GDPR” - copying, dissemination
 or use of this e-mail or the information herein by anyone other than the intended recipient is prohibited. If you have received this email by mistake, please notify us immediately by telephone or e-mail.</i>
</span><span lang="EN-US"><o:p></o:p></span></p>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</div>
</body>
</html>