SFRmaker configuration file options

Below is a comprehensive summary of the input options supported in the SFRmaker configuration file. Most keys in the YAML blocks represent arguments to methods within SFRmaker or Flopy. Additional description of method arguments is available in the SFRmaker code reference and Flopy documentation.

  1# Summary of SFRmaker configuration file options
  2
  3package_version: mf6  # mf6, mfnwt or mf2005
  4package_name: model  # (defaults to model or simulation name if not specified)
  5output_path: "."  # where the output will be written
  6
  7modelgrid:
  8  # Shapefile option (arguments to sfrmaker.grid.StructuredGrid.from_shapefile):
  9  shapefile: None
 10  node_col: node
 11  kcol: k
 12  icol: i
 13  jcol: j
 14  isfr_col: isfr
 15  active_area: None
 16  crs: None
 17  prjfile: None
 18  # Flopy modelgrid option (arguments to flopy.discretization.StructuredGrid):
 19  delc: None
 20  delr: None
 21  top: None
 22  botm: None
 23  idomain: None
 24  lenuni: None
 25  xoff: 0.0
 26  yoff: 0.0
 27  angrot: 0.0
 28  nlay: None
 29  nrow: None
 30  ncol: None
 31  laycbd: None
 32
 33flowlines:
 34  # Custom hydrography option (arguments to sfrmaker.Lines.from_shapefile):
 35  shapefile: None
 36  id_column: id
 37  routing_column: toid
 38  arbolate_sum_column2: asum2
 39  asum_units: km
 40  width1_column: width1
 41  width2_column: width2
 42  width_units: meters
 43  up_elevation_column: elevup
 44  dn_elevation_column: elevdn
 45  elevation_units: meters
 46  name_column: name
 47  bbox_filter: None
 48  crs: None
 49  prjfile: None
 50  # NHDPlus option (arguments to sfrmaker.Lines.from_nhdplus_v2):
 51  NHDPlus_paths: None
 52  NHDFlowlines: None
 53  PlusFlowlineVAA: None
 54  PlusFlow: None
 55  elevslope: None
 56
 57simulation:
 58  # Simulation information
 59  # (MODFLOW-6 only; arguments to flopy.mf6.MFSimulation.load):
 60  sim_name: modflowsim
 61  version: mf6
 62  exe_name: mf6
 63  sim_ws: .
 64  strict: True
 65  verbosity_level: 1
 66  load_only: None
 67  verify_data: False
 68  write_headers: True
 69  lazy_io: False
 70  use_pandas: True
 71
 72model:
 73  # MODFLOW-NWT or MODFLOW-2005 information
 74  # (arguments to flopy.modflow.Modflow.load):
 75  namefile: None  # "f" argument in flopy
 76  version: mf2005
 77  exe_name: mf2005
 78  verbose: False
 79  model_ws: .
 80  load_only: None
 81  forgive: False
 82  check: True
 83  # MODFLOW-6 information
 84  # (arguments to flopy.mf6.MFSimulation.get_model):
 85  model_name: None
 86
 87dem:
 88  # Option to sample streambed top elevations from a DEM
 89  # (arguments to sfrmaker.SFRData.set_streambed_top_elevations_from_dem):
 90  filename: None
 91  elevation_units: None
 92  method: buffers
 93  # keyword arguments to sfrmaker.SFRData.sample_reach_elevations:
 94  buffer_distance: 100
 95  smooth: True
 96
 97inflows:
 98  # Option to add specified inflows
 99  # (arguments to sfrmaker.SFRData.add_to_perioddata for MODFLOW-6):
100  data: None
101  flowline_routing: None
102  variable: inflow
103  line_id_column: None
104  rno_column: None
105  period_column: per
106  data_column: Q_avg
107  one_inflow_per_path: False
108  distribute_flows_to_reaches: False
109  # (arguments to sfrmaker.SFRData.add_to_segment_data for MODFLOW-2005):
110  segment_column: segment
111
112observations:
113  # Option to add SFR observation input
114  # (arguments to sfrmaker.SFRData.add_observations):
115  data: None
116  flowline_routing: None
117  obstype: None
118  sfrlines_shapefile: None
119  x_location_column: None
120  y_location_column: None
121  line_id_column: None
122  rno_column: None
123  obstype_column: None
124  obsname_column: site_no
125  gage_starting_unit_number: 250
126
127to_riv:
128  # Option to convert parts of the SFR network
129  # downstream of specified line_ids to the RIV package:
130  line_ids: None
131  drop_in_sfr: True
132
133options:
134  # SFR options (arguments to sfrmaker.Lines.to_sfr):
135  active_area: None
136  isfr: None
137  model_length_units: undefined
138  model_time_units: days
139  minimum_reach_length: None
140  width_from_asum_a_param: 0.1193
141  width_from_asum_b_param: 0.5032
142  minimum_reach_width: 1.0
143  consolidate_conductance: False
144  one_reach_per_cell: False
145  add_outlets: None
146  # keyword arguments to sfrmaker.SFRData:
147  enforce_increasing_nsegs: True
148  default_slope: 0.001
149  minimum_slope: 0.0001
150  maximum_slope: 1.0