Terrestrial Ecological Unit Inventory (TEUI) Geospatial Toolkit
UPDATE: The GTAC TEUI Geospatial Toolkit is being updated for ArcGIS Pro. A new version will be released soon.
TEUI Geospatial Toolkit 5.8
The Terrestrial Ecological Unit Inventory Geospatial Toolkit (TEUI Toolkit) is an ArcGIS Add-In that assists users in mapping and analyzing landscapes using geospatial data. The Toolkit was designed to accelerate the TEUI mapping process but can also be used for a variety of other natural resource mapping efforts.
The TEUI Toolkit 5 has been completely redesigned and engineered to be faster and more robust than ever.
The Toolkit utilizes both continuous and discrete raster data (e.g., slope, aspect, elevation), polygon data (e.g., map units), and point data (e.g., soil pedon or vegetation plots) to calculate zonal statistics and display the results in both a tabular and graphical format.
The TEUI Toolkit was developed and is maintained by the USFS Geospatial Technology and Applications Center in Salt Lake City, UT.
What data does the Toolkit use?
The TEUI Toolkit can use any continuous or discrete raster data provided that it is numeric. Some examples include: slope, aspect, elevation, temperature, precipitation, and curvature. To use thematic data like geology, you will have to convert each symbol to a number. For analysis zones, any feature class type (i.e. polygon, point, line) or discrete raster data layer can be used.
Remember, if you are working on USFS land, the USFS Geospatial Technology and Applications Center can provide you geospatial data for your project area. Send an e-mail to sm.fs.teuiteam@usda.gov.
Who Uses the Toolkit?
The TEUI-Geospatial Toolkit can be used by anyone who wants to analyze and perform zonal statistics. Additional features for accelerating mapping such as sample design and data mining are currently under development.
Originally developed for the mapping and analysis of Terrestrial Ecological Units, the TEUI-Geospatial Toolkit can also be used to analyze or map any natural phenomena. Non-TEUI projects have included range analysis, watershed analysis, TES analysis, vegetation mapping, wildlife habitat, scenic areas, and soil mapping.
TEUI Toolkit 5.8
ArcMap 10.5 Add-In installation package. TEUI Toolkit 5.8 is only compatible with ArcGIS versions 10.5 and above. Requires ArcGIS Spatial Analyst extension. Zipfile, 362MB.
TEUI Commandline Toolkit 5.8
For using the Toolkit outside of ArcMAP. For use with custom scripts. Only compatible with ArcGIS versions 10.0 and above. Requires ArcGIS Spatial Analyst extension. Zipfile
Download Instructions
When downloading the Toolkit, ensure you download the entire zipfile by clicking the ‘Download’ button at the top right corner of the page. Do not download the add-in file individually using the ‘…’ button.
TEUI Toolkit 5.8 User Guide
Provides instructions for software installation and use. PDF, 3.1MB.
Detailed Installation Instructions
Citrix Install Instructions - PDF 188KB
Manual Installation Instructions
First, be sure that ArcMap is not open and running. Also, be sure that there are no previous versions of the TEUI Toolkit by using the Add-In manager (Customize | Add-In Manager | Delete this Add-In for versions 5.0 and above) or (Control Panel | Add\remove programs | Remove Program for version 4.1 and lower) to remove any previous copies of the TEUI Toolkit.
Download the zipfile containing the Toolkit from the link above, and save it to a location of your choice.
Once the download is complete, navigate to the location of the download. Open the zip archive by double clicking (do not extract/unzip it) and then double click again on the Add-In file.
When prompted, select “Install Add-In”
Click “OK” once the installation has succeeded.
Build 1653 (5.8)
Binning slider added to graph UI for displaying floating point data.
Bigger graph window, modified sidebar layout.
Build 1647 (5.8)
Bug fix in running stats on overlapping polygons
Teui lite bug fix when encountering no data values
Connotative legend stats calculation bug fix.
Use gdal to calculate stats in teui lite.
Build 1523 (5.8)
Latin Hypercube Generator no longer requires opening the Manage Data window first
Resolved issue with White BG toggle not working in Objective Function Graph Window associated with Latin Hypercube Generator
Resolved issue where Data Manager was throwing an error when data was added
Removed erroneous errors (yellow triangles) in the data manager when legitimate layers are added
Allowed spaces in the working directory name
Resolved error that occurred when TEUI Lite was engaged
Toggling of the normalize checkbox in histogram tool no longer removes mean and SD values
Resolved error with .csv data exports
Resolved error where generating legend in the Connotative Legend tool caused ArcMap to abort
Resolved issue where "Histograms." button in Latin Hypercube was not working correctly
Resolved issue where InstanceFactory inside of the TEUI.Library was failing resulting in downstream effects
Resolved temp file write access issue
Resolved zonal stats issue
Resolved issue where the Query Stats button was throwing an initialization error
Resolved issue in Histogram tool where White Background toggle was not working
Resolved issue where sample dots in the Latin Hyper Cube histogram were incorrectly positioned
Resolved issue where the Connotative Legend tool was either erroring out on stats generation or writing all no-data values when input datasets had different projections
Resolved issue with opening project workspace in Citrix
Build 525 (5.4)
Add median statistic type to graphs
Add percentile values to graphs
New toolbar menu dropdown design
Import shapefile attributes for graphing
Circular statistics for radial data types
Select by map unit statistics tool
Select feature and calculate statistics
Climate resampling tools to Toolkit
Build 495 (5.3)
Graph rendering fix for single-point series.
Radial graph drawing fix.
Prefill raster band in graph window.
Improved spatial reference check in data window.
Select all layers checkbox in data window.
Prevent multiple LHC windows from being opened.
Close all teui windows when closing ArcMap.
Ability to browse to network path in folder select dialog.
Prevent user from adding data from the temp folder.
Progress bar bug in LHC window.
Support for relative data paths.
Ability to set data source for zone layers and rasters.
Build 460 (5.2)
Resample input raster analysis zone layer and not input data
Add value to the text "average" on the graphs
Crash ArcMap by loading an invalid raster
Run latin hypercube without selecting rasters crashes arcmap
Check if user has write access to temp folder
Zoom feature be added to the histogram especially when using the MU Analysis data view type
Add tooltip to each layer in data manager that shows file location
Select statistics to export
Add the map unit symbol to the .csv export
When running lhc on two or more rasters, the denominator of the progress is wrong
Disable avg and std on radial graphs until we have those stats developed
Turn graph area white doesn't work on radial graphs
Connotative legend only works with polygons and not raster layers for feature zones
Export the validate point\map unit results table
Losing total hours when calculating statistics
Arc Crash -- Bad Temp File Name
Arc Crash -- Click List of Runs After Viewing Histogram on LHC
Connotative Legend will Overwrite Existing Text Attribute Field
Arc Crash -- Column Name used for Connotative Legend column is Numeric Field Already in Attribute Table
Folder Setup (Browse for Folder) in Properties Dialog Does Not Honor New Folder
Raster Band in Graphing Window Fails to Populate
Add graph of objective function for latin hypercube objective=y, iteration=x
R stats export format. Y = feature, x = statistic per raster band
Build 425, LHC tool. Exclusion Mask not always honored.
No rasters in drop down for export to raster
Layer Name Missing in Export Dialog
Empty map unit column throws an exception for raster zone layers.
Graph spline fit issues
Toolkit crashes on 10.2.2
Collapse Export buttons into one menu
Only allow a single data management window
Add option for mean value line on chart
Remove "Selection Tools Menu" from toolbar
Ability to change temp directory
Can't add FGB rasters to latin hypercube through add layers button, only .imgs
Export data button in stats table window
If you have a graph open and try to run statistics on the same project, it crashes due to file lock
Open existing TEUI project with missing data = crash
Remove zoom to feature for map units
Graph colors change with type of graph
Ability to print graphs
Change output of text file, rotate columns and rows
Y axis labels on the chart wrong
Build 429 (5.1)
Fixed bug with cLHS exclusion mask
All raster data formats accepted by cLHS tool
Expanded statistics export functionality and output formats
Ability to change graph background color to white
Aggregated map unit statistics available to compare against individual map unit polygons
Added standard deviation and mean lines to graphs
Ability to change temp processing directory
Functionality to print graphs
Various bug fixes
Build 429
Fixed bug with cLHS exclusion mask
All raster data formats accepted by cLHS tool
Expanded statistics export functionality and output formats
Ability to change graph background color to white
Aggregated map unit statistics available to compare against individual map unit polygons
Added standard deviation and mean lines to graphs
Ability to change temp processing directory
Functionality to print graphs
Various bug fixes
Build 352
Added the cLHS (Conditioned Latin Hyper Cube) tool
Added the CL (Connotative Legend) tool
General bug fixes
Build 347
Connotative Legend Tool
Zoom to Polygon from Graph
Graph color selection
Resources
Self-Paced Training Downloads
Self-paced trainings for the TEUI toolkit are available here [link]. The zipped folder contains six PDF documents that introduce new users to a variety of topics, including installation and set-up, calculating and displaying basic statistics, and other advanced toolkit utilities. Additionally, it contains several sub-folders with sample raster and vector data needed to complete these trainings. Zipfile, 1GB.
USDA Forest Service TEUI-Geospatial Toolkit: An Operational Ecosystem Inventory Application. Presented at: 3rd Global Workshop on Digital Soil Mapping Utah State University-Logan, UT September 30-October 3, 2008 PDF, 6.9 MB
USDA Forest Service TEUI-Geospatial Toolkit: A Case Study in Pre-Mapping for an Ecosystem Inventory. Presented at: 3rd Global Workshop on Digital Soil Mapping Utah State University-Logan, UT September 30-October 3, 2008 PDF, 3.0 MB
Winthers, E; Fallon, D; Haglund, J; DeMeo, T; Nowacki, G; Tart, D; Ferwerda, M; Robertson, G.; Gallegos, A.; Rorick, A.; Cleland, D.T.; Robbie, W. 2005. Terrestrial Ecological Unit Inventory technical guide. Washington, DC: U.S. Department of Agriculture, Forest Service, Washington Office, Ecosystem Management Coordination Staff. 245 p. PDF, 2.9 MB
Webinar on the TEUI 5.3 functionality -- Watch on NRCS YouTube Channel
The TEUI Geospatial Toolkit 5.1: An ArcGIS Extension for Natural Resource Mapping PDF, 9 MB
The TEUI Geospatial Toolkit 4.1: An ArcGIS Extension for Natural Resource Mapping PDF, 1.7 MB
Terrestrial Ecological Unit Inventory on Two Southwestern Forests: Adapting Digital Mapping Methods to Fit the Landscape PDF, 4.0 MB
Implementation of the Terrestrial Ecological Unit Inventory Geospatial Toolkit for National Forest Lands in the Southwestern USA PDF, 5.5 MB
Use of the Connotative Legend Tool by the New Mexico Southwest Region (Region 3) Terrestrial Ecosystem Survey Team PDF, 0.8 MB
Use of the TEUI Toolkit by Steve Strenger and Nori Koehler of the New Mexico Southwest Region (Region 3) Terrestrial Ecosystem Survey Team PDF, 1.9 MB
Overview of the TEUI Toolkit statistics by Estella Ruth of the Arizona Southwest Region (Region 3) Terrestrial Ecosystem Survey Team PDF, 0.9 MB
Frequently Asked Questions
Terrestrial Ecological Unit Inventory (TEUI) is a hierarchical land survey and resource inventory system developed and used by the US Forest Service. TEUI products include ecological type descriptions, maps, interpretations that provide baseline information for forest plan revisions, timber and range management decisions, ecological and watershed assessments, and project level planning.
The TEUI Geospatial Toolkit is an ArcGIS mapping tool used to delineate landscape and analyze environmental characteristics using geospatial data. This tool complements traditional inventory methods by streamlining the collection and analysis of resource inventory information in a digital environment.
The TEUI Geospatial Toolkit can be found on this website above, under Downloads.
The download file includes all the required software you will need to install the TEUI Geospatial Toolkit.
Windows XP or Windows 7 operating system
ArcGIS 10.0 and above
ArcGIS Spatial Analyst Extension
At least 8G free space to run the TEUI Geospatial Toolkit Statistics
The TEUI Geospatial Toolkit is for anyone who wants to calculate the descriptive statistics of raster data under analysis zones (feature class or raster) and view the results in an easy-to-read graphical or tabular format. While the TEUI Geospatial Toolkit was developed for the mapping and analysis of Terrestrial Ecological Units, the Toolkit can be used to analyze and/or map any polygon based data. Non-TEUI projects have included range analysis, watershed analysis, TES analysis, vegetation mapping, wildlife habitat, scenic areas, and soil mapping.
If you are working on USDA-Forest Service lands and are interested in obtaining data for your project, please contact sm.fs.teuiteam@usda.gov.
Feedback
What do you think?
We are always interested in hearing about your experience with the Toolkit. If you ever encounter any problems, have any ideas, thoughts, suggestions, or just questions, please feel free to send them to us at SM.FS.TEUIteam@usda.gov or contact:
Estella Smith
USDA Forest Service
Geospatial Technology and Applications Center (GTAC)
Salt Lake City, UT 84119
estella.smith@usda.gov
334-241-8147