Skip to content

Commit 7f989a5

Browse files
authored
Merge pull request #34 from WEHI-ResearchComputing/Update-README
Enhance README with installation and usage details
2 parents 50f8094 + 287c9f6 commit 7f989a5

1 file changed

Lines changed: 20 additions & 10 deletions

File tree

README.md

Lines changed: 20 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,17 @@
22

33
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.
44

5+
Installation and Usage can be found at our [Documentation](https://wehi-researchcomputing.github.io/PartiNet/)
6+
7+
Use our pretrained model at [Model Weights](https://huggingface.co/MihinP/PartiNet)
8+
59

610
## Features
711

8-
- 🧹 Advanced denoising for improved signal-to-noise ratio
9-
- 🎯 Deep learning-based particle detection
12+
- 🧹 Heuristic denoising for improved signal-to-noise ratio
13+
- 🎯 Dynamic deep learning particle detection
1014
- ⚡ Multi-GPU support for faster processing
11-
- 🔄 Seamless integration with RELION workflows
15+
- 🔄 Seamless integration with cryoSPARC and RELION workflows
1216
- 📊 Confidence-based particle filtering
1317
- 🖼️ Visual detection validation
1418

@@ -27,13 +31,18 @@ cd PartiNet
2731
```
2832

2933
Alternatively, use our containers:
34+
```
35+
# Singularity/Apptainer
36+
apptainer exec --nv --no-home \
37+
-B /path/to/your/data:/data oras://ghcr.io/wehi-researchcomputing/partinet:main-singularity \
38+
partinet --help
39+
```
3040

31-
```bash
41+
```
3242
# Docker
33-
docker run ghcr.io/wehi-researchcomputing/partinet:latest
34-
35-
# Singularity/Apptainer
36-
singularity run oras://ghcr.io/wehi-researchcomputing/partinet:latest
43+
docker pull ghcr.io/wehi-researchcomputing/partinet:main
44+
docker run --gpus all -v /path/to/your/data:/data \
45+
ghcr.io/wehi-researchcomputing/partinet:main partinet --help
3746
```
3847

3948
## Directory Structure
@@ -122,6 +131,7 @@ Available commands:
122131
- Verify GPU availability: `nvidia-smi`
123132
- Check CUDA installation
124133
- Ensure proper device selection
134+
- AMD and Intel GPUs are currently untested
125135

126136
- **Path Issues**
127137
- Verify directory permissions
@@ -130,11 +140,11 @@ Available commands:
130140

131141
## Contributing
132142

133-
We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details.
143+
We welcome contributions! Please raise issues or initiate pull requests on this repo.
134144

135145
## License
136146

137-
This project is licensed under the terms of the LICENSE file included in the repository.
147+
This project is licensed under the terms of MIT license.
138148

139149
## Citation
140150

0 commit comments

Comments
 (0)