Skip to content

Commit

Permalink
Add bioconda badges (#27)
Browse files Browse the repository at this point in the history
* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md
  • Loading branch information
nebfield authored Jun 25, 2024
1 parent 7e75e75 commit 4ec2ecc
Show file tree
Hide file tree
Showing 5 changed files with 38 additions and 19 deletions.
27 changes: 15 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,34 +13,37 @@ that has been converted to namespace packages for modularity and re-use.

## User applications

[![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)](http://bioconda.github.io/recipes/pgscatalog-utils/README.html)

These CLI applications are used internally by the [PGS Catalog Calculator (`pgsc_calc`)](https://github.com/PGScatalog/pgsc_calc)
workflow for calculating PGS and performing common adjustments for genetic ancestry.

If you want an automatic method of calculating PGS, including genetic ancestry similarity estimation and PGS normalisation,
the workflow is the easiest method.

> [!TIP]
> If you want to use all of the applications listed below, you can install the package `pgscatalog-utils` with [pip](https://pypi.org/project/pgscatalog-utils/) or [bioconda](http://bioconda.github.io/recipes/pgscatalog-utils/README.html)
| Application | Description | Install | Link |
|------------------------------|------------------------------------------------------------------------|---------------------------------|--------------------------------------|
| `pgscatalog-download` | Download scoring files from the PGS Catalog in specific genome builds | `pipx install pgscatalog-core` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/download.html) |
| `pgscatalog-combine` | Combine multiple scoring files into a consistent structure | `pipx install pgscatalog-core` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/combine.html) |
| `pgscatalog-relabel` | Relabel values in a column based on values in a column in another file | `pipx install pgscatalog-core` | [README](pgscatalog.core/README.md) |
| `pgscatalog-match` | Match structured scoring file to variants in target genomes | `pipx install pgscatalog-match` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/match.html) |
| `pgscatalog-matchmerge` | Merge variant match results, useful on larger datasets | `pipx install pgscatalog-match` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/match.html) |
| `pgscatalog-intersect` | Match variants across two different variant information files (e.g. reference & target genomes) | `pipx install pgscatalog-match` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/intersect.html) |
| `pgscatalog-aggregate` | Aggregate calculated PGS split across multiple files | `pipx install pgscatalog-calc` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/aggregate.html) |
| `pgscatalog-ancestry-adjust` | Adjust calculated PGS in the context of genetic ancestry | `pipx install pgscatalog-calc` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/ancestry.html) |

| `pgscatalog-download` | Download scoring files from the PGS Catalog in specific genome builds | `pipx install pgscatalog.core` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/download.html) |
| `pgscatalog-combine` | Combine multiple scoring files into a consistent structure | `pipx install pgscatalog.core` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/combine.html) |
| `pgscatalog-relabel` | Relabel values in a column based on values in a column in another file | `pipx install pgscatalog.core` | [README](pgscatalog.core/README.md) |
| `pgscatalog-match` | Match structured scoring file to variants in target genomes | `pipx install pgscatalog.match` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/match.html) |
| `pgscatalog-matchmerge` | Merge variant match results, useful on larger datasets | `pipx install pgscatalog.match` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/match.html) |
| `pgscatalog-intersect` | Match variants across two different variant information files (e.g. reference & target genomes) | `pipx install pgscatalog.match` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/intersect.html) |
| `pgscatalog-aggregate` | Aggregate calculated PGS split across multiple files | `pipx install pgscatalog.calc` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/aggregate.html) |
| `pgscatalog-ancestry-adjust` | Adjust calculated PGS in the context of genetic ancestry | `pipx install pgscatalog.calc` | [README](https://pygscatalog.readthedocs.io/en/latest/how-to/guides/ancestry.html) |

## Developer libraries

If you write Python code to work with PGS, the underlying libraries for the apps are documented and available for re-use:

| Library | Description | Link |
|--------------------|----------------------------------------------------------|---------------------------------------------------------------------------------------------------|
| `pgscatalog-core` | Core classes and functions to work with PGS data | [API reference](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/core/index.html) |
| `pgscatalog-match` | Variant matching across scoring files and target genomes | [API reference](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/match/index.html) |
| `pgscatalog-calc` | Genetic ancestry similarity estimation and normalisation | [API reference](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/calc/index.html) |
| `pgscatalog.core` | Core classes and functions to work with PGS data | [API reference](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/core/index.html) |
| `pgscatalog.match` | Variant matching across scoring files and target genomes | [API reference](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/match/index.html) |
| `pgscatalog.calc` | Genetic ancestry similarity estimation and normalisation | [API reference](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/calc/index.html) |

## Documentation

Expand Down
8 changes: 6 additions & 2 deletions pgscatalog.calc/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# `pgscatalog-calc`
# `pgscatalog.calc`

[![Run pytest on pgscatalog.calc](https://github.com/PGScatalog/pygscatalog/actions/workflows/calc-pytest.yml/badge.svg)](https://github.com/PGScatalog/pygscatalog/actions/workflows/calc-pytest.yml)
[![Documentation Status](https://readthedocs.org/projects/pygscatalog/badge/?version=latest)](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/calc/index.html)
Expand All @@ -19,8 +19,12 @@ Please note this package doesn't contain functionality to calculate a PGS from t

## Installation

[![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)](http://bioconda.github.io/recipes/pgscatalog.calc/README.html)

or [install via `pip`](https://pypi.org/project/pgscatalog.calc/):

```
$ pipx install pgscatalog-calc
$ pipx install pgscatalog.calc
```

## Documentation
Expand Down
8 changes: 6 additions & 2 deletions pgscatalog.core/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# `pgscatalog-core`
# `pgscatalog.core`

[![Run pytest on pgscatalog.core](https://github.com/PGScatalog/pygscatalog/actions/workflows/core-pytest.yml/badge.svg)](https://github.com/PGScatalog/pygscatalog/actions/workflows/core-pytest.yml)
[![Documentation Status](https://readthedocs.org/projects/pygscatalog/badge/?version=latest)](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/core/index.html)
Expand All @@ -20,8 +20,12 @@ If you want to do automatic PGS calculation check out the [PGS Catalog Calculato

## Installation

[![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)](http://bioconda.github.io/recipes/pgscatalog.core/README.html)

or [install via `pip`](https://pypi.org/project/pgscatalog.core/):

```
$ pipx install pgscatalog-core
$ pipx install pgscatalog.core
```

## Documentation
Expand Down
8 changes: 6 additions & 2 deletions pgscatalog.match/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# pgscatalog-match
# pgscatalog.match

[![.github/workflows/match-pytest.yml](https://github.com/PGScatalog/pygscatalog/actions/workflows/match-pytest.yml/badge.svg?branch=main)](https://github.com/PGScatalog/pygscatalog/actions/workflows/match-pytest.yml)
[![Documentation Status](https://readthedocs.org/projects/pygscatalog/badge/?version=latest)](https://pygscatalog.readthedocs.io/en/latest/autoapi/pgscatalog/match/index.html)
Expand All @@ -14,8 +14,12 @@ If you want to do automatic PGS calculation check out the [PGS Catalog Calculato

## Installation

[![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)](http://bioconda.github.io/recipes/pgscatalog.match/README.html)

or [install via `pip`](https://pypi.org/project/pgscatalog.match/):

```
$ pipx install pgscatalog-match
$ pipx install pgscatalog.match
```

## Documentation
Expand Down
6 changes: 5 additions & 1 deletion pgscatalog.utils/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,12 @@ See https://github.com/PGScatalog/pygscatalog for more details.

## Installation

[![install with bioconda](https://img.shields.io/badge/install%20with-bioconda-brightgreen.svg?style=flat)](http://bioconda.github.io/recipes/pgscatalog-utils/README.html)

or [install via `pip`](https://pypi.org/project/pgscatalog-utils/):

```
$ pip install pgscatalog-utils
$ pipx install pgscatalog-utils
```

## Documentation
Expand Down

0 comments on commit 4ec2ecc

Please sign in to comment.