Switch to side-by-side view

--- 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).