Add documentation for extending the simulation functions

[gowerc]

Closes #323

[github-actions]

Unit Tests Summary

  1 files   42 suites   8m 32s ⏱️
137 tests 106 ✅ 31 💤 0 ❌
928 runs  897 ✅ 31 💤 0 ❌

Results for commit 9aac94f.

♻️ This comment has been updated with latest results.

[github-actions]

Unit Test Performance Difference

Test Suite	$Status$	Time on main	$±Time$	$±Tests$	$±Skipped$	$±Failures$	$±Errors$
Grid	💔	$203.88$	$+10.31$	$0$	$0$	$0$	$0$
GridPrediction	💔	$130.96$	$+3.14$	$0$	$0$	$0$	$0$
SurvivalQuantities	💔	$48.04$	$+2.14$	$0$	$0$	$0$	$0$

Additional test case details

Test Suite	$Status$	Time on main	$±Time$	Test Case
Grid	💔	$29.47$	$+1.61$	GridFixed_bug_has_been_fixed
Grid	💔	$76.66$	$+3.87$	GridObservered_Constructs_correct_quantities
Grid	💔	$38.02$	$+2.81$	GridPopulation_works_as_expected_for_GSF_models
Grid	💔	$29.02$	$+1.68$	GridPopulation_works_as_expected_for_Longitudinal_models
GridPrediction	💔	$106.38$	$+3.00$	GridPrediction_works_as_expected_for_Survival_models
SurvivalQuantities	💔	$39.52$	$+1.92$	SurvivalQuantities_and_autoplot.SurvivalQuantities_works_as_expected

Results for commit bc10bdb

♻️ This comment has been updated with latest results.

[github-actions]

Code Coverage Summary

Filename                           Stmts    Miss  Cover    Missing
-------------------------------  -------  ------  -------  --------------------------------
R/brier_score.R                      166       0  100.00%
R/DataJoint.R                         76       2  97.37%   264, 270
R/DataLongitudinal.R                 119       1  99.16%   244
R/DataSubject.R                       85       1  98.82%   142
R/DataSurvival.R                      98       0  100.00%
R/defaults.R                          10       6  40.00%   18-57, 84
R/generics.R                          30       3  90.00%   51, 394, 444
R/Grid.R                              27       1  96.30%   170
R/GridEven.R                          32       0  100.00%
R/GridFixed.R                         30       0  100.00%
R/GridGrouped.R                       52       0  100.00%
R/GridManual.R                        23       3  86.96%   78-80
R/GridObserved.R                      20       0  100.00%
R/GridPopulation.R                    31       4  87.10%   61, 69-71
R/GridPrediction.R                    36       6  83.33%   83, 91-95
R/JointModel.R                       123       8  93.50%   141-143, 193, 197, 239, 285, 291
R/JointModelSamples.R                 59       0  100.00%
R/link_generics.R                     10       2  80.00%   59, 76
R/Link.R                              62       4  93.55%   200-203
R/LinkComponent.R                     19       3  84.21%   88, 120-121
R/LongitudinalGSF.R                   77       0  100.00%
R/LongitudinalModel.R                 19       0  100.00%
R/LongitudinalQuantities.R            71       0  100.00%
R/LongitudinalRandomSlope.R           36       0  100.00%
R/LongitudinalSteinFojo.R             70       5  92.86%   143-147
R/Parameter.R                         14       0  100.00%
R/ParameterList.R                     42       1  97.62%   184
R/Prior.R                            236       8  96.61%   480, 576, 588-606
R/Promise.R                           25       0  100.00%
R/Quantities.R                        60       0  100.00%
R/QuantityGeneratorPopulation.R       22       0  100.00%
R/QuantityGeneratorPrediction.R       48       0  100.00%
R/QuantityGeneratorSubject.R          19       0  100.00%
R/settings.R                          12      12  0.00%    55-69
R/SimGroup.R                           5       0  100.00%
R/SimJointData.R                      72       1  98.61%   103
R/SimLongitudinal.R                    5       2  60.00%   22, 40
R/SimLongitudinalGSF.R                51       0  100.00%
R/SimLongitudinalRandomSlope.R        42       0  100.00%
R/SimLongitudinalSteinFojo.R          48       0  100.00%
R/SimSurvival.R                      104       0  100.00%
R/StanModel.R                         15       0  100.00%
R/StanModule.R                       176       6  96.59%   192-193, 235, 246, 383, 411
R/SurvivalExponential.R               10       0  100.00%
R/SurvivalLoglogistic.R               11       0  100.00%
R/SurvivalModel.R                     19       0  100.00%
R/SurvivalQuantities.R               170       1  99.41%   125
R/SurvivalWeibullPH.R                 11       0  100.00%
R/utilities.R                        143       1  99.30%   13
R/zzz.R                               28      25  10.71%   3, 8-12, 14-35, 47
TOTAL                               2769     106  96.17%

Diff against main

Filename      Stmts    Miss  Cover
----------  -------  ------  --------
TOTAL             0       0  +100.00%

Results for commit: 9aac94f

Minimum allowed coverage is 80%

♻️ This comment has been updated with latest results

[gowerc]

@danielinteractive - I updated in line with our conversation to try and provide more details of how the simulated values are sampled. I also linked to a development issue that aims to hopefully simplify the implementation at a later date. Let me know if you think this is any better or not...

[danielinteractive]

thanks @gowerc , looks good