Skip to content
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

closes #35 closes #31 advs vignette #53

Merged
merged 30 commits into from
Jun 28, 2024
Merged

closes #35 closes #31 advs vignette #53

merged 30 commits into from
Jun 28, 2024

Conversation

rossfarrugia
Copy link
Collaborator

@rossfarrugia rossfarrugia commented Jun 17, 2024

NOTE the main part of this PR is to add the new ADVS vignette, but I also added the Get Started guide, updated the logo favicons and made a few other minor tweaks from what we started with from the default admiraltemplate.

Thank you for your Pull Request! We have developed this task checklist from the Development Process Guide to help with the final steps of the process. Completing the below tasks helps to ensure our reviewers can maximize their time on your code as well as making sure the admiral codebase remains robust and consistent.

Please check off each taskbox as an acknowledgment that you completed the task or check off that it is not relevant to your Pull Request. This checklist is part of the Github Action workflows and the Pull Request will not be merged into the main branch until you have checked off each task.

  • Place Closes #<insert_issue_number> into the beginning of your Pull Request Title (Use Edit button in top-right if you need to update)
  • Code is formatted according to the tidyverse style guide. Run styler::style_file() to style R and Rmd files
  • Updated relevant unit tests or have written new unit tests, which should consider realistic data scenarios and edge cases, e.g. empty datasets, errors, boundary cases etc. - See Unit Test Guide
  • If you removed/replaced any function and/or function parameters, did you fully follow the deprecation guidance?
  • Update to all relevant roxygen headers and examples, including keywords and families. Refer to the categorization of functions to tag appropriate keyword/family.
  • Run devtools::document() so all .Rd files in the man folder and the NAMESPACE file in the project root are updated appropriately
  • Address any updates needed for vignettes and/or templates
  • Update NEWS.md under the header # admiralpeds (development version) if the changes pertain to a user-facing function (i.e. it has an @export tag) or documentation aimed at users (rather than developers)
  • Build admiralpeds site pkgdown::build_site() and check that all affected examples are displayed correctly and that all new functions occur on the Reference page.
  • Address or fix all lintr warnings and errors - lintr::lint_package()
  • Run R CMD check locally and address all errors and warnings - devtools::check()
  • Link the issue in the Development Section on the right hand side.
  • Address all merge conflicts and resolve appropriately
  • Pat yourself on the back for a job well done! Much love to your accomplishment!

@rossfarrugia rossfarrugia marked this pull request as draft June 17, 2024 09:17
Copy link

github-actions bot commented Jun 17, 2024

Code Coverage

Package Line Rate Health
admiralpeds 69%
Summary 69% (88 / 128)

@rossfarrugia rossfarrugia changed the title Draft: closes #35 advs vignette closes #35 advs vignette Jun 21, 2024
@rossfarrugia rossfarrugia linked an issue Jun 21, 2024 that may be closed by this pull request
@rossfarrugia rossfarrugia marked this pull request as ready for review June 21, 2024 10:24
@rossfarrugia
Copy link
Collaborator Author

@zdz2101 i noticed that nowhere in the function documentation or the vignette do we explain the formulae used for Z-score and percentile derivations. do you think this should be explained in the function roxygen2 header sections? or we're only going to get this question from users.

@zdz2101
Copy link
Collaborator

zdz2101 commented Jun 21, 2024

@zdz2101 i noticed that nowhere in the function documentation or the vignette do we explain the formulae used for Z-score and percentile derivations. do you think this should be explained in the function roxygen2 header sections? or we're only going to get this question from users.

I'll add it to the documentation using this branch, perhaps we should include it in the vignette as well

@rossfarrugia
Copy link
Collaborator Author

rossfarrugia commented Jun 21, 2024

I'll add it to the documentation using this branch, perhaps we should include it in the vignette as well

yes i was wondering that too, but then i added a reference to the 2 functions used, so my hope was any user would click those links and then read direct from the function pages. but yeh when you come back to review this vignette then see if you think worth to also add something here.

Copy link
Collaborator

@zdz2101 zdz2101 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link
Contributor

@Lina2689 Lina2689 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good!

@rossfarrugia
Copy link
Collaborator Author

@Fanny-Gautier once you're happy with this one i'm happy to merge!
Also anyone else in the team feel free to review.

),
AGE = AGE * 30.4375
)) %>%
# AGEU is added in metadata, required for derive_params_growth_age
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we add the brackets in the comment for the corresponding function derive_params_growth_age() ?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sure, will do

arrange(AGE, SEX)
```

Here is how the combined metadata now looks for the age ranges around 2
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

combined metadata for BMI ? at line 136 we are suddenly talking about HDC

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will try to explain this better to make it clearer 👍

BMI percentiles and z-scores above the 95th percentile, and P95 represents this
sex and age-specific 95th percentile.

Note that the head circumference metadata comes only from the WHO standards,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it's confusing me as we were talking about BMI metadata as an example in this section

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

will clarify

Now we get to the most important section where we show how to create the
new records for each derived pediatrics parameter. Only certain examples
are included here, but you'll find more parameters in the example
template script.
Copy link
Contributor

@Fanny-Gautier Fanny-Gautier Jun 26, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you provide the link or set the shortcut to that section?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok, will add referenced at the bottom of this vignette rather than a link, as people should always use use_ad_template() to get this.

Copy link
Contributor

@Fanny-Gautier Fanny-Gautier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review of the vignette completed: Minor comments regarding the understanding.

@rossfarrugia rossfarrugia changed the title closes #35 advs vignette closes #35 closes #31 advs vignette Jun 28, 2024
@rossfarrugia rossfarrugia linked an issue Jun 28, 2024 that may be closed by this pull request
@rossfarrugia
Copy link
Collaborator Author

@Fanny-Gautier replies and updates made for your review comments - thanks for these! could you take another look today please and if you're happy then we could merge this one.

Copy link
Contributor

@Fanny-Gautier Fanny-Gautier left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No more comments. Thanks for the updates

vignettes/advs.Rmd Show resolved Hide resolved
@rossfarrugia rossfarrugia merged commit 233b480 into main Jun 28, 2024
16 checks passed
@rossfarrugia rossfarrugia deleted the 35_advs_vignette branch June 28, 2024 09:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

ADVS growth parameter vignette WHO metadata add a note on extending beyond 5 years
4 participants