Basically, the Pixel Extraction Tool allows to extract the pixel values given by a user-specified list of geographic coordinates from a given list of data products. However, a number of additional parameters may be passed to the tool, for example the size of the area around the geographic coordinate which is to be considered.
The Pixel Extraction Tool generates output in the widely used and very general CSV-format, using tabstops as
It writes a file for each product type it has found within its input products (such as MER_FRS), each starting with a header looking like this:
# SNAP pixel extraction export table
# Window size: 1
# Expression: l1_flags.LAND_OCEAN
# Created on: 2010-09-17 14:53:21
The header is followed by the table with the actual data; it might look like the following:
In the following table, the entries are explained in detail.
|Expression result||True if the value matches the expression, false otherwise. Is omitted when expression is used for filtering.|
|ProdID||An ID for the product with relevance within the extracted data.|
|CoordID||An ID for the coordinate with relevance within the extracted data.|
|Name||The coordinate's name, if available.|
|Latitude||The coordinate's latitude value.|
|Longitude||The coordinate's longitude value.|
|PixelX||The data product's pixel value in x direction corresponding to the latitude value.|
|PixelY||The data product's pixel value in y direction corresponding to the longitude value.|
|Date(yyyy-MM-dd)||The data product's sensing date.|
|Time(HH:mm:ss)||The data product's sensing time.|
|radiance_1||Exemplary: the first of the bands considered for value extracting.|
|radiance_2||Exemplary: the second of the bands considered for value extracting.|
The user interface of the Pixel Extraction Tool consists of two panes. The first is an Input/Output-pane, which allows the user to specify
The Input/Output Pane allows to specify the input products and the output mode.
The Input/Output Pane
Input paths: The list contains the data products already chosen for extraction as well as paths to be searched for data products. Using the -Button, data products can be added to the list in multiple ways:
Time extraction: If the products carry no time information that is readable by the reader, it is possible to extract the time information from the product filename. In order to do so, the date/time pattern needs to be provided. This date pattern can be composed of the following components:
, which may appear in arbitrary order. Following some examples which for date format to parse by pattern:
yyyyMMddwould parse a string like
20111103and leads to a date
2011-11-03 00:00:00 UTC
yyyyMMdd_hh_mm_sswould parse a string like
20061126_08_56_12and leads to a date
2006-11-26 08:56:12 UTC
yyyyMMdd-HH:mm:sswould parse a string like
20170610-12:36:46and leads to a date
2017-06-10 12:36:46 UTC
yyyyDDDwould parse a string like
2010159and leads to a date
2010-06-08 00:00:00 UTC
The pattern in the filename needs to be provided, in order to tell the software where the pattern occurs within the filename and
if it is the start or end date.
The pattern must contain at least one of the placeholders
*' is a placeholder for multiple characters while the '
.' is a placeholder for a single character.
Output directory: All output is written to the selected directory.
File prefix: The specified file prefix is used to prefix the files which are written.
The Parameters Pane allows to specify several parameters used for the extraction.
The Parameters Pane
Coordinates: The coordinates table shows the user-specified geographic coordinates which are used to extract the values. They consist of a name and their latitude/longitude-values. Initially, the table is filled with the pins of the product currently selected in the Sentinel Toolbox. Additional coordinates may be added by
Name Lon Lat DateTime P1 29.8410 31.1748 2009-06-07T08:27:11 P2 31.2213 31.5987 2009-06-07T08:27:04 P3 32.3835 31.1532 2009-06-07T08:27:03
Allowed time difference: Specifies how big the difference might be between the time of a pixel and the time of the coordinate.
Export: Specifies if bands, tie-point grids and/or masks should be included in the output.
Window size: The window size specifies the number of pixels surrounding the pixels derived from the given geographic coordinates to be exported. That is, when setting the window size to 3, the values for 3x3=9 pixels will be extracted. The window size must be odd.
Pixel value aggregation method: The user can choose between a number of aggregation methods when a window size bigger than 1x1 is used. Choosing such an aggregation method, the pixel values from the window are all aggregated, so that only a single aggregated value for each coordinate will be exported. If no aggregation is selected, values of all pixels in the window will be exported. The aggregation methods that may be used are:
A band maths expression can be specified to filter the values to output. The "Edit Expression..."-button
opens the expression editor, which can be used for easily editing an expression. It is only available if the
input product list of the "Input/Output"-pane contains at least one data product; however, in any case an expression
may manually be declared.
There are two options of how to use the expression: either the expression is used to filter the values to output, that is, values which do not satisfy the expression are ignored. In the other case, the information of the value met the expression is added to the output. The specified aggregation will be performed if at least one pixel is marked as valid by this expression within the aggregation window.
Sub-scenes: Enables the export of sub-scenes. The scenes contain at least all coordinates (including the specified window) found in one product. Additionally the size of a border can be specified by which the exported scene size extended.
Google Earth output: All output coordinates are collected in one KMZ file, which can be used to display the points in Google Earth.
Match with original input: The pixel extraction allows outputting of correlative data together with the data that is extracted. This checkbox is only enabled if coordinates that carry correlative data have been added.
Copyright © 2010 by Brockmann Consult (email@example.com). All rights reserved.