You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@commons.apache.org by "Gary Lucas (Jira)" <ji...@apache.org> on 2021/10/17 23:31:00 UTC

[jira] [Commented] (IMAGING-313) Provide summary of GeoTIFF tags in example TIFF-dump application

    [ https://issues.apache.org/jira/browse/IMAGING-313?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17429778#comment-17429778 ] 

Gary Lucas commented on IMAGING-313:
------------------------------------

The existing Apache Commons Imaging distribution includes an example application that opens a TIFF image file and extracts the metadata ("tags" in the TIFF parlance) for inspection.  I propose to extend the utility to include a summary of GeoTIFF-specific tags.

GeoTIFFs are an important class of TIFF files that are used to show imagery that has a geographic basis. They include Satellite images, aerial photographs, digitized maps, and even some numerical data such as elevations. The GeoTIFF standard is well-known, though slightly complex specification.

The current example application, ReadTagsAndImages.java, prints all tags in the TIFF file, but the GeoTIFF related information is presented as abstract numerical values. I propose to add logic to the tag-reading application to format some of that GeoTIFF information as human-friendly strings. 

Here's an example of a numeric data file giving high-resolution elevation data (some tags omitted).  The GeoKeyDirectoryTag is essentially a dictionary giving a guide to the content to follow.  In this case, it consists of 36 integer value.   In the Summary of GeoTIFF Elements, the proposed application interprets those integer constants as named strings.
{code:java}
Directory  0 Numeric raster data, description: Root
 256 (0x100: ImageWidth): 10812 (1 Short)
 257 (0x101: ImageLength): 10812 (1 Short)
 [snip]
 34735 (0x87af: GeoKeyDirectoryTag): 1, 1, 0, 8, 1024, 0, 1, 2, 1025, 0, 1, 1, (36 elements)
 34737 (0x87b1: GeoAsciiParamsTag): 'NAD83|' (7 ASCII)
 42112 (0xa480: GDALMetadata): '<GDALMetadata>
  <Item name="BandDefinitionKeyword">NONE</I
 42113 (0xa481: GDALNoData): '-999999' (8 ASCII)

Summary of GeoTIFF Elements -----------------
Content Type: Numeric, Floating Point (32-bit samples)    GDAL No-Data value: -999999GeoKey Table
     key     ref     len   value/pos     name
       1       1       0       8         ~~~                           ~~~
    1024       0       1       2         GTModelTypeGeoKey             Geographic Coordinate System
    1025       0       1       1         GTRasterTypeGeoKey            RasterPixelIsArea
    2048       0       1    4269         GeographicTypeGeoKey          North American Datum 1983
    2049   34737       6       0   (A)   GeogCitationGeoKey            NAD83
    2054       0       1    9102         GeogAngularUnitsGeoKey        Degrees
    2057   34736       1       1   (D)   GeogSemiMajorAxisGeoKey       6378137.0
    2059   34736       1       0   (D)   GeogInvFlatteningGeoKey       298.2572221010042
    2062   34736       3       2   (D)   To_WGS84_GeoKey               0.0 | 0.0 | 0.0

ModelPixelScale
   9.2592592526e-05   9.2592592526e-05   0.0000000000e+00

ModelTiepointTag
           Pixel                           Model
      0.0   0.0   0.0           -89.001       38.001        0.000
{code}
Finally, I note that the existing ReadTagsAndImages.java application is intended to be *example code* that shows how to use the Apache Commons Imaging API.  In that spirit, I will try to isolate the new GeoTIFF logic from the more generic TIFF logic.  My goal will be to preserve the clarity of the example.

 

> Provide summary of GeoTIFF tags in example TIFF-dump application
> ----------------------------------------------------------------
>
>                 Key: IMAGING-313
>                 URL: https://issues.apache.org/jira/browse/IMAGING-313
>             Project: Commons Imaging
>          Issue Type: New Feature
>          Components: Format: TIFF
>    Affects Versions: 1.0-alpha3
>            Reporter: Gary Lucas
>            Priority: Minor
>




--
This message was sent by Atlassian Jira
(v8.3.4#803005)