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

Improve Docker images usability #249

Merged
merged 4 commits into from
Mar 14, 2024
Merged

Improve Docker images usability #249

merged 4 commits into from
Mar 14, 2024

Conversation

njmei
Copy link
Contributor

@njmei njmei commented Mar 10, 2024

This PR was originally intended to address: #238

But it turns out that the issue was with an upstream dependency (scvi-tools) that has since resolved the problem. So, I spent a bit of time further polishing the Docker images and guide and really making sure that the notebooks (especially the annotations.ipynb) work now.

Link to preview updated SnapATAC2 /docker README: https://github.com/njmei/SnapATAC2/tree/address-docker-issues/docker#snapatac2-dockerfiles

Highlights:

  • Guide includes how to utilize GPU. I've verified that the example annotations.ipynb can make use of a GPU:
  • Guide has been updated to show how to mount a data directory on the local machine and have SnapATAC save or load from it
  • Added sections to the guide for how to run the Docker image on other platforms (Windows/MacOS)

Question:
I was looking to see if SnapATAC2 is now publishing Docker images for various new version releases, but I'm not seeing up to date images at: https://hub.docker.com/r/kaizhang/snapatac2. Is there anything I can do to help that process along?

When trying to run `sc.pp.highly_variable_genes()` in
docs/tutorials/annotation.ipynb the following ImportError is encountered:

ImportError: Please install skmisc package via `pip install --user scikit-misc

Looking at the pyproject.toml for the `scanpy` project it looks like
the `scikit-misc` package can be co-installed by specifying
`scanpy[skmisc]` (see:
https://github.com/scverse/scanpy/blob/a956fa781a8406fc5030093356c0372456d9184b/pyproject.toml#L142)
User friendliness improvements:
- Added short guide on how to make use of Nvidia GPU with Docker image
- Updated recommend-interactive image and example command so that
  downloaded datasets can be shared with local machine (and vice versa)

- This commit also bumps the default `SnapATAC2` version that will
  be built when following the README to v2.6.0.
@codecov-commenter
Copy link

codecov-commenter commented Mar 10, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 98.23%. Comparing base (1a0cb1d) to head (5b099db).

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #249   +/-   ##
=======================================
  Coverage   98.23%   98.23%           
=======================================
  Files           4        4           
  Lines         227      227           
=======================================
  Hits          223      223           
  Misses          4        4           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@kaizhang kaizhang merged commit ab6dc31 into kaizhang:main Mar 14, 2024
4 checks passed
kaizhang pushed a commit that referenced this pull request Mar 14, 2024
* Address import error encountered in annotation.ipynb

When trying to run `sc.pp.highly_variable_genes()` in
docs/tutorials/annotation.ipynb the following ImportError is encountered:

ImportError: Please install skmisc package via `pip install --user scikit-misc

Looking at the pyproject.toml for the `scanpy` project it looks like
the `scikit-misc` package can be co-installed by specifying
`scanpy[skmisc]` (see:
https://github.com/scverse/scanpy/blob/a956fa781a8406fc5030093356c0372456d9184b/pyproject.toml#L142)

* Make recommend-interactive docker image even more user friendly

User friendliness improvements:
- Added short guide on how to make use of Nvidia GPU with Docker image
- Updated recommend-interactive image and example command so that
  downloaded datasets can be shared with local machine (and vice versa)

- This commit also bumps the default `SnapATAC2` version that will
  be built when following the README to v2.6.0.

* Add guide sections for running SnapATAC2 Docker image on other platforms

* Fix formatting error in Docker README.md
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