SS_autoForecast: SS_autoForecast
In mkapur/kaputils: Utilities for Stock Assessment Simulation and Data Analysis

SS_autoForecast beta version of tool to automate catch-only update iterations hopefully port to r4ss when ready

SS_autoForecast(
  rootdir,
  basedir,
  state = state,
  statesex = 1,
  statevals = 0.05,
  catch_proportions = c(0.5, 0.08426184, 0.4157382),
  forecast_start = 2021,
  forecast_end = 2031,
  fixed_catches = catch_projections[1:4, 5:7],
  Flimitfraction = catch_projections$PSTAR_0.45[catch_projections$YEAR > 2020]
)

`rootdir`	somewhere you'd like the forecasting iteration in folders created, eg forecast202X
`basedir`	directory with executed base-case model – right now, assumed to be inside `rootdir`
`state`	one of low/med/high – only works for natural mortality at present
`statesex`	0, 1 or 2 for female, male or both
`statevals`	a dataframe with columns corresponding to state (labeled low/medium/high), and optionally rows corresponding to Female and Male values
`catch_proportions`	a single or vector of values denoting the allocation proportions for each fleet in order matching .dat file; assuming `_fleet_relative_F == 2`
`forecast_start`	the first year to forecast; assume inputs before this
`forecast_end`	last year to forecast
`fixed_catches`	a matrix of input fixed catches from the end of the original model to forecast_start
`Flimitfraction`	a value or fector of same length as forecast period with P* values corresponding to a given year