Skip to content

Simulation Configurations

This section of configuration file specifies general parameters of the simulation. These parameters are mainly defining higher-level behaviors of SAM regarding input and output.

"simulation_parameters": {
    "n_sims": 1,
    "master_seed": "random",
    "log_level": "info",
    "progress": false,
    "output_path": "../outputs/",
    "output_prefix": "sample_sim",
    "update_config": true,
    "save_all_pubs": false,
    "save_meta": true,
    "save_overall_summaries": true,
    "save_pubs_per_sim_summaries": true,
    "save_rejected": false
}

The list below describes the type and functoin of each parameters:

  • n_sims, int, indicates the total number of simulations.
  • master_seed, int / "random", indicates the intial seed of the RNG engine. If set to "random", a random number will be used at the start of the execution.
  • log_level, string, indicates the logging level of the simulation
  • progress, boolean, indicates whether a progress bar should be displayed
  • output_path, string, indicates a path to be used for output files
  • output_prefix, string, indicates a prefix to be added to all output filenames
  • update_config, boolean, indicates whether the config file should be updated after the simulation. Note: This might overwrite master_seed or output_path
  • save_all_pubs, boolean, indicates whether all publications should be saved.
    • One CSV file with the name of output_prefix_Publications.csv, containing all accepted publications across all simulations, will be created
  • save_meta, boolean, indicates whether outputs of meta-analysis methods should be saved.
    • For each given meta-analysis method, one CSV file with the name of output_prefix_MetaAnalysisMethodName.csv, containing records of meta-analysis output from each simulation, will be created
  • save_overall_summaries, boolean, indicates whether the summary of entire simulation should be calculated and saved
    • One CSV file for the entire simulation with the name of output_prefix_Publications_Summaries.csv, containing one record of several statistics from all publications, will be created
      • for each output parameters, SAM calcuate the overall mean, standard deviation, variance, min, max, range
    • One CSV file for the entire simulation with the name of output_prefix_MetaAnalysisMethodName_Summaries.csv, containing one record of several statistics from all meta analysis outputs, will be created.
  • save_pubs_per_sim_summaries, boolean, indicates whether the summary of each simulation run should be calucated and saved.
    • One CSV file for the entire simulation with the name of output_prefix_Publications_Per_Sim_Summaries.csv, containing records of several statistics from each publications list, will be created.
  • save_rejected, boolean, Indicates whether rejected publications should be stored and saved.
    • One CSV file for the entire simulation with the name of output_prefix_Rejected.csv, containing all rejected publications across all simulations, will be created

Last update: 2021-09-18