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

Deprecating groupCol and blockCol #62

Closed
wants to merge 19 commits into from
Closed

Deprecating groupCol and blockCol #62

wants to merge 19 commits into from

Conversation

asyakhl
Copy link
Collaborator

@asyakhl asyakhl commented Sep 14, 2024

Replacing groupCol and blockCol with classCol and subclassCol, and other group and block variable names. Also updated man files.

@shbrief
Copy link
Contributor

shbrief commented Sep 14, 2024

This pull request seems to include only the new argument names but doesn't have a deprecation process. I found this guide (https://contributions.bioconductor.org/deprecation.html) on function and dataset-level deprecations. @LiNk-NY Do you know whether there is a separate instruction on argument-level deprecations?

@lwaldron lwaldron marked this pull request as draft September 15, 2024 23:55
Copy link
Contributor

@LiNk-NY LiNk-NY left a comment

Choose a reason for hiding this comment

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

  • Update the main lefser function to deprecate the arguments similar to the expr argument.
  • Remove redundant text from documentation

@@ -31,7 +31,7 @@ The original software utilizes standard statistical significance tests along
with supplementary tests that incorporate biological consistency and the
relevance of effects to identity the features (e.g., organisms, clades, OTU,
genes, or functions) that are most likely to account for differences between
the two sample groups of interest, referred as ‘classes’. While *LEfSe* is
the two sample classes of interest, referred as ‘classes’. While *LEfSe* is
Copy link
Contributor

Choose a reason for hiding this comment

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

This is redundant

R/lefser.R Outdated
attr(res_scores, "grp") <- groupCol
attr(res_scores, "blk") <- blockCol
attr(res_scores, "grp") <- classCol
attr(res_scores, "blk") <- subclassCol
Copy link
Contributor

Choose a reason for hiding this comment

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

These attribute names should also change

groupCol = "GROUP",
blockCol = NULL,
classCol = "CLASS",
subclassCol = NULL,
Copy link
Contributor

Choose a reason for hiding this comment

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

The lefser function shoul dkeep the groupCol and blockCol in the function signature. They should go after the ... similarly to expr.

Copy link
Contributor

Choose a reason for hiding this comment

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

@asyakhl
As Sehyun mentioned, there should be a warning for anyone who sets groupCol and blockCol arguments (e.g., if (!missing(groupCol) || !missing(blockCol)) )

@LiNk-NY
Copy link
Contributor

LiNk-NY commented Sep 16, 2024

ping @asyakhl

Copy link
Contributor

@LiNk-NY LiNk-NY left a comment

Choose a reason for hiding this comment

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

Please update lefsePlotFeat.R to changes

attr(res_scores, "grp") <- classCol
attr(res_scores, "blk") <- subclassCol
attr(res_scores, "class") <- classCol
attr(res_scores, "subclass") <- subclassCol
Copy link
Contributor

Choose a reason for hiding this comment

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

@asyakhl Were these updated in lefsePlotFeat.R ?

Copy link
Contributor

Choose a reason for hiding this comment

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

@asyakhl You should .Deprecated the old arguments as expr.

@asyakhl asyakhl marked this pull request as ready for review September 23, 2024 00:52
Copy link
Contributor

@LiNk-NY LiNk-NY left a comment

Choose a reason for hiding this comment

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

Thanks Asya! @asyakhl
Other than the man/lefserPlotFeat.Rd, everything looks in order :)
I think the merge commits got a little bit messy.
For next time, use rebase often to pull changes from devel and to keep a linear history.

Please add Ludwig back to the DESCRIPTION file. Thanks!

groupCol = "GROUP",
blockCol = NULL,
classCol = "CLASS",
subclassCol = NULL,
Copy link
Contributor

Choose a reason for hiding this comment

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

@asyakhl
As Sehyun mentioned, there should be a warning for anyone who sets groupCol and blockCol arguments (e.g., if (!missing(groupCol) || !missing(blockCol)) )

DESCRIPTION Outdated
person("Samuel", "Gamboa-Tuz", , "Samuel.Gamboa.Tuz@gmail.com", "ctb"),
person("Ludwig", "Geistlinger", , "Ludwig.Geistlinger@sph.cuny.edu", "ctb", c(ORCID = "0000-0002-2495-5464")),
Copy link
Contributor

Choose a reason for hiding this comment

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

@asyakhl Why is this being removed?

Copy link
Contributor

Choose a reason for hiding this comment

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

Sorry... I was cleaning up to reflect the contributions to the repo and accidentally deleted the line. I'll put it back.

Copy link
Contributor

Choose a reason for hiding this comment

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

This is out of scope of the PR

Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe incorporated during rebase?

#' res_subclass <- lefser(zeller14tn_ra,
#' classCol = "study_condition",
#' subclassCol = "age_category")
#' plot_class <- lefsePlotFeat(res_class, res_class$features[[1]])
Copy link
Contributor

Choose a reason for hiding this comment

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

@asyakhl The correct function name is lefserPlotFeat, not lefsePlotFeat

@LiNk-NY
Copy link
Contributor

LiNk-NY commented Sep 25, 2024

Thanks Asya! @asyakhl
I squashed the commits and added a couple of changes at #65. I keep your authorship with Co-authored-by: <...> tag.

@shbrief shbrief closed this in 5d4e2e2 Sep 25, 2024
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.

3 participants