MarkerCount


NameMarkerCount JSON
Version 0.7.1 PyPI version JSON
download
home_pageNone
SummaryCell-type identification toolkit for single-cell RNA-Seq experiments.
upload_time2024-09-23 16:02:27
maintainerNone
docs_urlNone
authorNone
requires_pythonNone
licenseMIT License Copyright (c) 2023 Seokhyun Yoon Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
keywords single-cell omics bioinformatics
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            ## MarkerCount update
- Sept 01, 2022: Added HiCAT, an updated version of MarkerCount.
- Dec. 06, 2021: Now, MarkerCount can be used in R. Please see the instruction below.
- June 27, 2021: Slight modification was made to improve the identification performance.


## HiCAT

![PyPI Version](https://img.shields.io/pypi/v/MarkerCount.svg)  ![PyPI Downloads](https://img.shields.io/pypi/dm/MarkerCount.svg)  

- HiCAT is a marker-based, hierarchical cell-type annotation tool for single-cell RNA-seq data.
- It was developed using python3, but also run in R as well.
- HiCAT works in marker-based mode utilizing only the existing lists of markers.
- Github page: https://github.com/combio-dku/HiCAT
- Please refer to "Hierarchical cell-type identifier accurately distinguishes immune-cell subtypes enabling precise profiling of tissue microenvironment with single-cell RNA-sequencing", Briefings in Bioinformatics, available at https://doi.org/10.1093/bib/bbad006,  https://doi.org/10.1101/2022.07.27.501701

### Installation using pip and importing HiCAT in Python

HiCAT can be installed using pip command. With python3 installed in your system, simply use the follwing command in a terminal.

`pip install MarkerCount`

Once it is installed using pip, you can import two functions using the following python command.

`from MarkerCount.hicat import HiCAT, show_summary`

where `show_summary` is used to check the annotation results.

Please check HiCAT github page https://github.com/combio-dku/HiCAT for its usage and example jupyter notebook. 

### HiCAT marker file format

Marker file must be a tap-separated-value file (.tsv) with 5 columns, "cell_type_major", "cell_type_minor", "cell_type_subset", "exp" and "markers".
- The first three columns define the 3-level taxonomy tree to be used for hierarchical identification.
- "exp" is type of marker, which can be "pos", "neg", or "sec".
- "markers" is a list of gene symbols separated by comma.
- The markers in "cell_markers_rndsystems_rev.tsv", were reproduced from [R&D systems](https://www.rndsystems.com/resources/cell-markers)

If you want to use your own markers, please refer to the [tips for prepareing markers db](https://github.com/combio-dku/HiCAT/blob/main/PreparingMarkersDB.md).

## MarkerCount and MarkerCount-Ref (Previous version)

- MarkerCount is a python3 cell-type identification toolkit for single-cell RNA-Seq experiments.
- MarkerCount works both in reference and marker-based mode, where the latter utilizes only the existing lists of markers, while the former required pre-annotated dataset to train the model. 
- Please refer to the preprint manuscript "MarkerCount: A stable, count-based cell type identifier for single cell RNA-Seq experiments" available at https://www.researchsquare.com/article/rs-418249/v2 DOI: https://doi.org/10.21203/rs.3.rs-418249/v2 

### Installation and importing MarkerCount

All the functions to implement MarkerCount are defined in the python3 script, `marker_count.py`, where the two key functions are 

1. `MarkerCount()`: marker-based cell-type identifier
1. `MarkerCount_Ref()`: reference-based cell-type identifier

One can import the function by adding a line in your script, i.e., `from marker_count import MarkerCount_Ref, MarkerCount`

Please check MarkerCount github page https://github.com/combio-dku/MarkerCount for its usage and example jupyter notebook. 

## Contact
Send email to syoon@dku.edu for any inquiry on the usages.


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "MarkerCount",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "single-cell omics, bioinformatics",
    "author": null,
    "author_email": "Seokhyun Yoon <syoon@dku.edu>",
    "download_url": "https://files.pythonhosted.org/packages/50/6a/7c68b4f720d7d30471c4b7f26be9790b73290635e028b1093cca01a20989/markercount-0.7.1.tar.gz",
    "platform": null,
    "description": "## MarkerCount update\n- Sept 01, 2022: Added HiCAT, an updated version of MarkerCount.\n- Dec. 06, 2021: Now, MarkerCount can be used in R. Please see the instruction below.\n- June 27, 2021: Slight modification was made to improve the identification performance.\n\n\n## HiCAT\n\n![PyPI Version](https://img.shields.io/pypi/v/MarkerCount.svg)  ![PyPI Downloads](https://img.shields.io/pypi/dm/MarkerCount.svg)  \n\n- HiCAT is a marker-based, hierarchical cell-type annotation tool for single-cell RNA-seq data.\n- It was developed using python3, but also run in R as well.\n- HiCAT works in marker-based mode utilizing only the existing lists of markers.\n- Github page: https://github.com/combio-dku/HiCAT\n- Please refer to \"Hierarchical cell-type identifier accurately distinguishes immune-cell subtypes enabling precise profiling of tissue microenvironment with single-cell RNA-sequencing\", Briefings in Bioinformatics, available at https://doi.org/10.1093/bib/bbad006,  https://doi.org/10.1101/2022.07.27.501701\n\n### Installation using pip and importing HiCAT in Python\n\nHiCAT can be installed using pip command. With python3 installed in your system, simply use the follwing command in a terminal.\n\n`pip install MarkerCount`\n\nOnce it is installed using pip, you can import two functions using the following python command.\n\n`from MarkerCount.hicat import HiCAT, show_summary`\n\nwhere `show_summary` is used to check the annotation results.\n\nPlease check HiCAT github page https://github.com/combio-dku/HiCAT for its usage and example jupyter notebook. \n\n### HiCAT marker file format\n\nMarker file must be a tap-separated-value file (.tsv) with 5 columns, \"cell_type_major\", \"cell_type_minor\", \"cell_type_subset\", \"exp\" and \"markers\".\n- The first three columns define the 3-level taxonomy tree to be used for hierarchical identification.\n- \"exp\" is type of marker, which can be \"pos\", \"neg\", or \"sec\".\n- \"markers\" is a list of gene symbols separated by comma.\n- The markers in \"cell_markers_rndsystems_rev.tsv\", were reproduced from [R&D systems](https://www.rndsystems.com/resources/cell-markers)\n\nIf you want to use your own markers, please refer to the [tips for prepareing markers db](https://github.com/combio-dku/HiCAT/blob/main/PreparingMarkersDB.md).\n\n## MarkerCount and MarkerCount-Ref (Previous version)\n\n- MarkerCount is a python3 cell-type identification toolkit for single-cell RNA-Seq experiments.\n- MarkerCount works both in reference and marker-based mode, where the latter utilizes only the existing lists of markers, while the former required pre-annotated dataset to train the model. \n- Please refer to the preprint manuscript \"MarkerCount: A stable, count-based cell type identifier for single cell RNA-Seq experiments\" available at https://www.researchsquare.com/article/rs-418249/v2 DOI: https://doi.org/10.21203/rs.3.rs-418249/v2 \n\n### Installation and importing MarkerCount\n\nAll the functions to implement MarkerCount are defined in the python3 script, `marker_count.py`, where the two key functions are \n\n1. `MarkerCount()`: marker-based cell-type identifier\n1. `MarkerCount_Ref()`: reference-based cell-type identifier\n\nOne can import the function by adding a line in your script, i.e., `from marker_count import MarkerCount_Ref, MarkerCount`\n\nPlease check MarkerCount github page https://github.com/combio-dku/MarkerCount for its usage and example jupyter notebook. \n\n## Contact\nSend email to syoon@dku.edu for any inquiry on the usages.\n\n",
    "bugtrack_url": null,
    "license": "MIT License  Copyright (c) 2023 Seokhyun Yoon  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \u201cSoftware\u201d), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:  The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.  THE SOFTWARE IS PROVIDED \u201cAS IS\u201d, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.",
    "summary": "Cell-type identification toolkit for single-cell RNA-Seq experiments.",
    "version": "0.7.1",
    "project_urls": {
        "Homepage": "https://github.com/combio-dku/",
        "repository": "https://github.com/combio-dku/HiCAT"
    },
    "split_keywords": [
        "single-cell omics",
        " bioinformatics"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "cfe124bfeea9002f95d3d97f5bf4784f91cda81436207894ee082f04651770b0",
                "md5": "692a1dd9dfb48cd670ecdda8b1b414a9",
                "sha256": "015f8302014c610e39a9cbb012ab76993808ed2811c9cce91026e05dc27013da"
            },
            "downloads": -1,
            "filename": "MarkerCount-0.7.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "692a1dd9dfb48cd670ecdda8b1b414a9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 42783,
            "upload_time": "2024-09-23T16:02:25",
            "upload_time_iso_8601": "2024-09-23T16:02:25.880566Z",
            "url": "https://files.pythonhosted.org/packages/cf/e1/24bfeea9002f95d3d97f5bf4784f91cda81436207894ee082f04651770b0/MarkerCount-0.7.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "506a7c68b4f720d7d30471c4b7f26be9790b73290635e028b1093cca01a20989",
                "md5": "350630a1a7c2229153717d8b4112430d",
                "sha256": "7d05479adf3b4ee8fa98a077b43686080f3dea0d82718aa400c7f06b85f05b45"
            },
            "downloads": -1,
            "filename": "markercount-0.7.1.tar.gz",
            "has_sig": false,
            "md5_digest": "350630a1a7c2229153717d8b4112430d",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 42077,
            "upload_time": "2024-09-23T16:02:27",
            "upload_time_iso_8601": "2024-09-23T16:02:27.787232Z",
            "url": "https://files.pythonhosted.org/packages/50/6a/7c68b4f720d7d30471c4b7f26be9790b73290635e028b1093cca01a20989/markercount-0.7.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-23 16:02:27",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "combio-dku",
    "github_project": "HiCAT",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "markercount"
}
        
Elapsed time: 1.03923s