Landsat Missions

Landsat Science Data Products Metadata

You are here

Landsat science data products are being derived from Landsat Level-1 data to assist the scientific community with answering important questions pertaining to land use change, land cover change, and general environmental and/or human processes. To ensure Landsat science data are well characterized, metadata files are provided with all products.

Metadata are useful for quantifying and categorizing complex data. For Landsat science data products, metadata explain the essential characteristics of Landsat Level-1 data, and describe individual parameters of each Landsat science data product.

Metadata are stored in Extensible Markup Language (XML) files, which can be read as plain-text or with an XML reader program.

Example of global XML metadata:

<global_metadata>
        <data_provider>USGS/EROS</data_provider>
        <satellite>LANDSAT_8</satellite>
        <instrument>OLI_TIRS</instrument>
        <acquisition_date>2013-06-28</acquisition_date>
        <scene_center_time>18:40:39.8204854Z</scene_center_time>
        <level1_production_date>2014-11-13T15:01:34Z</level1_production_date>
        <solar_angles zenith="24.733788" azimuth="131.660614" units="degrees"/>
        <wrs system="2" path="43" row="31"/>
        <lpgs_metadata_file>LC80430312013179LGN00_MTL.txt</lpgs_metadata_file>
        <corner location="UL" latitude="42.801350" longitude="-120.700400"/>
        <corner location="LR" latitude="40.691440" longitude="-117.783500"/>
        <bounding_coordinates>
            <west>-120.700594</west>
            <east>-117.783319</east>
            <north>42.858456</north>
            <south>40.638480</south>
        </bounding_coordinates>
        <projection_information projection="UTM" datum="WGS84" units="meters">
            <corner_point location="UL" x="197400.000000" y="4745400.000000"/>
            <corner_point location="LR" x="433800.000000" y="4504800.000000"/>
            <grid_origin>CENTER</grid_origin>
            <utm_proj_params>
                <zone_code>11</zone_code>
            </utm_proj_params>
        </projection_information>
        <orientation_angle>0.000000</orientation_angle>
    </global_metadata>

Example of per-band XML metadata:

<band product="sr_refl" name="sr_band1" category="image" data_type="INT16" nlines="8021" nsamps="7881" fill_value="-9999" scale_factor="0.000100">
            <short_name>LC8SR</short_name>
            <long_name>band 1 surface reflectance</long_name>
            <file_name>LC80430312013179LGN00_sr_band1.tif</file_name>
            <pixel_size x="30" y="30" units="meters"/>
            <data_units>reflectance</data_units>
            <valid_range min="-2000" max="16000"/>
            <app_version>l8_surface_reflectance_0.1.0</app_version>
            <production_date>2014-11-13T15:42:29Z</production_date>
        </band>

Interpretation of Metadata

The following table provides an explanation of each line within the XML metadata file.

Global XML metadata

Metadata string

Interpretation

<global_metadata> Header string for the Level-1 metadata.
<data_provider>USGS/EROS</data_provider> Source provider of the data.
<satellite>LANDSAT_8</satellite> Satellite platform housing the instrument(s).
<instrument>OLI_TIRS</instrument> Instrument(s) aboard the satellite platform used to collect the data.
<acquisition_date>2013-06-28</acquisition_date> Date when the original data were captured.
<scene_center_time>18:40:39.8204854Z</scene_center_time> UTC time when the center of the scene’s data were captured.
<level1_production_date>2014-11-13T15:01:34Z</level1_production_date> Date when the original data were converted to Level-1 product.
<solar_angles zenith="24.733788" azimuth="131.660614" units="degrees"/> Solar zenith angle: Decimal degree angle indicating the sun’s height relative to the target.
Solar azimuth angle: Decimal degree angle indicating direction of the sun relative to the target.
<wrs system="2" path="43" row="31"/> WRS system: version of grid system used to define location of Landsat tiles.
WRS path: Longitudinal grid coordinate in WRS system.
WRS row: Latitudinal grid coordinate in WRS system.
<lpgs_metadata_file>LC80430312013179LGN00_MTL.txt</lpgs_metadata_file> Name of corresponding Level-1 metadata file, created by the Level-1 Product Generation System (LPGS).
<corner location="UL" latitude="42.801350" longitude="-120.700400"/> Upper-left (UL) corner coordinates of the Level-1 product, in decimal degrees.
<corner location="LR" latitude="40.691440" longitude="-117.783500"/> Lower-right (LR) corner coordinates of the Level-1 product, in decimal degrees.
<bounding_coordinates> Header for the bounding coordinates.
<west>-120.700594</west> Western-most bounding coordinate (longitude, in decimal degrees) of the Level-1 product.
<east>-117.783319</east> Eastern-most bounding coordinate (longitude, in decimal degrees) of the Level-1 product.
<north>42.858456</north> Northern-most bounding coordinate (latitude, in decimal degrees) of the Level-1 product.
<south>40.638480</south> Southern-most bounding coordinate (latitude, in decimal degrees) of the Level-1 product.
</bounding_coordinates> Footer for the bounding coordinates.
<projection_information projection="UTM" datum="WGS84" units="meters"> Header for map projection parameters, and the original projection, datum, and unit of measurement of the Level-1 product.
<corner_point location="UL" x="197400.000000" y="4745400.000000"/> Upper-left (UL) corner coordinates of the Level-1 product, in the map projection’s native coordinate system (meters).
<corner_point location="LR" x="433800.000000" y="4504800.000000"/> Upper-left (UL) corner coordinates of the Level-1 product, in the map projection’s native coordinate system (meters).
<grid_origin>CENTER</grid_origin> The first point on the grid where coordinates are measured.
<utm_proj_params> Header for projection parameters used in Level-1 product.
<zone_code>11</zone_code> UTM zone used in Level-1 product’s map projection.
</utm_proj_params> Footer for projection parameters used in Level-1 product.
</projection_information> Footer for map projection parameters.
<orientation_angle>0.000000</orientation_angle> Angle at which the product is oriented when processing to Level-1 (in this case, towards polar North, or 0 degrees.)
</global_metadata> Footer string for the Level-1 metadata.

 

 

Landsat Science Data Product XML metadata

Metadata string

Interpretation

<band product="sr_refl" name="sr_band1" category="image" data_type="INT16" nlines="8021" nsamps="7881" fill_value="-9999" scale_factor="0.000100"> “band”: Landsat Science Data Product metadata.
Product: Name of product used by Landsat science data product processor.
Name: Name of Landsat science data product appended to Level-1 file name.
Category: Type of data product.
Data type: Type of values used to represent data.
Nlines: Number of rows in the data product.
Nsamps: Number of columns in the data product.
Fill value: Value put in areas that could not be populated with data.
Scale factor: Multiplier used to scale the data from integer to floating point.
short_name>LC8SR</short_name> Short name of the data set.
<long_name>band 1 surface reflectance</long_name> Full name of the data set.
<file_name>LC80430312013179LGN00_sr_band1.tif</file_name> Complete file name with extension of the data set.
<pixel_size x="30" y="30" units="meters"/> Resolution and units used for pixel size measurements.
<data_units>reflectance</data_units> Types of values represented in the data set.
<valid_range min="-2000" max="16000"/> Total range of possible values -- from the minimum (min) to the maximum (max) values in the data set.
<app_version>l8_surface_reflectance_0.1.0</app_version> Version of the processing software used to create the data set.
<production_date>2014-11-13T15:42:29Z</production_date> Date when the Landsat science data product was produced.
</band> Footer for Landsat science data product metadata.

 

 

 

About

Landsat represents the world's longest continuously acquired collection of space-based moderate-resolution land remote sensing data. Four decades of imagery provides a unique resource for those who work in agriculture, geology, forestry, regional planning, education, mapping, and global change research. Landsat images are also invaluable for emergency response and disaster relief.

 

Contact Us

Landsat Updates

The Landsat Update is an informal communication tool, prepared periodically and distributed electronically to USGS Landsat partners, to provide information about Landsat activities and related topics of interest.

Accessibility FOIA Privacy Policies and Notices

USA.gov logo U.S. Department of the Interior | U.S. Geological Survey
URL: https://landsat.usgs.gov
Page Contact Information: Ask Landsat
Page Last Modified: 06/22/17 05:09 pm
Sitemap