PFA_debris_flow_input: Function PFA_debris_flow_input; create an input file for...

In tabrasel/WetlandTools: General utility functions for TerrainWorks

Function PFA_debris_flow_input; create an input file for Fortran program PFA_debris_flow.

Description

PFA_debris_flow is one of a sequence of programs used to assemble data files for the PFA recalibration of the landslide initiation and debris-flow-runout models. The Quatro file PFA_runout describes calibration of a multinomial model for estimating the probability of debris-flow scour or deposition using the ODF 1996 Storm Study surveys. The coefficients for that model are inputs to PFA_debris_flow. Here, the debris-flow runout tracks from the DOGAMI Special Paper 53 study are associated with lidar-DEM flow paths and terrain attributes associated with runout extent are assembled and output in a format for a Cox survival model with time-dependent covariates.

Usage

PFA_debris_flow_input(
  dem,
  init_points,
  geo_poly,
  stand_age,
  tracks,
  radius,
  initRadius,
  length_scale,
  slope_intercept,
  slope_coef,
  bulk_coef,
  init_width,
  init_length,
  DF_width,
  alpha,
  uncensored,
  scratch_dir,
  out_surv,
  out_point,
  out_kaplanMeier,
  coef
)

Arguments

dem	Character string: The file name (full path) for the input DEM.
scratch_dir	Character string: Directory for temporary files. The input file is written to the scratch_dir.
init_points:	string: File name for initiation-point shapefile.
geo_poly:	string: File name for rock-type polygon shapefile.
stand_age:	string: File name for LEMMA stand-age flt raster.
tracks:	string: File name for DOGAMI debris-flow-track polyline shapefile.
radius:	dbl: Search radius in meters for matching DEM flow path to DOGAMI track.
length_scale:	dbl: Length in meters to measure elevation derivatives.
bulk_coef:	dbl: Bulking coefficient
alpha:	dbl: Proportion of debris-flow cross-sectional volume deposited per unit length.
uncensored:	string: If TRUE, interpret all endpoint tracks as uncensored.
out_track:	string: Output track point shapefile.
out_surv:	string: Output input file for Cox survival.
out_point:	string: Output initiation point shapefile; includes fields for scour and deposit volume.
coef:	list of dbl values specifying multinomial logistic regression coefficients for probability of scour, deposition, and transitional flow.

Value

There is no explicit return object, but an explicit side effect is writing to disk of the input file.

tabrasel/WetlandTools documentation built on Dec. 20, 2024, 8:50 a.m.