home products news downloads documentation support gallery online maps resellers search

Scripts By Jack™

How to Handle Imagery and GIS Data

Go to main SCRIPTING page...

Go to FAQs by Jack™...


Dr. Jack Paris has used the TNT products for over 16 years.  He shares these sample scripts in TNT's geospatial scripting language (SML) granting permission to use them without restriction.  These scripts are accompanied by a series of FAQs By Jack™ which describe the underlying theory and fundamentals, and which define the names for the parameters, variables, and objects in the scripts.

Scripts by Jack™: Table of Contents / Overview
Scripts by Jack™: Calibrating Multispectral Satellite Images
Scripts by Jack™: Workflow: Calibrating/Analyzing Multispectral Images

Jack Paris is a private remote-sensing & GIS consultant working out of Longmont Colorado. He has written hundreds of publications and scripts in TNT's geospatial scripting language about optical, radar, and GIS applications for mapping and monitoring of the environment.  See Jack's Bio.

Email: jparis37@msn.com

REPAIR_IMAGE.sml
  • Requires knowing the imager source.
  • Fixes imagery that uses "0" for both brightness and fill pixels
  • Output is another set of image data (BL, GL, ... MC).
SRFI.sml
  • Related: FAQs by Jack B and FAQs by Jack A (pdf)
  • Calibrate Satellite Images to Surface Reflectance
  • Processes source imagery data to produce SRFI rasters and pair of PVI and PBI rasters (plus SRFI.txt, a processing report).
  • Requires knowing the imager source, the collection date, the processing date, and solar elevation angle.  Defaults may be otherwise taken.  But recommend HEP=20 for QB, and HEP=500 for Landsat 7 -- not much effect on results.
  • Input may be output rasters from REPAIR_IMAGE.sml
DIAG.sml
  • Related: FAQs by Jack C (pdf)
  • Mapping Dense Vegetation and Bare Soils
  • Requires that a matching Mask Raster (MK) exist (to define area of interest that contains bare soil and dense vegetation).
  • Takes SRFI rasters and PVI & PVI and produces a set of Diagnostic Rasters (DBL, DGL, ...).
  • Input may have been produced by SRFI.sml or by TERCOR.sml.
TERCOR.sml
  • Related: FAQs by Jack D (pdf)
  • Correct for Terrain Induced Radiance Effects
  • Requires SRFI rasters and PVI and PBI pair.
  • Requires knowing the image source.
  • Requires the existence of a SHADING raster (made by TNTmips Slope, Aspect, Shading process).
  • Output is a set of terrain-slope-aspect-corrected SRFI rasters plus a related PVI & PBI pair.
GRUVI.sml
TASCAP.sml
  • Related: FAQs by Jack F (pdf)
  • Generalized Mapping of Biophysical Properties
  • Requires SRFI-scaled multispectral image bands (4 to 9 spectral bands).
  • Computes pre-defined or customized measures of biophysical properties using the Tasseled Cap transformation.
  • Outputs: a set of Tasseled Cap biophysical measure rasters plus accompanying spectral distance rasters.
WATER.sml
  • Related: FAQs by Jack G (pdf)
  • Color-Enhance Satellite Images of Coastal Areas
  • Earth Imaging Journal: "Deep Water Ahead: Using Satellite Imagery for Underwater Mapping"
    Mapping submerged water features with satellite imagery requires an approach that differs from land mapping.
    http://www.eijournal.com/Deep_Water.asp
  • Coast.rvc
  • Performs specialized color enhancements for multispectral images of coastal areas, with separate treatment of shallow-water and land areas.
  • Requires a set of four SRFI rasters (from SRFI.sml), namely, SRIFBL, SRIFGL, SRFIRL, and SRFINA).
  • Combines an enhanced natural-color image of shallow-water areas with a choice of land image: natural color, color-infrared, or grayscale.
  • Outputs: an IMAGE raster (24-bit color) that can be exported to an external format (e.g. GeoTIFF) for distribution as a value-added products.
FILTER_WATERMASK.sml
  • Related: FAQs by Jack G (pdf)
  • Utility script to optionally improve the quality of the WATERMASK raster produced and used by WATER.sml.
  • Requires a WATERMASK raster produced by a previous run of WATER.sml.
  • Allows you to refine the separation between land and water to produce a better water-enhanced composite image.
OBJECT.sml
  • Related: FAQs by Jack H (pdf)
  • Object Finding in Grayscale Images 
  • This script produces three output products:
    1. A georeferenced Edge-Probability (EP) raster,
    2. A set of georeferenced vector Scene-Object Polygons (SOPs), and
    3. A text report
    .
  • This script uses a single input raster; possibly a SRFI raster for a particular spectral band, such as SRFINA. Better yet, a Rin raster could be a Tasseled Cap (TC) raster from TASCAP.sml, e.g., TC Greenness. 
L7samp.zip L7samp.rvc: sample Landsat7 ETM image extract for an agricultural area west of Stockton, California. Bands are named using the band codes used in Scripts by Jack. A text object in the file summarizes the scene-specific parameters needed to process the extract through SRFI.sml amd TERCOR.sml and also includes the full NLAPS metadata for the parent  Landsat7 scene from which these parameters were obtained. The file also includes a digital elevation model (DEM) resampled to match the extents and cell size of the image, and a Shading raster computed from it using the sun elevation and azimuth angles at the time the image was acquired. This Shading raster is used in TERCOR.sml. (12 Mb)
L7sampSRFI.zip L7sampSRFI.rvc: sample SRFI products: Landsat7 ETM extract (L7samp) processed through SRFI.sml (Option 3) to produce calibrated and scaled surface reflectance bands that are corrected for all atmospheric effects. Also includes the processing log produced by SRFI.sml. (13 Mb)
L7lite.rvc L7lite.rvc: TNTlite-sized extract of Landsat7 ETM image west of Stockton, California. This image area overlaps that of L7samp.rvc, but includes only flat agricultural terrain, so processing by TERCOR.sml is not required. This sample scene is used for TASCAP processing in FAQs by Jack F. (1.8 Mb)
Coast.rvc

Coast.rvc: TNTlite-sized image extract from a QuickBird MS image acquired in the Florida Keys for use with WATER.sml.  The raw image bands in this file must be processed using SRFI.sml to scaled surface reflectance values first before running WATER.sml.  Parameters required for SRFI.sml are provided in a metadata text object in the file.  The image area near Key West includes urbanized and vegetated islands and shallow water of varying depth and differing proportions of bare sediment surface and sea grass.  

25 March 2009  

page update: 29 Oct 12


Back Home ©MicroImages, Inc. 2013 Published in the United States of America
11th Floor - Sharp Tower, 206 South 13th Street, Lincoln NE 68508-2010   USA
Business & Sales: (402)477-9554  Support: (402)477-9562  Fax: (402)477-9559
Business info@microimages.com  Support support@microimages.com  Web webmaster@microimages.com