phosx


Namephosx JSON
Version 0.5.5 PyPI version JSON
download
home_pageNone
SummaryNone
upload_time2024-04-05 14:20:46
maintainerNone
docs_urlNone
authorAlessandro Lussana
requires_python<4.0,>=3.10
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center">
  <img width="190" src="https://i.imgur.com/OzGTvkt.png">
  <br>
  Kinase activity inference from phosphosproteomics data based on substrate sequence specificity
  <br><br>
</p>

![Build and publish to PyPI badge](https://github.com/alussana/phosx/actions/workflows/build-and-publish-to-pypi.yml/badge.svg)

> Current version: `v0.5.5`

> Research paper: [https://doi.org/10.1101/2024.03.22.586304](https://doi.org/10.1101/2024.03.22.586304)

# Overview

<p align="center">
<br>
  <img width="900" src="https://i.imgur.com/6DdMDom.png">
  <br>
</p>

PhosX infers differential kinase activities from phosphoproteomics data without requiring any prior knowledge database of kinase-phosphosite associations. PhosX assigns the detected phosphopeptides to potential upstream kinases based on experimentally determined substrate sequence specificities, and it tests the enrichment of a kinase's potential substrates in the extremes of a ranked list of phosphopeptides using a Kolmogorov-Smirnov-like statistic. A _p_ value for this statistic is extracted empirically by random permutations of the phosphosite ranks.

# Installation

## From [PyPI](https://pypi.org/project/phosx/)

```bash
pip install phosx
```

## From source (requires [Poetry](https://python-poetry.org))

```
poetry build
pip install dist/*.whl
```

# Usage

```bash
phosx [-h] [-p PSSM] [-q PSSM_QUANTILES] [-n N_PERMUTATIONS] [-k N_TOP_KINASES] [-m MIN_N_HITS] [-c N_PROC] [--plot-figures] [-d OUTPUT_DIR] [-o OUTPUT_PATH] [-v] seqrnk
```
```bash
positional arguments:
  seqrnk                Path to the seqrnk file.

options:
  -h, --help            show this help message and exit
  -p PSSM, --pssm PSSM  Path to the h5 file storing custom PSSMs; defaults to built-in PSSMs
  -q PSSM_QUANTILES, --pssm-quantiles PSSM_QUANTILES
                        Path to the h5 file storing custom PSSM score quantile distributions under the key 'pssm_scores'; defaults to built-in PSSM scores quantiles
  -n N_PERMUTATIONS, --n-permutations N_PERMUTATIONS
                        Number of random permutations; default: 1000
  -k N_TOP_KINASES, --n-top-kinases N_TOP_KINASES
                        Number of top-scoring kinases potentially associatiated to a given phosphosite; default: 8
  -m MIN_N_HITS, --min-n-hits MIN_N_HITS
                        Minimum number of phosphosites associated with a kinase for the kinase to be considered in the analysis; default: 4
  -c N_PROC, --n-proc N_PROC
                        Number of cores used for multithreading; default: 1
  --plot-figures        Save figures in pdf format; see also --output_dir
  -d OUTPUT_DIR, --output-dir OUTPUT_DIR
                        Output files directory; only relevant if used with --plot_figures; defaults to 'phosx_output/'
  -o OUTPUT_PATH, --output-path OUTPUT_PATH
                        Main output table; if not specified it will be printed in STDOUT
  -v, --version         Print package version and exit
```

Minimal example to run PhosX with default parameters on an example dataset, using up to 8 cores, and redirecting the output table to `kinase_activities.tsv`:

```bash
phosx -c 8 tests/seqrnk/koksal2018_log2.fold.change.8min.seqrnk > kinase_activities.tsv
```

# Cite

BibTeX:

```bibtex
@article{Lussana2024,
  title = {PhosX: data-driven kinase activity inference from phosphoproteomics experiments},
  url = {http://dx.doi.org/10.1101/2024.03.22.586304},
  DOI = {10.1101/2024.03.22.586304},
  publisher = {Cold Spring Harbor Laboratory},
  author = {Lussana,  Alessandro and Petsalaki,  Evangelia},
  year = {2024},
  month = mar 
}
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "phosx",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.10",
    "maintainer_email": null,
    "keywords": null,
    "author": "Alessandro Lussana",
    "author_email": "alussana@ebi.ac.uk",
    "download_url": "https://files.pythonhosted.org/packages/16/06/25e1be29616a7227b917075589e5b04068bcca0dde9a569c8f9385a30c5a/phosx-0.5.5.tar.gz",
    "platform": null,
    "description": "<p align=\"center\">\n  <img width=\"190\" src=\"https://i.imgur.com/OzGTvkt.png\">\n  <br>\n  Kinase activity inference from phosphosproteomics data based on substrate sequence specificity\n  <br><br>\n</p>\n\n![Build and publish to PyPI badge](https://github.com/alussana/phosx/actions/workflows/build-and-publish-to-pypi.yml/badge.svg)\n\n> Current version: `v0.5.5`\n\n> Research paper: [https://doi.org/10.1101/2024.03.22.586304](https://doi.org/10.1101/2024.03.22.586304)\n\n# Overview\n\n<p align=\"center\">\n<br>\n  <img width=\"900\" src=\"https://i.imgur.com/6DdMDom.png\">\n  <br>\n</p>\n\nPhosX infers differential kinase activities from phosphoproteomics data without requiring any prior knowledge database of kinase-phosphosite associations. PhosX assigns the detected phosphopeptides to potential upstream kinases based on experimentally determined substrate sequence specificities, and it tests the enrichment of a kinase's potential substrates in the extremes of a ranked list of phosphopeptides using a Kolmogorov-Smirnov-like statistic. A _p_ value for this statistic is extracted empirically by random permutations of the phosphosite ranks.\n\n# Installation\n\n## From [PyPI](https://pypi.org/project/phosx/)\n\n```bash\npip install phosx\n```\n\n## From source (requires [Poetry](https://python-poetry.org))\n\n```\npoetry build\npip install dist/*.whl\n```\n\n# Usage\n\n```bash\nphosx [-h] [-p PSSM] [-q PSSM_QUANTILES] [-n N_PERMUTATIONS] [-k N_TOP_KINASES] [-m MIN_N_HITS] [-c N_PROC] [--plot-figures] [-d OUTPUT_DIR] [-o OUTPUT_PATH] [-v] seqrnk\n```\n```bash\npositional arguments:\n  seqrnk                Path to the seqrnk file.\n\noptions:\n  -h, --help            show this help message and exit\n  -p PSSM, --pssm PSSM  Path to the h5 file storing custom PSSMs; defaults to built-in PSSMs\n  -q PSSM_QUANTILES, --pssm-quantiles PSSM_QUANTILES\n                        Path to the h5 file storing custom PSSM score quantile distributions under the key 'pssm_scores'; defaults to built-in PSSM scores quantiles\n  -n N_PERMUTATIONS, --n-permutations N_PERMUTATIONS\n                        Number of random permutations; default: 1000\n  -k N_TOP_KINASES, --n-top-kinases N_TOP_KINASES\n                        Number of top-scoring kinases potentially associatiated to a given phosphosite; default: 8\n  -m MIN_N_HITS, --min-n-hits MIN_N_HITS\n                        Minimum number of phosphosites associated with a kinase for the kinase to be considered in the analysis; default: 4\n  -c N_PROC, --n-proc N_PROC\n                        Number of cores used for multithreading; default: 1\n  --plot-figures        Save figures in pdf format; see also --output_dir\n  -d OUTPUT_DIR, --output-dir OUTPUT_DIR\n                        Output files directory; only relevant if used with --plot_figures; defaults to 'phosx_output/'\n  -o OUTPUT_PATH, --output-path OUTPUT_PATH\n                        Main output table; if not specified it will be printed in STDOUT\n  -v, --version         Print package version and exit\n```\n\nMinimal example to run PhosX with default parameters on an example dataset, using up to 8 cores, and redirecting the output table to `kinase_activities.tsv`:\n\n```bash\nphosx -c 8 tests/seqrnk/koksal2018_log2.fold.change.8min.seqrnk > kinase_activities.tsv\n```\n\n# Cite\n\nBibTeX:\n\n```bibtex\n@article{Lussana2024,\n  title = {PhosX: data-driven kinase activity inference from phosphoproteomics experiments},\n  url = {http://dx.doi.org/10.1101/2024.03.22.586304},\n  DOI = {10.1101/2024.03.22.586304},\n  publisher = {Cold Spring Harbor Laboratory},\n  author = {Lussana,  Alessandro and Petsalaki,  Evangelia},\n  year = {2024},\n  month = mar \n}\n```\n",
    "bugtrack_url": null,
    "license": null,
    "summary": null,
    "version": "0.5.5",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "46991d8a2ba7416f05c0c58a754e439c4ebacdedf2b2916dc1c76f67cb22c060",
                "md5": "f58f529d5f264da8ee981fb0292c3899",
                "sha256": "94b708a068624911f147a4c2e3f528f978f57f7f6f65206f950cd7c27e0026f0"
            },
            "downloads": -1,
            "filename": "phosx-0.5.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "f58f529d5f264da8ee981fb0292c3899",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.10",
            "size": 23878136,
            "upload_time": "2024-04-05T14:20:43",
            "upload_time_iso_8601": "2024-04-05T14:20:43.373255Z",
            "url": "https://files.pythonhosted.org/packages/46/99/1d8a2ba7416f05c0c58a754e439c4ebacdedf2b2916dc1c76f67cb22c060/phosx-0.5.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "160625e1be29616a7227b917075589e5b04068bcca0dde9a569c8f9385a30c5a",
                "md5": "ca778c76bcc7052ec90cf936fee9d79a",
                "sha256": "6b51422998d0bc0ae79b12623f0310a3422139926b9cad4546649bc80c991105"
            },
            "downloads": -1,
            "filename": "phosx-0.5.5.tar.gz",
            "has_sig": false,
            "md5_digest": "ca778c76bcc7052ec90cf936fee9d79a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.10",
            "size": 23880142,
            "upload_time": "2024-04-05T14:20:46",
            "upload_time_iso_8601": "2024-04-05T14:20:46.076929Z",
            "url": "https://files.pythonhosted.org/packages/16/06/25e1be29616a7227b917075589e5b04068bcca0dde9a569c8f9385a30c5a/phosx-0.5.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-05 14:20:46",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "phosx"
}
        
Elapsed time: 0.31002s