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

Update documentation #81

Merged
merged 8 commits into from
Sep 14, 2023
Merged

Conversation

noriakis
Copy link
Contributor

Hello, I have updated the documentation of tidySummarizedExperiment to be consistent with tidyseurat and tidySingleCellExperiment. Currently, R CMD CHECK runs without errors, warnings, or notes.

  • utilities.R has not been touched for formatting unless it needs to be changed to avoid errors, as it has already been edited.
  • se object initialization has been added to unite, separate, extract to avoid R CMD CHECK NOTEs.

I would be grateful if you could review the changes.

noriakis and others added 5 commits August 27, 2023 16:42
- comments in slice example are preserved
data.R
ggplot2_methods.R
methods.R
plotly_methods.R
print_method.R
cleaning R CMD CHECK
Comment on lines -474 to +475
nest(data___ = c(!!s_(se)$symbol, !!f_(se)$symbol, value)) %>%
nest(data___ = c(!!s_(se)$symbol, !!f_(se)$symbol, .data$value)) %>%
Copy link
Owner

Choose a reason for hiding this comment

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

the tidy evaluation works without the .data$ Any specific reason you add all those?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thank you for the review. The inclusion of .data$ was intended to address the NOTEs raised by R CMD CHECK regarding undefined global variables. If necessary, I can revert these changes.

@stemangiola
Copy link
Owner

@noriakis please have a look to the github actions

@noriakis
Copy link
Contributor Author

noriakis commented Sep 7, 2023

Thank you for the review. For GiHub actions, I am currently looking for a way to resolve WARNINGs. On R 4.3.1, the rcmdcheck runs without problems. However, on R 4.2.2, the same warnings as for GitHub actions appear in my environment.

  • 4.2.2
── R CMD check results ────────────────────────────────────────────────────────────────── tidySummarizedExperiment 1.11.4 ────
Duration: 4m 33.5s

❯ checking whether package 'tidySummarizedExperiment' can be installed ... WARNING
  See below...

❯ checking S3 generic/method consistency ... WARNING
  Warning: declared S3 method 'count.SummarizedExperiment' not found
  Warning: declared S3 method 'filter.SummarizedExperiment' not found
  Warning: declared S3 method 'rename.SummarizedExperiment' not found
  Warning: declared S3 method 'slice.SummarizedExperiment' not found
  See section 'Generic functions and methods' in the 'Writing R
  Extensions' manual.

0 errors ✔ | 2 warnings ✖ | 0 notes ✔
  • 4.3.1
── R CMD check results ──────────────────── tidySummarizedExperiment 1.11.4 ────
Duration: 5m 10.7s

0 errors ✔ | 0 warnings ✔ | 0 notes ✔

@stemangiola
Copy link
Owner

@HelenaLC maybe knows how to solve this mystery

NAMESPACE Outdated
Comment on lines 40 to 42
export(bind_cols.RangedSummarizedExperiment)
export(bind_cols.SummarizedExperiment)
export(bind_rows.SummarizedExperiment)
Copy link
Owner

Choose a reason for hiding this comment

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

Please have a look, if these are present in tidySingleCellExperiment as well, because they look a bit strange

Copy link
Owner

Choose a reason for hiding this comment

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

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Hello, thank you very much for the prompt reply. I apologize for the commit without the comment.

The warnings above (count, filter, rename, slice) were solved by moving dplyr to Depends (https://stat.ethz.ch/pipermail/r-devel/2014-June/069247.html), however, in that way, the other warnings that methods lookup cannot find bind_cols and bind_rows occurred as below. The additional @export was the intention to avoid these warnings.

W  checking S3 generic/method consistency (5.7s)
   Warning: declared S3 method 'bind_cols.RangedSummarizedExperiment' not found
   Warning: declared S3 method 'bind_cols.SummarizedExperiment' not found
   Warning: declared S3 method 'bind_rows.SummarizedExperiment' not found
   See section 'Generic functions and methods' in the 'Writing R
   Extensions' manual.

tidyseurat also has these warnings when checked in R 4.2.3, and tidySingleCellExperiment also has them as below if I explicitly change R version dependency and check in R 4.2.3, although these warnings will not occur as tidySingleCellExperiment depends on R >= 4.3.0.

W  checking S3 generic/method consistency (7.5s)
   Warning: declared S3 method 'bind_cols.SingleCellExperiment' not found
   Warning: declared S3 method 'bind_rows.SingleCellExperiment' not found
   See section 'Generic functions and methods' in the 'Writing R
   Extensions' manual.

Copy link
Owner

Choose a reason for hiding this comment

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

I would say, let's depend on anything tidySCE depends on, and let's set up the github action from tidySCE template.

Basically whatever tidySCE does we do as well.

Copy link
Contributor Author

@noriakis noriakis Sep 14, 2023

Choose a reason for hiding this comment

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

I apologize that no checks have been made on BiocCheck in this PR. Will remove at least errors.

Copy link
Owner

Choose a reason for hiding this comment

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

You can check the package locally and then push it. We are getting close!

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Thanks! Just added a runnable example in plotly.Rd. The commit locally passed BiocCheck (in 3.18) without errors (warnings and notes remained, also in tidySCE). R CMD CHECK (version 4.3.1) also passes without errors, warnings, and notes, which should pass GitHub actions.

@stemangiola
Copy link
Owner

Congrats! Well done, and thanks! If you feel to contribute more there are so many possibilities.

@stemangiola stemangiola merged commit dcfb940 into stemangiola:master Sep 14, 2023
4 checks passed
@noriakis
Copy link
Contributor Author

Thank you very much for approving the PR and for your guidance! Will update the tidyseurat workflow shortly to be in line with tidySCE.

@stemangiola
Copy link
Owner

Thank you very much for approving the PR and for your guidance! Will update the tidyseurat workflow shortly to be in line with tidySCE.

If I'm not wrong, tidyseurat documentation has been fixed already. What do you mean by workflow?

I tagged you in a Documentation tidybulk issue, to provide guidance.

@stemangiola stemangiola mentioned this pull request Sep 18, 2023
@noriakis
Copy link
Contributor Author

Sorry for the delay in response and for the unclear description. I meant to say the update of GitHub Actions workflow to be compatible with tidySCE one as I did in tidySE, which includes the checks in the R version 4.3 and the latest BiocCheck (3.18). If needed, I will proceed.

Also, thank you for mentioning in tidybulk, I will check and update the answer shortly.

@stemangiola
Copy link
Owner

Yes

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.

Improve the documentation of tidytranscriptomics adapters, tidySE, tidySCE, tidySPE, tidyseurat
2 participants