/* Don't forget to update the option description in smx_config when you change this */
s_surf_model_description_t surf_network_model_description[] = {
+ {"LV08",
+ "Realistic network analytic model (slow-start modeled by multiplying latency by 10.4, bandwidth by .92; bottleneck sharing uses a payload of S=8775 for evaluating RTT). ",
+ surf_network_model_init_LegrandVelho},
{"Constant",
- "Simplistic network model where all communication take a constant time (one second)",
+ "Simplistic network model where all communication take a constant time (one second). This model provides the lowest realism, but is (marginally) faster.",
surf_network_model_init_Constant},
- {"CM02",
- "Realistic network model with lmm_solve and no correction factors",
- surf_network_model_init_CM02},
- {"LV08",
- "Realistic network model with lmm_solve, adequate correction factors (latency*=10.4, bandwidth*=.92, S=8775) and partial invalidation optimization",
- im_surf_network_model_init_LegrandVelho},
- {"LV08_fullupdate",
- "Realistic network model wit lmm_solve, adequate correction factors (latency*=10.4, bandwidth*=.92, S=8775) but no further optimization. Should produce the same results as LV08, only slower.",
- surf_network_model_init_LegrandVelho},
{"SMPI",
- "Realistic network model with lmm_solve and correction factors on three intervals (< 1KiB, < 64 KiB, >= 64 KiB)",
+ "Realistic network model specifically tailored for HPC settings (accurate modeling of slow start with correction factors on three intervals: < 1KiB, < 64 KiB, >= 64 KiB)",
surf_network_model_init_SMPI},
+ {"CM02",
+ "Legacy network analytic model (Very similar to LV08, but without corrective factors. The timings of small messages are thus poorly modeled).",
+ surf_network_model_init_CM02},
#ifdef HAVE_GTNETS
{"GTNets",
- "Network Pseudo-model using the GTNets simulator instead of an analytic model",
+ "Network pseudo-model using the GTNets simulator instead of an analytic model",
surf_network_model_init_GTNETS},
#endif
#ifdef HAVE_NS3
{"NS3",
- "Use NS3 tcp model",
+ "Network pseudo-model using the NS3 tcp model instead of an analytic model",
surf_network_model_init_NS3},
#endif
{"Reno",
- "Model using lagrange_solve instead of lmm_solve (experts only)",
+ "Model from Steven H. Low using lagrange_solve instead of lmm_solve (experts only; check the code for more info).",
surf_network_model_init_Reno},
{"Reno2",
- "Model using lagrange_solve instead of lmm_solve (experts only)",
+ "Model from Steven H. Low using lagrange_solve instead of lmm_solve (experts only; check the code for more info).",
surf_network_model_init_Reno2},
{"Vegas",
- "Model using lagrange_solve instead of lmm_solve (experts only)",
+ "Model from Steven H. Low using lagrange_solve instead of lmm_solve (experts only; check the code for more info).",
surf_network_model_init_Vegas},
{NULL, NULL, NULL} /* this array must be NULL terminated */
};
s_surf_model_description_t surf_cpu_model_description[] = {
- {"Cas01_fullupdate", "CPU classical model time=size/power",
+ {"Cas01_fullupdate", "CPU classical model time=size/power (Cas01). [Deprecated. Use Cas01 with option --cfg=cpu/optim:Full. The Full option updates all actions at every step, which may be useful for debug.]",
surf_cpu_model_init_Cas01},
{"Cas01",
- "Variation of Cas01_fullupdate with partial invalidation optimization of lmm system. Should produce the same values, only faster",
- surf_cpu_model_init_Cas01_im},
+ "Simplistic CPU model (time=size/power).",
+ surf_cpu_model_init_Cas01},
{"CpuTI",
- "Variation of Cas01 with also trace integration. Should produce the same values, only faster if you use availability traces",
+ "CPU classical model time=size/power (Cas01). [Deprecated. Use Cas01 with option --cfg=cpu/optim:TI. The TI optimization is highly optimized when using traces]",
surf_cpu_model_init_ti},
{NULL, NULL, NULL} /* this array must be NULL terminated */
};
s_surf_model_description_t surf_workstation_model_description[] = {
+ {"current_default",
+ "Curent default workstation model (may change with versions of SimGrid). Currently Cas01 and LV08 (with full duplex support) as CPU and Network",
+ surf_workstation_model_init_current_default},
{"CLM03",
- "Default workstation model, using LV08 and CM02 as network and CPU",
+ "Default workstation model, using Cas01 and CM02 as CPU and Network",
surf_workstation_model_init_CLM03},
{"compound",
- "Workstation model allowing you to use other network and CPU models",
+ "Workstation model that is automatically chosen if you change the network and CPU models",
surf_workstation_model_init_compound},
- {"ptask_L07", "Workstation model with better parallel task modeling",
+ {"ptask_L07", "Workstation model somehow similar to Cas01+CM02 but allowing parallel tasks",
surf_workstation_model_init_ptask_L07},
{NULL, NULL, NULL} /* this array must be NULL terminated */
};
+s_surf_model_description_t surf_optimization_mode_description[] = {
+ {"Lazy",
+ "Lazy action management (partial invalidation in lmm + heap in action remaining).",
+ NULL},
+ {"TI",
+ "Trace integration. Highly optimized mode when using availability traces (only available for the Cas01 CPU model for now).",
+ NULL},
+ {"Full",
+ "Full update of remaining and variables. Slow but may be useful when debugging.",
+ NULL},
+ {NULL, NULL, NULL} /* this array must be NULL terminated */
+};
+
/** Displays the long description of all registered models, and quit */
void model_help(const char *category, s_surf_model_description_t * table)
{
