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

Inherit common SSplot Parameters #94

Merged
merged 30 commits into from
Jul 31, 2023
Merged

Inherit common SSplot Parameters #94

merged 30 commits into from
Jul 31, 2023

Conversation

efletcherPIFSC
Copy link
Collaborator

Created generic functions SSplotGeneric , SSplotGenericLegend, SSplotGenericPar, SSplotGenericUncertianty to re-use common parameter documentation that ss3diags SSplot functions, via use roxygen tag@inheritParams. Resolves #2.

Implementation of SSplotGenericPar resolves #66.

In addition:

  • Included markdown notation to SSplot roxygen code documentation
  • Added links to other functions such as r4ss::SS_Summarize, and replaced "TRUE/FALSE" with link to base::Logical
  • Values in subplots, indexfleets, and punits are listed in a bulleted list
  • Typo fixes

@efletcherPIFSC efletcherPIFSC added documentation Improvements or additions to documentation topic: ss-plots Relating to ssplot functions derived from r4ss labels Jul 25, 2023
@efletcherPIFSC efletcherPIFSC added this to the Documentation milestone Jul 25, 2023
@efletcherPIFSC
Copy link
Collaborator Author

@MOshima-PIFSC
Is the item description listed in the subplots parameter accurate for:

  • SSPlotModelComp
  • SSplotEnsemble
  • SSplotHCxval
  • SSplotJABBAres
  • SSplotRetro
  • SSplotRunsTest

#' @param kb `kb` type output created by `SSdeltaMVLN()`
#' @param subplots vector to create subplots with these options:
#' \itemize{
#' \item `"stock"` Fish Population
Copy link
Contributor

Choose a reason for hiding this comment

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

I would say stock is 'Stock biomass relative to reference point (B/BMSY)' and harvest 'Harvest rate relative to reference point (F/FMSY)'

R/SSplotHCxval.R Outdated
#' \itemize{
#' \item `"cpue"` Index data
#' \item `"len"` Length composition data
#' \item `"age"` Age composition data (yet to be tested)
Copy link
Contributor

Choose a reason for hiding this comment

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

Age composition data has been tested and works, can remove the 'yet to be tested'

Copy link
Contributor

@MOshima-PIFSC MOshima-PIFSC left a comment

Choose a reason for hiding this comment

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

Hey @efletcherPIFSC I looked over the subplots descriptions. They look good, I just added a few comments/suggestions to them. Also, I noted it in SSplotRunstest.R but any of the functions that have a quants argument, the same type of bulleted list can be used for those as well.

R/SSplotHCxval.R Outdated Show resolved Hide resolved
R/SSplotHCxval.R Outdated Show resolved Hide resolved
R/SSplotJABBAres.R Outdated Show resolved Hide resolved
R/SSplotModelcomp.R Outdated Show resolved Hide resolved
R/SSplotModelcomp.R Outdated Show resolved Hide resolved
R/SSplotRunstest.R Outdated Show resolved Hide resolved
R/SSplotRunstest.R Show resolved Hide resolved
R/SSplotRunstest.R Outdated Show resolved Hide resolved
R/SSplotRunstest.R Show resolved Hide resolved
R/SSplotRunstest.R Outdated Show resolved Hide resolved
@efletcherPIFSC
Copy link
Collaborator Author

@MOshima-PIFSC Didn't resolve any git code conflicts. Hence the dirty git conflict code. Fixing that.

Copy link
Contributor

@MOshima-PIFSC MOshima-PIFSC left a comment

Choose a reason for hiding this comment

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

all changes look good. I approve the merge

@MOshima-PIFSC MOshima-PIFSC merged commit 80ba04a into main Jul 31, 2023
@efletcherPIFSC efletcherPIFSC deleted the feat-roxygen-params branch August 3, 2023 18:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation topic: ss-plots Relating to ssplot functions derived from r4ss
Projects
None yet
Development

Successfully merging this pull request may close these issues.

ssplots: refactor "par" parameter to "mar"/plot-margin parameter Create template functions
2 participants