emc2.simulator.main.make_simulated_data

emc2.simulator.main.make_simulated_data(model, instrument, N_columns, do_classify=False, unstack_dims=False, skip_subcol_gen=False, finalize_fields=False, calc_spectral_width=True, subcol_gen_only=False, seed=None, **kwargs)

This procedure will make all of the subcolumns and simulated data for each model column.

NOTE: When starting a parallel task (in microphysics approach), it is recommended to wrap the top-level python script calling the EMC^2 processing (‘lines_of_code’) with the following command (just below the ‘import’ statements):

if __name__ == “__main__”:
    lines_of_code

Parameters:

model: :func:`emc2.core.Model`

The model to make the simulated parameters for.

instrument: :func:`emc2.core.Instrument`

The instrument to make the simulated parameters for.

N_columns: int or None

The number of subcolumns to generate. Set to None to automatically detect from LES 4D data.

do_classify: bool

run hydrometeor classification routines when True.

unstack_dims: bool

True - unstack the time, lat, and lon dimensions after processing in cases of regional model output.

skip_subcol_gen: bool

True - skip the subcolumn generator (e.g., in case subcolumn were already generated).

finalize_fields: bool

True - set absolute 0 values in”sub_col”-containing fields to np.nan enabling analysis and visualization.

calc_spectral_width: bool

If False, skips spectral width calculations since these are not always needed for an application and are the most computationally expensive. Default is True.

subcol_gen_only: bool

If True, only returns mass and number distributed among subcolumns and skips moment calculations

seed: int or None

Random seed for reproducibility of the subcolumn generator. None (default) gives non-reproducible results with fully independent draws — best for production science runs. With an integer seed and parallel=False, a single global seed is applied before the timestep loop (serial-only, statistically independent timesteps). With an integer seed and parallel=True/’processes’, each worker seeds with seed+tt (parallel-safe, with a weak cross-timestep correlation). See the seeding note in subcolumn.py for full details.

Additional keyword arguments are passed into :func:`emc2.simulator.calc_lidar_moments` or

:func:`emc2.simulator.calc_radar_moments`

Returns:

model: emc2.core.Model()

The model with all of the simulated parameters generated.