Documentation of demography plots - Demography settings

[AnnikaRPS]

In the documentation of the demography plots of the RE 2.2.0 (https://www.open-systems-pharmacology.org/OSPSuite.ReportingEngine/dev/articles/demography.html#demography-settings), the last section describes the "Demography settings". I think it would really help to have some example plots here to understand these settings.

[pchelle]

@AnnikaRPS
The examples were updated with a more appropriate model (Aciclovir) and populations (created using ospsuite::createPopulationCharacteristics()) and some of the bugs you noticed (stairstep not straight) were fixed

Could you review the updated version (same link https://www.open-systems-pharmacology.org/OSPSuite.ReportingEngine/dev/articles/demography.html) and let me know if there a still things not accounted for by the documentation ?

[AnnikaRPS]

@pchelle
I reviewed the documentation some weeks ago and Juri already added some of the issues. Here is some more feedback for the documentation itself (sorry if you already implemented parts of it - I might have missed the changes then):

In General:

• I personally would not use a pediatric population as a case ecample for the non-pediatric workflows. I think a diseased population or anything else would be more appropriate.
• The number of observed children is very low with n=3 which makes expescially the range plots weird. I would suggest to use some more individuals.
  -For boxplots it often says "profile" in the figure caption. I wouöld replace that with "boxes", "Data" or anything else but would use "profile" only for the conc-time-profiles.

Parallel and ratio comparison workflows:

• I don't understand the "not displayed by displayed" part: (it is in the histogram section)
  

• In the range plot section, the bracket around "number 1088" is not close:
  

• In the code of the range plot section, the variable "displayedPartameters" is not defined:
  

• In many figure captions there are two dots e.g.:
  

• In some figure captions there is a dot between "scale" and "shwon" e.g.:
  

Pediatric workflow:

• I would include the differentiation in typical age groups (pre-school, infant etc) for the pediatric example and not just one population
  -In histograms for children I would not include the adult reference population ( at least not as a default) since the adult demographics might make the smaller numbers for children unreadable / undistingusheable, and is probably not of interest anyway in many cases.

Demography Settings:

• There is a "by" missing after "not affected":
  

• When you set "dodge" to "FALSE" which setting will then be used?
  

Hope that helps. Let me know if anything is unclear or if you think something is unreasonable.