Skip to content

Ammr tutorial updates #1039

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
wants to merge 16 commits into
base: master
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion Docs/Applications/Other/StandingModelScalingDisplay.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,4 +25,5 @@ StandingModelScalingDisplay.Main.any`
The model can be scaled either regarding to measures between joint center,
or exteranal measures of bony tips, or by representation of a certain percentile of the population.

For further details see {doc}`the tutorial about scaling </Scaling/intro>`
For further details read {ref}`this information about scaling <Scaling_>` or see
[the Scaling tutorials](https://anyscript.org/tutorials/Scaling/index.html).
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Main =

Link a `libdef.any` file to specify the AMMR directories that you wish to import
the human model from. If instructions for installing the Demo AMMR in the
{doc}`previous chapter <ammr_installation>` were exactly followed, the file path
[previous chapter](installing-ammr) were exactly followed, the file path
typed below should work. Otherwise, make the necessary changes.

```AnyScriptDoc
Expand Down Expand Up @@ -145,7 +145,7 @@ Main =

When loading the model, you will now see the Human Model in the Model View.

```{image} _static/HumanModel.png
```{image} static/HumanModel.png
:alt: Human Model in Model View
:align: center
:width: 65%
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
48 changes: 27 additions & 21 deletions Docs/Scaling/intro.md → Docs/Deleted/Scaling/intro.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,12 @@
(scaling-intro)=

# Introduction to Scaling
# Introduction to Scaling (Moved to Tutorials)

:::{note}
This guide is moved from the previous "Guides" section to this "Body models" section.
This new chapter about Scaling only includes the introuction chapter while the previous
lessons 1-3 are moved to "Tutorials"
:::

:::{sidebar} Scaling Tutorials

Expand All @@ -17,18 +23,19 @@ lesson3
```
:::

Musculoskeletal models must be scalable to sizes of different
individuals to be useful for product design. Scaling pertains not only to the overall geometry,
but also muscle insertion points, muscle parameters, wrapping
surfaces etc. AnyBody has a both generic and user-define scaling laws for models in the repository.
Musculoskeletal models must be scalable to sizes of different individuals to be
useful for product design. Scaling pertains not only to the overall geometry,
but also muscle insertion points, muscle parameters, wrapping surfaces etc.
AnyBody has both generic and user-defined scaling laws for models in the
repository.

For details on scaling theory behind please take a look at [Rasmussen 2005](https://paperpile.com/shared/sqkoXwnHARTiI82J2Sarhcg).
For details on the scaling theory behind, please take a look at
[Rasmussen 2005](https://paperpile.com/shared/sqkoXwnHARTiI82J2Sarhcg).

Size related parameters of models in the {doc}`AMMR </index>`
are seldom defined as constant numbers, but instead computed from global measurements
(e.g., total height, weight of human) based on a scaling law. Thus all body models
expect the definition of a scaling law, although user can
choose the actual law.
Size related parameters of models in the {doc}`AMMR </index>` are seldom defined
as constant numbers, but instead computed from global measurements (e.g., total
height, weight of human) based on a scaling law. Thus, all body models expect
the definition of a scaling law, although the user can choose the actual law.

Currently there are six pre-defined scaling laws available in AnyBody:

Expand All @@ -41,32 +48,31 @@ Currently there are six pre-defined scaling laws available in AnyBody:
* - Scaling law
- Description
* - :any:`ScalingStandard <_SCALING_STANDARD_>`
- scale to a standard size; i.e. use 50th percentile sizes for a European male
- Scale to a standard size; i.e. use 50th percentile sizes for a European male
* - :any:`ScalingNone <_SCALING_NONE_>`
- do not scale; i.e. use underlying cadaveric dataset as is
- Do not scale; i.e. use underlying cadaveric dataset as is
* - :any:`ScalingUniform  <_SCALING_UNIFORM_>`
- cale segments equally in all directions; input is joint to
- Scale segments equally in all directions; input is joint to
joint distances
* - :any:`ScalingLengthMass <_SCALING_LENGTHMASS_>`
- scale taking mass into account; input is joint to
- Scale taking mass into account; input is joint to
joint distances and mass
* - :any:`ScalingLengthMassFat <_SCALING_LENGTHMASSFAT_>`
- scale taking mass and fat into account; input
- Scale taking mass and fat into account; input
is joint to joint distances
* - :any:`ScalingXYZ <_SCALING_XYZ_>`
- scale taking mass and fat into account; scale segments along X, Y, Z axes;
- Scale taking mass and fat into account; scale segments along X, Y, Z axes;
input is scale factors along X, Y, Z axes.
```

**Please also notice that each scaling law scales the strength of the
muscles, in addition to the size and mass of the bone.** This strength
scaling is done automatically in most cases. We will come back to it
when needed. Users who need a more comprehensive introduction can view
this recorded previous webcast titled [“Anthropometrical Scaling of
Musculoskeletal
this recorded previous webcast titled [“Anthropometrical Scaling of Musculoskeletal
Models”](https://www.anybodytech.com/download/anthropometrical-scaling-of-musculoskeletal-models).

## Overwriting default input parameters
## Overwriting Default Input Parameters

After selecting a scaling law, the user can override the default input
parameters. All input parameters can be accesed in the
Expand All @@ -79,7 +85,7 @@ the model, the user can add the following code to the `Main` file:
Main.HumanModel.Anthropometrics.BodyHeight = 1.8; // overwrites the default value
```

### Using legacy `AnyMan.any` files
### Using Legacy `AnyMan.any` Files

To keep backward compatibility with older models, AnyBody still supports using custom `AnyMan.any` files.
You can specify your own file with by setting the `BM_SCALING_ANTHRO_FILE` BM statement:
Expand Down
Loading
Loading