Model:FACET

FACET

Metadata

Also known as
Model type	Tool
Model part of larger framework
Note on status model
Date note status model

Incorporated models or components:

Spatial dimensions	2D
Spatial extent	Reach-Scale, Watershed-Scale
Model domain	Terrestrial, Hydrology
One-line model description	Floodplain and Channel Evaluation Tool (FACET)
Extended model description	FACET is a Python tool that uses open source modules to map the floodplain extent and derive reach-scale summaries of stream and floodplain geomorphic measurements from high-resolution digital elevation models (DEMs). Geomorphic measurements include channel width, stream bank height, floodplain width, and stream slope. Current tool functionality is only meant to process DEMs within the Chesapeake Bay and Delaware River watersheds. FACET was developed to batch process 3-m resolution DEMs in the Chesapeake Bay and Delaware River watersheds. Future updates to FACET will allow users to process DEMs outside of the Chesapeake and Delaware basins. FACET allows the user to hydrologically condition the DEM, generate the stream network, select one of two options for stream bank identification, map the floodplain extent using a Height Above Nearest Drainage (HAND) approach, and calculate stream and floodplain metrics using three approaches.

Keywords:	Channel Evaluation Tool, floodplains, floodplain extent, channel width,

Name	Samuel Lamont
Type of contact	Model developer
Institute / Organization
Postal address 1
Postal address 2
Town / City	--
Postal code	--
State
Country	United States
Email address	facet@usgs.gov
Phone
Fax

Name	Marina Metes
Type of contact	Model developer
Institute / Organization	USGS
Postal address 1
Postal address 2
Town / City	Baltimore
Postal code	21228
State	Maryland
Country	United States
Email address	mmetes@usgs.gov
Phone
Fax

Name	Peter Claggett
Type of contact	Model developer
Institute / Organization	USGS
Postal address 1
Postal address 2
Town / City
Postal code
State	Mississippi
Country	United States
Email address	pclaggett@usgs.gov
Phone
Fax

Name	Kristina Hopkins
Type of contact	Model developer
Institute / Organization	USGS
Postal address 1
Postal address 2
Town / City	Raleigh
Postal code	27607
State	North Carolina
Country	United States
Email address	khopkins@usgs.gov
Phone
Fax

Name	Gregory Noe
Type of contact	Model developer
Institute / Organization	USGS
Postal address 1
Postal address 2
Town / City	Reston
Postal code	20192
State	Virginia
Country	United States
Email address	gnoe@usgs.gov
Phone
Fax

Supported platforms	Unix, Linux, Mac OS, Windows
Other platform
Programming language	Python
Other program language
Code optimized	Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development
Does model development still take place?	No
If above answer is no, provide end year model development
Code development status
When did you indicate the 'code development status'?
Model availability	As code
Source code availability (Or provide future intension)	Through web repository
Source web address
Source csdms web address
Program license type	Other
Program license type other	CC0 1.0
Memory requirements	16GB
Typical run time	20-45 minutes

Describe input parameters	DEM, National Hydrography Dataset Plus High Resolution
Input format	Binary
Other input format
Describe output parameters	1-D Metrics: (channel width, bank height, floodplain width); 2-D Metrics: (floodplain 2D metrics); 2-D HAND Metrics: (channel width and floodplain width)
Output format	Binary
Other output format	Shapefiles
Pre-processing software needed?	Yes
Describe pre-processing software	taudem : Enable (True) or disable (False). Default is enabled. Parameter enables or disables TauDEM pre processing steps. Disabling will fail to generate any pre-processing files needed for FACET. The toggle is useful for re-running FACET without needing to also re-run all the pre processes steps. taudem cores : Parameter to set the number of cores TauDEM can use for generating pre processing files. If you experience performance issues reduce the number of cores. Default is set at 2. wt_grid : Enable (True) or disable (False). Default is enabled. Parameter to toggle the creation of a weight grid from NHD stream lines. Disabling will fail to generate *_wg.tif an important input for pre-processing steps. The toggle is useful for re-running FACET without needing to also re-run all the pre processes steps. resample resolution : The input is integer and the default is set to 3 meters. The units are always in meters. This parameter is the resolution to which the user wants the DEM resampled to. FACET uses ‘resample resolution’ to set the cross-section point distances parameter i.e. ‘xnptdist’. This ensures bank point spacing aligns with the DEM’s resolution.
Post-processing software needed?	Yes
Describe post-processing software	post process : Enable (True) or disable (False). The default is enabled. Post process as True will aggregate floodplain and channel metrics from individual cross sections to the reach-scale. Post process as False will skip this step. stream buffer : Define stream width needed for post processing steps. The input is in Meters. The default is set to 60 meters. r exe path : Complete path to RScript.exe. The user will need to update the default which is set to C:\Program Files\R\...\bin\RScript.exe. To quickly find the correct file path run the function R.home() in R. clean : Enable (True) or disable (False). The default is disabled. Clean as True will delete all intermediate files. Clean as False will save all intermediate files within the folder structure. archive : Enable (True) or disable (False). The default is disabled. Archive as True will archive the entire HUC folder as a .zip file.
Visualization software needed?	No
If above answer is yes
Other visualization software

Describe processes represented by the model
Describe key physical parameters and equations
Describe length scale and resolution constraints
Describe time scale and resolution constraints
Describe any numerical limitations and issues

Describe available calibration data sets
Upload calibration data sets if available:
Describe available test data sets
Upload test data sets if available:
Describe ideal data for testing

Do you have current or future plans for collaborating with other researchers?

Is there a manual available?	Yes
Upload manual if available:
Model website if any	https://code.usgs.gov/water/facet/blob/master/README.md
Model forum / discussion board

Comments	Limitations of FACET. The accuracy of FACET output depends on the quality and resolution of the DEM used. The user should not interpret FACET stream and floodplain geomorphic measurements as a replacement for on-the-ground measurements of geomorphic characteristic. Rather, FACET provides a tool to rapidly assess patterns in geomorphic characteristics at a regional scale. Any FACET output should be screened for outliers and abnormalities.

This part will be filled out by CSDMS staff

OpenMI compliant	No but possible
BMI compliant	No but possible
WMT component	No but possible
PyMT component	No but possible
Is this a data component

DOI model	10.5066/P9PI94Z1
For model version	0.1.0
Year version submitted	2019
Link to file	https://doi.org/10.5066/P9PI94Z1

Can be coupled with:

Model info

Authors

Samuel Lamont

Metes, Claggett, Hopkins, Noe

Source code

[ Go to external source code site]

DOI

Download FACET version: 0.1.0
Doi: 10.5066/P9PI94Z1

Model citations

Nr. of publications:	3
Total citations:	0
h-index:	--"--" is not a number.
m-quotient:	0

QR-code

Link to this page

Other models by author

FACET

Introduction

History

References

Nr. of publications:	3
Total citations:	0
h-index:	--"--" is not a number.
m-quotient:	0

Featured publication(s)	Year	Model described	Type of Reference	Citations
Lamont, S.; Ahmed, L.; Metes, M.J.; Claggett, P.; Hopkins, K.G.; Noe, G.B.; 2019. Floodplain and Channel Evaluation Tool (FACET). Version 0.1.0.. , , . 10.5066/P9PI94Z1 (View/edit entry)	2019	FACET	Source code ref.	0
Gangodagamage, Chandana; Foufoula-Georgiou, Efi; Brumby, Steven P.; Chartrand, Rick; Koltunov, Alexander; Liu, Desheng; Cai, Michael; Ustin, Susan L.; 2016. Wavelet-Compressed Representation of Landscapes for Hydrologic and Geomorphologic Applications. IEEE Geoscience and Remote Sensing Letters, 13, 480–484. 10.1109/LGRS.2015.2513011 (View/edit entry)	2016	FACET	Related theory	10
See more publications of FACET

Issues

Help

Input Files

Output Files