oggm.tasks.run_random_climate(gdir, nyears=1000, y0=None, halfsize=15, bias=None, seed=None, temperature_bias=None, precipitation_factor=None, store_monthly_step=False, store_model_geometry=None, store_fl_diagnostics=None, climate_filename='climate_historical', mb_model=None, climate_input_filesuffix='', output_filesuffix='', init_model_fls=None, init_model_filesuffix=None, init_model_yr=None, zero_initial_glacier=False, unique_samples=False, **kwargs)[source]#

Runs the random mass balance model for a given number of years.

This will initialize a oggm.core.massbalance.MultipleFlowlineMassBalance, and run a oggm.core.flowline.flowline_model_run().


the glacier directory to process


length of the simulation

y0int, optional

central year of the random climate period. The default is to be centred on t*.

halfsizeint, optional

the half-size of the time window (window size = 2 * halfsize + 1)


bias of the mb model. Default is to use the calibrated one, which is often a better idea. For t* experiments it can be useful to set it to zero


seed for the random generator. If you ignore this, the runs will be different each time. Setting it to a fixed seed across glaciers can be useful if you want to have the same climate years for all of them


add a bias to the temperature timeseries

precipitation_factor: float

multiply a factor to the precipitation time series default is None and means that the precipitation factor from the calibration is applied which is cfg.PARAMS[‘prcp_scaling_factor’]


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


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’])


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


name of the climate file, e.g. ‘climate_historical’ (default) or ‘gcm_data’


User-povided MassBalanceModel instance. Default is to use a RandomMassBalance together with the provided parameters y0, halfsize, bias, seed, climate_filename, climate_input_filesuffix and unique_samples

climate_input_filesuffix: str

filesuffix for the input climate file


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


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


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


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


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

unique_samples: bool

if true, chosen random mass balance years will only be available once per random climate period-length if false, every model year will be chosen from the random climate period with the same probability


kwargs to pass to the FluxBasedModel instance


Files written to the glacier directory: