--- a +++ b/Docs/Applications/Other/StatisticalScalingPlugin.md @@ -0,0 +1,73 @@ +--- +gallery_title: "Statistical Scaling Plugin" +gallery_image: "/Applications/images/StatisticalScalingPlugin.jpg" +--- + +(sphx_glr_auto_examples_Other_plot_StatisticalScalingPlugin.py)= + +# Statistical Scaling Plugin + +````{sidebar} **Example** +<img src="/Applications/images/StatisticalScalingPlugin.jpg" width="70%" align="center"> +```` + +Plugin for scaling subjects based on an anthropometric database. + +This example shows how to use the Statistical Scaling Plugin. The plugin is a +small app which allows you to simply specify a few anatomical or functional +parameters when scaling the model. The plugin calculates the remaining (free) +anthropometric variables based on the ANSUR [^f1] anthropometrical database. + + + +:::{seealso} +**Main file location in AMMR:** + +{menuselection}`Application --> Examples --> StatisticalScalingPlugin --> Main.any` +::: + +The big advantage is that the correlation between variables are maintained, so +the model will have realistic anthropometrical dimension as long as the +constraints does not conflict (e.g. a very high stature with very short legs ) + +:::{figure} /Applications/Other/StatisticalScalingPlugin1.png +:align: center +::: + +The algorithm used by the plugin is based on principal component analysis (PCA) +of the correlations between variables in the anthropometric database. An optimization +problem is then solved minimizing the normalized principal component subject to +the anthropometricall constraintsngiven by the user. Please see: + +> Rasmussen, J., Waagepetersen, R. P. & Rasmussen, K. P. +> Projection of anthropometric correlation for virtual population modelling. +> International Journal of Human Factors Modelling and Simulation 6, 16–30 (2018) + +:::{warning} +The plugin can not be used to generate subjects which are very +different from the population of the ANSUR database. For example children. +::: + +## Use the plugin in other models + +The plugin can be used in any model as long as it uses the +{ammr:bm_constant}`_SCALING_XYZ_` scaling law. It is also necessary to specify into +which file the plugin should write the calculated anthropometrics. This is done +by setting `#path ANSUR_PLUGIN_ANYMAN_FILE` model file which contains the +anthropometrics +. + +```AnyScriptDoc +#define BM_SCALING _SCALING_XYZ_ + +#include "<ANYBODY_PATH_AMMR>/Tools/Plugins/ANSUR_Plugin.any" +#path ANSUR_PLUGIN_ANYMAN_FILE "anthropometrics.any" + +// Ensure that the generated anthropometrics are +#include "anthropometrics.any" +``` + +```{rubric} Footnotes +``` + +[^f1]: Gordon, C. C. et al. 1988 Anthropometric Survey of U.S. Army personnel: methods and summary statistics. (US Army Natick Research, Development and Engineering Center, 1989).