From 175e86df855b2ce55dc2adc75fbed6a4c9d65532 Mon Sep 17 00:00:00 2001 From: Mihin <116701142+MihinP@users.noreply.github.com> Date: Wed, 21 Jan 2026 12:59:29 +1100 Subject: [PATCH] Enhance README with installation and usage details Updated README to include installation instructions, usage of pretrained model, and clarified licensing information. --- README.md | 30 ++++++++++++++++++++---------- 1 file changed, 20 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 8f92b42..2148721 100644 --- a/README.md +++ b/README.md @@ -2,13 +2,17 @@ PartiNet is a three-stage pipeline for automated particle picking in cryo-EM micrographs, combining advanced denoising with state-of-the-art deep learning detection. +Installation and Usage can be found at our [Documentation](https://wehi-researchcomputing.github.io/PartiNet/) + +Use our pretrained model at [Model Weights](https://huggingface.co/MihinP/PartiNet) + ## Features -- ๐Ÿงน Advanced denoising for improved signal-to-noise ratio -- ๐ŸŽฏ Deep learning-based particle detection +- ๐Ÿงน Heuristic denoising for improved signal-to-noise ratio +- ๐ŸŽฏ Dynamic deep learning particle detection - โšก Multi-GPU support for faster processing -- ๐Ÿ”„ Seamless integration with RELION workflows +- ๐Ÿ”„ Seamless integration with cryoSPARC and RELION workflows - ๐Ÿ“Š Confidence-based particle filtering - ๐Ÿ–ผ๏ธ Visual detection validation @@ -27,13 +31,18 @@ cd PartiNet ``` Alternatively, use our containers: +``` +# Singularity/Apptainer +apptainer exec --nv --no-home \ + -B /path/to/your/data:/data oras://ghcr.io/wehi-researchcomputing/partinet:main-singularity \ + partinet --help +``` -```bash +``` # Docker -docker run ghcr.io/wehi-researchcomputing/partinet:latest - -# Singularity/Apptainer -singularity run oras://ghcr.io/wehi-researchcomputing/partinet:latest +docker pull ghcr.io/wehi-researchcomputing/partinet:main +docker run --gpus all -v /path/to/your/data:/data \ + ghcr.io/wehi-researchcomputing/partinet:main partinet --help ``` ## Directory Structure @@ -122,6 +131,7 @@ Available commands: - Verify GPU availability: `nvidia-smi` - Check CUDA installation - Ensure proper device selection + - AMD and Intel GPUs are currently untested - **Path Issues** - Verify directory permissions @@ -130,11 +140,11 @@ Available commands: ## Contributing -We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details. +We welcome contributions! Please raise issues or initiate pull requests on this repo. ## License -This project is licensed under the terms of the LICENSE file included in the repository. +This project is licensed under the terms of MIT license. ## Citation