oggm.tasks.flowline_model_run

oggm.tasks.flowline_model_run(gdir, output_filesuffix=None, mb_model=None, ys=None, ye=None, zero_initial_glacier=False, init_model_fls=None, store_monthly_step=False, glen_a_fac=None, fs_fac=None, fixed_geometry_spinup_yr=None, store_model_geometry=None, store_fl_diagnostics=None, water_level=None, evolution_model=None, stop_criterion=None, init_model_filesuffix=None, init_model_yr=None, **kwargs)

Runs a model simulation with the default time stepping scheme.

Parameters:

gdiroggm.GlacierDirectory

the glacier directory to process

output_filesuffixstr

this adds a suffix to the output file (useful to avoid overwriting previous experiments)

mb_modelcore.MassBalanceModel

a MassBalanceModel instance

ysint

start year of the model run (needs to be set)

yeint

end year of the model run (need to be set)

zero_initial_glacierbool

if true, the ice thickness is set to zero before the simulation

init_model_filesuffixstr

if you want to start from a previous model run state. Can be combined with init_model_yr

init_model_yrint

the year of the initial run you want to start from. The default is to take the last year of the simulation.

init_model_fls[]

list of flowlines to use to initialise the model (the default is the present_time_glacier file from the glacier directory)

store_monthly_stepbool

whether to store the diagnostic data at a monthly time step or not (default is yearly)

glen_a_facfloat

perturbate the default glen_a (either from the inversion if PARAMS[‘use_inversion_params_for_run’] is True or PARAMS[‘glen_a’] if False) with a chosen multiplicative parameter. Useful for parameter perturbation experiments.

fs_facfloat

same as glen_a_fac but for sliding

store_model_geometrybool

whether to store the full model geometry run file to disk or not. (new in OGGM v1.4.1: default is to follow cfg.PARAMS[‘store_model_geometry’])

store_fl_diagnosticsbool

whether to store the model flowline diagnostics to disk or not. (default is to follow cfg.PARAMS[‘store_fl_diagnostics’])

evolution_model:class:oggm.core.FlowlineModel

which evolution model to use. Default: cfg.PARAMS[‘evolution_model’] Not all models work in all circumstances!

water_levelfloat

the water level. It should be zero m a.s.l, but: - sometimes the frontal elevation is unrealistically high (or low). - lake terminating glaciers - other uncertainties The default is to take the water level obtained from the ice thickness inversion.

stop_criterionfunc

a function which decides on when to stop the simulation. See run_until_and_store documentation for more information.

kwargsdict

kwargs to pass to the FluxBasedModel instance

fixed_geometry_spinup_yrint

if set to an integer, the model will artificially prolongate all outputs of run_until_and_store to encompass all time stamps starting from the chosen year. The only output affected are the glacier wide diagnostic files - all other outputs are set to constants during “spinup”

Notes

Files written to the glacier directory: