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

BayesSpace #1624

Closed
8 tasks done
msto opened this issue Sep 6, 2020 · 20 comments
Closed
8 tasks done

BayesSpace #1624

msto opened this issue Sep 6, 2020 · 20 comments
Assignees
Labels
3a. accepted will be ingested into Bioconductor daily builder for distribution

Comments

@msto
Copy link

msto commented Sep 6, 2020

Update the following URL to point to the GitHub repository of
the package you wish to submit to Bioconductor

Confirm the following by editing each check box to '[x]'

  • I understand that by submitting my package to Bioconductor,
    the package source and all review commentary are visible to the
    general public.

  • I have read the Bioconductor Package Submission
    instructions. My package is consistent with the Bioconductor
    Package Guidelines.

  • I understand that a minimum requirement for package acceptance
    is to pass R CMD check and R CMD BiocCheck with no ERROR or WARNINGS.
    Passing these checks does not result in automatic acceptance. The
    package will then undergo a formal review and recommendations for
    acceptance regarding other Bioconductor standards will be addressed.

  • My package addresses statistical or bioinformatic issues related
    to the analysis and comprehension of high throughput genomic data.

  • I am committed to the long-term maintenance of my package. This
    includes monitoring the support site for issues that users may
    have, subscribing to the bioc-devel mailing list to stay aware
    of developments in the Bioconductor community, responding promptly
    to requests for updates from the Core team in response to changes in
    R or underlying software.

I am familiar with the essential aspects of Bioconductor software
management, including:

  • The 'devel' branch for new packages and features.
  • The stable 'release' branch, made available every six
    months, for bug fixes.
  • Bioconductor version control using Git
    (optionally via GitHub).

For help with submitting your package, please subscribe and post questions
to the bioc-devel mailing list.

@bioc-issue-bot
Copy link
Collaborator

Hi @msto

Thanks for submitting your package. We are taking a quick
look at it and you will hear back from us soon.

The DESCRIPTION file for this package is:

Package: BayesSpace
Version: 0.99.0
Date: 2020-09-04
Title: Clustering and Resolution Enhancement of Spatial Transcriptomes
Authors@R: c(
    person("Edward", "Zhao", role=c("aut"), email="[email protected]"),
    person("Matt", "Stone", role=c("aut", "cre"), email="[email protected]"),
    person("Xing", "Ren", role=c("ctb"), email="[email protected]"),
    person("Raphael", "Gottardo", role=c("ctb"), email="[email protected]"))
Maintainer:
    Matt Stone <[email protected]>
Description: Tools for clustering and enhancing the resolution of spatial gene
    expression experiments. BayesSpace clusters a low-dimensional representation
    of the gene expression matrix, incorporating a spatial prior to encourage
    neighboring spots to cluster together. The method can enhance the resolution
    of the low-dimensional representation into "sub-spots", for which features
    such as gene expression or cell type composition can be imputed.
Depends:
    R (>= 4.0.0),
    SingleCellExperiment
Imports:
    Rcpp (>= 1.0.4.6),
    stats,
    BiocSingular,
    purrr,
    scater,
    scran,
    SummarizedExperiment,
    coda,
    rhdf5,
    S4Vectors,
    Matrix,
    assertthat,
    mclust,
    RCurl,
    DirichletReg,
    xgboost,
    utils,
    ggplot2,
    scales
License: MIT + file LICENSE
RoxygenNote: 7.1.0
LinkingTo: 
    Rcpp,
    RcppArmadillo,
    RcppDist,
    RcppProgress
NeedsCompilation: yes
SystemRequirements: C++11
Encoding: UTF-8
Suggests: 
    testthat,
    knitr,
    rmarkdown,
    patchwork,
    igraph
VignetteBuilder: knitr
biocViews:
    Software,
    Clustering,
    Transcriptomics,
    GeneExpression,
    SingleCell,
    ImmunoOncology,
    DataImport
BugReports: https://github.com/edward130603/BayesSpace/issues
URL: edward130603.github.io/BayesSpace



@bioc-issue-bot bioc-issue-bot added the 1. awaiting moderation submitted and waiting clearance to access resources label Sep 6, 2020
@bioc-issue-bot
Copy link
Collaborator

A reviewer has been assigned to your package. Learn what to expect
during the review process.

IMPORTANT: Please read this documentation for setting
up remotes to push to git.bioconductor.org. It is required to push a
version bump to git.bioconductor.org to trigger a new build.

Bioconductor utilized your github ssh-keys for git.bioconductor.org
access. To manage keys and future access you may want to active your
Bioconductor Git Credentials Account

@bioc-issue-bot bioc-issue-bot added 2. review in progress assign a reviewer and a more thorough review of package code and documentation taking place and removed 1. awaiting moderation submitted and waiting clearance to access resources labels Sep 8, 2020
@bioc-issue-bot
Copy link
Collaborator

Dear Package contributor,

This is the automated single package builder at bioconductor.org.

Your package has been built on Linux, Mac, and Windows.

On one or more platforms, the build results were: "ERROR".
This may mean there is a problem with the package that you need to fix.
Or it may mean that there is a problem with the build system itself.

Please see the build report for more details. This link will be active
for 21 days.

Remember: if you submitted your package after July 7th, 2020,
when making changes to your repository push to
[email protected]:packages/BayesSpace to trigger a new build.
A quick tutorial for setting up remotes and pushing to upstream can be found here.

@bioc-issue-bot
Copy link
Collaborator

Received a valid push on git.bioconductor.org; starting a build for commit id: b03c4210d1550fb25656189988d67eae77e8949d

@bioc-issue-bot
Copy link
Collaborator

Dear Package contributor,

This is the automated single package builder at bioconductor.org.

Your package has been built on Linux, Mac, and Windows.

On one or more platforms, the build results were: "ERROR".
This may mean there is a problem with the package that you need to fix.
Or it may mean that there is a problem with the build system itself.

Please see the build report for more details. This link will be active
for 21 days.

Remember: if you submitted your package after July 7th, 2020,
when making changes to your repository push to
[email protected]:packages/BayesSpace to trigger a new build.
A quick tutorial for setting up remotes and pushing to upstream can be found here.

@msto
Copy link
Author

msto commented Sep 8, 2020

Hi @mtmorgan,

I've removed the Maintainer: field and subscribed to bioc-devel to address the BiocCheckGitClone and BiocCheck errors.

I'm a bit confused about the remaining issues under macOS.

On the first build, the error was regarding linking to fortran on macOS. I previously encountered a similar issue on my own macbook, and the best solution I was able to find was to install gfortran directly rather than through homebrew. I do have a note in the README suggesting this as a fix, but I'm very open to suggestions for a better solution.

However, on the second build, despite only updating the DESCRIPTION, I no longer receive the same error. Instead, for the check I receive errors that the package is not installable, and the binary build fails because the system cannot find edgeR (an indirect dependency via scran). I'm guessing that the failure to install the package in the CHECK is related to this problem, but I'm not able to replicate it locally. Should I explicitly add edgeR as an import, or do you have another suggestion to fix?

This package does build without issues and pass check/BiocCheck under macOS on the docker image provided in the (semi?)official github action so these should be surmountable problems; unfortunately I'm not familar with the differences between that image and merida1.

Thanks!

@bioc-issue-bot
Copy link
Collaborator

Received a valid push on git.bioconductor.org; starting a build for commit id: ab3372944da45ae3e3fadabd1ee1eb018d97a7d1

@bioc-issue-bot
Copy link
Collaborator

Dear Package contributor,

This is the automated single package builder at bioconductor.org.

Your package has been built on Linux, Mac, and Windows.

Congratulations! The package built without errors or warnings
on all platforms.

Please see the build report for more details. This link will be active
for 21 days.

Remember: if you submitted your package after July 7th, 2020,
when making changes to your repository push to
[email protected]:packages/BayesSpace to trigger a new build.
A quick tutorial for setting up remotes and pushing to upstream can be found here.

@bioc-issue-bot bioc-issue-bot added OK and removed ERROR labels Sep 9, 2020
@bioc-issue-bot
Copy link
Collaborator

Dear Package contributor,

This is the automated single package builder at bioconductor.org.

Your package has been built on Linux, Mac, and Windows.

Congratulations! The package built without errors or warnings
on all platforms.

Please see the build report for more details. This link will be active
for 21 days.

Remember: if you submitted your package after July 7th, 2020,
when making changes to your repository push to
[email protected]:packages/BayesSpace to trigger a new build.
A quick tutorial for setting up remotes and pushing to upstream can be found here.

@msto
Copy link
Author

msto commented Sep 9, 2020

Hi @mtmorgan,

The errors appear to have been due to an issue with the Bioconductor build system that Lori Shepherd very helpfully fixed this morning, and the package now builds without error. Please let me know any updates to the package you would suggest when you have time to review.

Thank you!

Matt

@mtmorgan
Copy link
Contributor

mtmorgan commented Oct 3, 2020

Sorry for my slow response

DESCRIPTION

  • good

vignettes

  • IMPORTANT the code chunks in *.Rmd are not evaluated, enclose the r in braces {r}. Evaluated code chunks are an important part of effective documentation

  • do the *bak / *orig and precomile.Rfiles belong in git / at this location?

  • From a quick reading, the vignettes would benefit from brief paragraphps interpretting the result of each (or most) code chunks

R (comments on specific lines of code apply throughout)

  • Address TODO: in BayesSpace.R

  • enhancedFeatures.R:74 use a single warning() statement, perhaps with strwrap() to format output

  • readVisium.R:40 stop() calls paste0() internally (use of message(sprintf()) can also often be similarly avoided, so it is usually sufficient to write

    stop("Matrix directory does not exist: ", matrix_dir)
    

    Writing the conditional block on the same line as the conditional leads to long an difficult to read code; follwo the standard convention of writing the body of the conditional on a separate line.

  • utils.R:283 caching of internet downloads are relatively easy using BiocFileCache; see the vignette http://bioconductor.org/packages/devel/bioc/vignettes/BiocFileCache/inst/doc/BiocFileCache.html#local-cache-of-an-internet-resource

@bioc-issue-bot
Copy link
Collaborator

Received a valid push on git.bioconductor.org; starting a build for commit id: 1fb257b7528e44a8bd4338763a54d49764547fb7

@msto
Copy link
Author

msto commented Oct 13, 2020

Hi @mtmorgan,

No worries, thanks for the review!

Description

Thanks!

Vignettes

I had been pre-building some vignettes that were too computationally expensive to expect the user to build during installation. (The *.Rmd.orig files were the raw vignettes, and the precompile.R script knit them into Rmarkdown files where the chunks wouldn't be evaluated.) After getting some helpful feedback in the bioc-community slack, I've removed these vignettes from the package and have made them available on the package's website instead. I think they are helpful, as they reproduce the figures in the accompanying manuscript, but are not necessary to include with the package.

I have updated the remaining vignette so it is evaluated and built upon installation. This vignette demonstrates usage of all exported function in the package.

R

  • Address TODO: in BayesSpace.R
    All TODOs have been addressed, removed as deprecated, or deferred for a later release.
  • enhancedFeatures.R:74 use a single warning() statement, perhaps with strwrap() to format output
    This has been fixed.
  • readVisium.R:40 stop() calls paste0() internally (use of message(sprintf()) can also often be similarly avoided, so it is usually sufficient to write
    All stop(), warning(), and message() statements now avoid use of paste() or paste0().
  • Writing the conditional block on the same line as the conditional leads to long an difficult to read code; follwo the standard convention of writing the body of the conditional on a separate line.
    All inline conditionals have been replaced, either by placing the body on a separate line or with ifelse(). (The latter is only used to set default values where appropriate).
  • utils.R:283 caching of internet downloads are relatively easy using BiocFileCache; see the vignette
    Thank you very much for this suggestion! This was exactly what I hoped to accomplish and it was very easy to implement.

Please let me know if there are any further updates you'd like us to make to the package prior to acceptance. Thank you!

@bioc-issue-bot
Copy link
Collaborator

Dear Package contributor,

This is the automated single package builder at bioconductor.org.

Your package has been built on Linux, Mac, and Windows.

On one or more platforms, the build results were: "WARNINGS".
This may mean there is a problem with the package that you need to fix.
Or it may mean that there is a problem with the build system itself.

Please see the build report for more details. This link will be active
for 21 days.

Remember: if you submitted your package after July 7th, 2020,
when making changes to your repository push to
[email protected]:packages/BayesSpace to trigger a new build.
A quick tutorial for setting up remotes and pushing to upstream can be found here.

@bioc-issue-bot
Copy link
Collaborator

Received a valid push on git.bioconductor.org; starting a build for commit id: 46203fa1509ad00c5f75ea9bdf43595e5280905d

@bioc-issue-bot
Copy link
Collaborator

Dear Package contributor,

This is the automated single package builder at bioconductor.org.

Your package has been built on Linux, Mac, and Windows.

Congratulations! The package built without errors or warnings
on all platforms.

Please see the build report for more details. This link will be active
for 21 days.

Remember: if you submitted your package after July 7th, 2020,
when making changes to your repository push to
[email protected]:packages/BayesSpace to trigger a new build.
A quick tutorial for setting up remotes and pushing to upstream can be found here.

@msto
Copy link
Author

msto commented Oct 13, 2020

The warning on the previous build was due to R CMD check exceeding the 10 minute runtime limit. I reduced the number of MCMC iterations used in the documentation examples and it now runs in under the limit.

@mtmorgan mtmorgan removed the 2. review in progress assign a reviewer and a more thorough review of package code and documentation taking place label Oct 13, 2020
@mtmorgan mtmorgan added 3a. accepted will be ingested into Bioconductor daily builder for distribution and removed OK labels Oct 13, 2020
@bioc-issue-bot
Copy link
Collaborator

Your package has been accepted. It will be added to the
Bioconductor nightly builds.

Thank you for contributing to Bioconductor!

@mtmorgan
Copy link
Contributor

The master branch of your GitHub repository has been added to Bioconductor's git repository.

To use the git.bioconductor.org repository, we need an 'ssh' key to associate with your github user name. If your GitHub account already has ssh public keys (https://github.com/msto.keys is not empty), then no further steps are required. Otherwise, do the following:

  1. Add an SSH key to your github account
  2. Submit your SSH key to Bioconductor

See further instructions at

https://bioconductor.org/developers/how-to/git/

for working with this repository. See especially

https://bioconductor.org/developers/how-to/git/new-package-workflow/
https://bioconductor.org/developers/how-to/git/sync-existing-repositories/

to keep your GitHub and Bioconductor repositories in sync.

Your package will be included in the next nigthly 'devel' build (check-out from git at about 6 pm Eastern; build completion around 2pm Eastern the next day) at

https://bioconductor.org/checkResults/

(Builds sometimes fail, so ensure that the date stamps on the main landing page are consistent with the addition of your package). Once the package builds successfully, you package will be available for download in the 'Devel' version of Bioconductor using BiocManager::install("BayesSpace"). The package 'landing page' will be created at

https://bioconductor.org/packages/BayesSpace

If you have any questions, please contact the bioc-devel mailing list (https://stat.ethz.ch/mailman/listinfo/bioc-devel); this issue will not be monitored further.

@msto
Copy link
Author

msto commented Oct 14, 2020

Great, thank you Martin!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
3a. accepted will be ingested into Bioconductor daily builder for distribution
Projects
None yet
Development

No branches or pull requests

3 participants