Skip to content

Manipulation Examples

Load Data Layer from Catalog

To visualize, analyze and/disseminate the any data layer, the user has to load the data first. To load a data layer from catalog, click the icon to invoke the function "Catalog". A pop-up window will show as follows:

The pop-up window has the most recently available SMAP 9km top soil moisture data layer loaded as the default data layer. For example, to load a NASS categoric top soil moisture condition data layer assessed from SMAP 9km top soil moisture data, use the input options as shown in the following catalog pop-up window. The loaded data layer is illustrated as the following figure on the right:

View All Data Layers Loaded from Catalog

To view all the data layers loaded, click the icon . The following figure lists all data layers loaded from the Catelogue on the left panel. The loaded data layers can be turned on/off for visibility by clicking icon . The default setting for every loaded layer is visible. To remove a loaded data layer, the user just needs to left click the icon next to the data layer. The user can move a loaded layer up or down. To move a loaded layer up or down, place the mouse cursor over it, press and hold down the left mouse button, then move the mouse to the position you want while still holding down the left mouse button.

Apply Crop Mask to Illustrate Map of Cropland and Add Auxiliary Layers

To illustrate a map of the cropland, user can apply the Crop Mask data layer from Auxiliary Layers. Click the auxiliary map layer icon . Locate the Crop Mask Layer and click the visibility toggle icon to make the layer visible. The Crop Mask Layer will be overlaid on the loaded top data layer as shown in the following figure.

Similarly, to add any other auxiliary data layer, click the auxiliary map layer icon and click the visibility toggle icon of the auxiliary data layer you want to overlay on the loaded top data layer.

Get Pixel Information

To query and display data type and data value of a selected pixel, click the icon to invoke the function "Pixel Info". Move the mouse pointer to a pixel of interest and left click the mouse. The data type and value of the top layer will be displayed as follows (NDVI is the top layer in this example).

Each pixel within a data layer has a category name, category value, and a defined color. The color and category name information can also be found in the Legend.

Define An Area of Interest

In order to perform any zonal statistical analysis, it is necessary to first define an Area of Interest (AOI). There are four ways to select an AOI.

By State/County Administrative Boundary

You can select an AOI by state or by county within a state. You can only select one county within one state at a time. Clicking the tool icon to select a specific state, county, Agricultural Statistics District (ASD) or Region as an area of interest, a pop-up window will show as follows:

After selecting Iowa, Calhoun County, the selected area of interest (Calhoun County, Iowa) will be highlighted.

By Rectangle

Click the icon first to invoke the function. Then click the mouse at the top left corner and lower right corner to define rectangular area of interest as shown in below. Click the icon again to disable the rectangle AOI drawing function.

By Polygon

Click the icon to invoke the Polygon Area of Interest function. To define a polygon area of interest, the user can click around the polygon boundary of interest. Double click the last vertex of the polygon to finish drawing the AOI as shown below. Click the icon again to deactivate this function.

By Imported AOI

The AOIs can be existing server-stored administrative boundaries, such as state or county boundaries, and AOIs drawn using the tools provided in this application. In addition, this application also allows users to upload their existing customized AOIs to conduct analysis in this application. To upload the customized AOI, the user needs to click the icon to import a vector file (in GML or ESRI Shapefile format) to define the area of interest as shown in the following pop-up windows:

Click the "Browse" to locate your customized AOI file. Another dialog windows will pop-up as below.

Select the customized AOI ZIP file "AOI_test.zip" and then click the "Open" button. This dialog window will disappear. The AOI file named "AOI_test.zip" will appear in the import function window. Clicking the "Upload" button will import the user's AOI as shown in the following figure.

*Note: To upload an ESRI Shapefile, you must compress all files in a single .ZIP file. The ZIP file must include at least the following four files: .SHP, .SHX, .DBF, and .PRJ.

**Note: You can drag & drop GML files directly on the map.

Perform zonal statistics for an Area of Interest

Before starting any statistics analysis, the user needs to load the data layer of interest into the application by clicking the Catalog icon . To perform zonal statistics, an area of interest (AOI) needs to be pre-defined. With the AOI defined, click the Statistics icon , and the function will calculate the statistics within the AOI for the currently loaded top data layer. It will pop-up a window, which presents a table of pixel counts and acreage calculated from the pixel count of every category within the AOI.

For example, as shown on the left figure below the daily NDVI data on April 26, 2020 was selected from the catalog. On the right figure below, the State of Iowa was selected as an AOI.

The following pop-up windows are the results of clicking the Statistics function icon. The upper table below summarizes the statistics of the entire State of Iowa daily NDVI on April 26, 2020. The lower table below shows the statistics of the NDVI of the cropland of the State of Iowa on April 26, 1. The cropland only statistics can be calculated by check the "Cropland only" check box right below the tool bar of the statistics summary window. In the table, the NDVI values are divided into 11 segments for better visualization. This NDVI data segmentation is the exact same setting as the NDVI thematic mapping.

\ The toolbar at the top of the window, contains five functions for statistics data presentation and dissemination. For better dissemination, the statistics data can be viewed and copied from a simple txt format with the view table function , printed on paper with printing function, and exported to an electronically readable file in .csv format with the export function .

For graphically visual representation of the statistics results, either Pie Chart or Bar Chart presentation can be automatically generated by clicking icon  or as shown below.

Create PDF Map

To create a PDF formatted map of a specifically predefined AOI of the currently loaded top data layer, the function Create PDF can be used. Clicking the icon , the following panel will pop-up.

User may input the map title (or use the default title), select the printer/plotter paper size, and select the overlaid boundary and then click the red submit button. A predesigned PDF map will be automatically created as shown in the figure below.

Analyze Changes

This application currently implements two data change analysis tools: Swipe function and Profile function. Both tools are located on the left toolbar.

Swipe

Swipe function is implemented for comparing two different data map layers in detail. Clicking icon , a swipe control bar will pop-up as follows:

First, click the icon and a data layer selecting window pops-up. Select the data layer as shown on the left figure below. The red becomes green indicating the data selected. Similarly, click the icon and a data layer selecting window pops-up. Select the data layer as shown on the right figure below.

This example illustrates using Swipe function to compare two SMAP 9km top and sub categorical soil moisture condition layers on different dates. By dragging the green sliding bar to the left or right, you will see one layer swiped on top of the other data layer. The difference between two map layers is clearly illustrated at the overlapping line, as circled in red in the States of Wyoming, Colorado and New Mexico in figure below.

Profile

This function profiles the daily or weekly NDVI, and 9km SMAP top and sub soil moisture of a selected pixel location.  To generate a profile of a point of interest (POI) on the data layer, user needs to left click the Point tool on AOI toolbar and then move the cursor to a point of interest and left click the mouse. A selected POI is shown as following:

To generate a profile of an interested data layer, click the Profile icon and a pop-up dialog window for selecting data layer for profiling will show up. User can then choose a data layer of interest as shown on the left figure below. Click the "Submit" button after selecting the data layer of interest. A profile of the selected data layer at the POI will be plotted as shown in the right figure below. For 9km soil moisture data, both average and maximum data will be plotted as shown the figure.

Composite

The composite function provides a tool for user to assess the soil moisture condition using latest available data in the current period with an option to include partial previous week data. To conduct an ad-hoc composite data layer, user needs to click the composite function icon first. A dialog window will pop-up. User needs to select a data type from three original daily soil moisture data products and select a set of different dates as shown in the following dialog window.

After selecting the data type and dates of the layers to be composited, user needs to select a composite method and click "Calculate" button. In this example, we use the default method "AVG"- "Average", which will take the average value of all selected layers. The other available method is "MAX", which takes the maximum value among all layers. The composited data layer will be added to the loaded Layers as a "top" layer, Composite Layer, as shown the following screen capture:

User can perform normal operations including Statistics, PDF Map, and Download.

Download

The download function icon is located at the lower end of the left toolbar. Downloading the defined area of interest of the top layer data can be performed by clicking this download icon . A dialog window will pop-up as shown below. Edit the output file name and click the "Save" button to save the file.

One-Click Report

This function enables the application to produce statistics report of the top data layer for five regions in California: Central Valley, Coastal, Desert, Mountain Coast, and Sierra Nevada. User needs to decide which data layer to report and click the Layers icon to move the data layer you are interested in to the top. If the data layer has not been loaded yet, click the Catalog to load the data layer you are interested, such as SMAP Top-Categorical, weekly data as shown in the following figures.

With the data of interest loaded, clicking the icon will pop-up a dialog window, which displays the statistics results, charts and a PDF map of the default Central Valley Region for visualization. Clicking the "Generate Report" Button will generate the statistics report in text and maps in PDF for five individual California Regions, including Central Valley, Coastal, Desert, Mountain Coast, and Sierra Nevada.

Once it the report is generated, a dialog window will pop-up for the user to enter the name of the output report name as follow.

After entering the file name, click the "Save" button to save the report. The saved file will be compressed. The user can extract the file for further compiling and editing.

Animation

The animation function enables the user to render a series of frames of maps (images) of a given period at a selected speed. It enables users to illustrate the change dynamics of the selected data layer of interest spatially and temporally. The animation function takes the currently loaded top data layer as the default data type. To animate a period of a specific type of data layer of interest, user needs to load the type of data first by clicking the Catalog icon . In this example, we load the SMAP top soil moisture 9km Anomaly data for animation as shown below:

Next, we need to set the period of the time series for animation. The Click this button to invoke the animation function. An animation control bar will pop-up as shown below:

The app's animation period defaults to the most recent available 30 days as shown on the calendar on the right side of the animation toolbar. If the default period does not meet your needs, the user needs to set his/her animation period by clicking the start and ending calendars on the animation bar. The starting and ending dates of this example are set to April 1, 2020 and May 15, 2020 as shown in the following figure:

After setting the animation period, click the play button to load and play the data. Once the "Play" button is clicked, the "Pause" button appears. (The "Play" button and the "Pause" button toggle each other.) The animation play is defaulted to repeat. User can use the "Repeat Control" toggle button on the animation bar to turn the "Repeat" on or off. To adjust the play speed, stop the animation player and slide the green speed button to right to increase the play speed or to left to reduce the speed.