Skip to content

Commit ace82ba

Browse files
committed
Update docs for deps and conda
1 parent 479ec84 commit ace82ba

File tree

1 file changed

+23
-13
lines changed

1 file changed

+23
-13
lines changed

docs/installation.md

Lines changed: 23 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,29 @@
11
(sec-installation)=
22
# Installation
33

4+
``bio2zarr`` can either be installed from bioconda or PyPI.
45

6+
By default the ``bio2zarr`` PyPI package does not come with dependencies
7+
needed to convert VCF or tskit files, so optional dependencies
8+
need to be specified:
59
```bash
6-
python3 -m pip install bio2zarr
10+
python3 -m pip install bio2zarr #Base package with only plink support
11+
python3 -m pip install bio2zarr[vcf] #Install with VCF support
12+
python3 -m pip install bio2zarr[tskit] #Install with tskit support
13+
python3 -m pip install bio2zarr[all] #Install with all optional dependencies
714
```
815

9-
This will install the programs ``vcf2zarr`` and ``vcf_partition``
10-
into your local Python path. You may need to update your $PATH to call the
16+
For bioconda users, the package is available in the
17+
[bioconda channel](https://anaconda.org/bioconda/bio2zarr):
18+
```bash
19+
conda install -c bioconda bio2zarr
20+
```
21+
22+
This will install the programs ``vcf2zarr``, ``vcf_partition``, ``tskit2zarr`
23+
and ``plink2zarr`` into your local Python path. You may need to update your $PATH to call the
1124
executables directly.
1225

13-
Alternatively, calling
26+
Alternatively, calling for example:
1427
```bash
1528
python3 -m bio2zarr vcf2zarr <args>
1629
```
@@ -21,16 +34,11 @@ vcf2zarr <args>
2134
```
2235
and will always work.
2336

24-
:::{note}
25-
The ``python3 -m bio2zarr vcf2zarr`` form may be replaced with
26-
``python3 -m bio2zarr.vcf2zarr`` in the near future.
27-
See GitHub issue [203](https://github.com/sgkit-dev/bio2zarr/issues/203).
28-
:::
29-
3037
:::{warning}
31-
Windows is not currently supported. Please comment on
38+
Windows is not currently directly supported. We recommend the use
39+
of Windows Subsystem for Linux (WSL) Please comment on
3240
[this issue](https://github.com/sgkit-dev/bio2zarr/issues/174) if you would
33-
like to see Windows support for bio2zarr.
41+
like to see direct Windows support for bio2zarr.
3442
:::
3543

3644

@@ -40,9 +48,11 @@ To enable shell completion for a particular session in Bash do:
4048

4149
```bash
4250
eval "$(_VCF2ZARR_COMPLETE=bash_source vcf2zarr)"
51+
eval "$(_TSKIT2ZARR_COMPLETE=bash_source tskit2zarr)"
52+
eval "$(_PLINK2ZARR_COMPLETE=bash_source plink2zarr)"
4353
```
4454

45-
If you add this to your ``.bashrc`` vcf2zarr shell completion should available
55+
If you add this to your ``.bashrc`` shell completion should available
4656
in all new shell sessions.
4757

4858
See the [Click documentation](https://click.palletsprojects.com/en/8.1.x/shell-completion/#enabling-completion)

0 commit comments

Comments
 (0)