Skip to content

Commit a23aeef

Browse files
committed
clean up why bioshell page
1 parent 2d7173e commit a23aeef

1 file changed

Lines changed: 18 additions & 22 deletions

File tree

pages/why-bioshell.md

Lines changed: 18 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -3,19 +3,19 @@ title: Why use a cloud workspace for bioinformatics?
33
description: An introduction to virtual machines, cloud computing, and why BioShell is a great starting point for life-science researchers and workshop participants.
44
---
55

6-
If you are new to bioinformatics or planning a workshop, this page explains what cloud
6+
If you are new to bioinformatics and the world of high computing, this page explains what cloud
77
computing is, when to use it, and why BioShell makes it easy to get started.
88

99
---
1010

1111
## What is a virtual machine? {#what-is-a-vm}
1212

13-
A virtual machine is a computer that runs inside another computer delivered to you over the
13+
A virtual machine is a computer that runs inside another computer, delivered to you over the
1414
internet. You connect to it from your laptop or desktop, and it behaves like a full computer
1515
you have complete control over. You do not need to worry about your own hardware specs,
1616
operating system, or software installation.
1717

18-
> Think of it like a fully-equipped lab bench that is always ready you just sit down and
18+
> Think of it like a fully-equipped lab bench that is always ready, you just sit down and
1919
> start working, then leave when you are done. The bench does not belong to you, but it is
2020
> set up exactly the way you need it.
2121
@@ -30,18 +30,18 @@ With a virtual machine you can:
3030

3131
---
3232

33-
## Cloud vs HPC which should I use? {#cloud-vs-hpc}
33+
## Cloud vs HPC - which should I use? {#cloud-vs-hpc}
3434

3535
Both cloud computing and High-Performance Computing (HPC) systems such as NCI Gadi are
3636
powerful research tools, but they suit different types of work.
3737

3838
| | Cloud (BioShell) | HPC (e.g. NCI Gadi) |
3939
|--|-----------------|---------------------|
40-
| **Session type** | Interactive work in real time | Batch submit jobs and come back later |
40+
| **Session type** | Interactive - work in real time | Batch - submit jobs and come back later |
4141
| **Interfaces** | JupyterLab, RStudio, CLI | CLI only (PBS/Slurm schedulers) |
42-
| **Setup required** | None environment is preconfigured | Familiarity with job schedulers required |
42+
| **Setup required** | None - environment is preconfigured | Familiarity with job schedulers required |
4343
| **Best for** | Learning, workshops, exploratory analysis | Large-scale, tightly coupled, or long-running workloads |
44-
| **Scaling** | Flexible choose your VM size on demand | Fixed allocations managed through project quotas |
44+
| **Scaling** | Flexible - choose your VM size on demand | Fixed allocations managed through project quotas |
4545

4646
**Not sure which to use?** If you are learning bioinformatics, running a workshop, or
4747
exploring a new analysis, start with cloud. BioShell is the right choice. You can move to
@@ -57,33 +57,29 @@ teaching. BioShell solves this.
5757

5858
| Feature | What it means for you |
5959
|---------|----------------------|
60-
| **Ready to use** | Over 20,000 bioinformatics tools and reference datasets available — no setup required |
61-
| **Consistent everywhere** | The same environment works identically on Nectar and NCI Nirin |
62-
| **Training-ready** | Trainers can provision dozens of identical machines for a workshop in minutes |
63-
| **Multiple interfaces** | Access via SSH, or use JupyterLab and RStudio in your browser |
64-
| **Reproducible** | Containerised software means your analysis works the same way today, next year, and on a colleague's machine |
65-
| **Safe to explore** | You have administrator access to your own VM — mistakes only affect your own instance |
60+
| **Ready on any device** | Every participant gets the same preconfigured environment regardless of whether they are on Windows, macOS, or Linux with no device-specific setup required |
61+
| **More power than your laptop** | Use familiar tools like RStudio and JupyterLab, but backed by cloud compute that is not competing with your browser, email, or background applications |
62+
| **Tool discovery built in** | [Bio-Shelley](tools), BioShell's command-line assistant, makes finding and installing tools from a catalogue of over 20,000 containers as simple as `shelley-bio build samtools`, no container knowledge needed |
63+
| **Reproducible workshops** | Version-controlled environments mean you can build a workshop once and rerun it identically next year, or share it with another trainer at another institution |
64+
| **Easier access than HPC** | Getting time on a national HPC requires project allocation, queue estimates, and job scheduler knowledge. BioShell access is fast, self-service, and does not require you to know in advance exactly what you will run |
65+
| **Admin access, safely sandboxed** | You have full administrator privileges on your own VM, install anything and break things without affecting other users or needing HPC sysadmin approval |
6666

6767
---
6868

6969
## How does BioShell fit with HPC? {#bioshell-and-hpc}
7070

71-
BioShell is not a replacement for large-scale HPC it complements it. Think of it as the
72-
place where you learn, develop, and test your workflows before scaling up.
71+
BioShell is not a replacement for large-scale HPC, it complements it. Think of it as the
72+
place where you learn, develop, and test your workflows before scaling up. It helps fill the gap between working on your laptop and moving onto a HPC
7373

74-
1. **Learn and explore on BioShell** get comfortable with the command line, tools, and
74+
1. **Learn and explore on BioShell** - get comfortable with the command line, tools, and
7575
your data in a low-pressure environment.
76-
2. **Develop and test your workflow** build and validate your Nextflow or Snakemake
76+
2. **Develop and test your workflow** - build and validate your Nextflow or Snakemake
7777
pipeline using BioShell's pre-installed tools and example datasets.
78-
3. **Scale up to HPC when ready** once your workflow is confirmed and your data needs are
78+
3. **Scale up to HPC when ready** - once your workflow is confirmed and your data needs are
7979
clear, move to NCI Gadi or another HPC system for large-scale runs.
8080

8181
---
8282

8383
## Ready to get started? {#get-started}
8484

85-
BioShell is available to Australian life-science researchers, trainers, and developers
86-
through [ABLeS](https://australianbiocommons.github.io/ables/). Access is free — you just
87-
need to be affiliated with an Australian research organisation.
88-
8985
[Check your eligibility and apply →](access#eligibility)

0 commit comments

Comments
 (0)