{
    "info": {
        "author": "Monther Alhamdoosh",
        "author_email": "m.hamdoosh@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Environment :: Console",
            "Intended Audience :: Science/Research",
            "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
            "Operating System :: MacOS",
            "Operating System :: Microsoft",
            "Operating System :: POSIX",
            "Operating System :: Unix",
            "Programming Language :: Python :: 2.7",
            "Topic :: Scientific/Engineering :: Bio-Informatics"
        ],
        "description": "# Table of contents\n* [Introduction](#introduction)\n    * [AbSeq](#abseq)\n    * [Developers](#developers)\n* [Prerequisites](#prerequisites)\n    * [Seamless installation of dependencies](#seamless-installation-of-dependencies)\n    * [Manual installation of dependencies](#manual-installation-of-dependencies)\n* [abseqPy Installation](#abseqpy-installation)\n    * [Install from `pip`](#install-from-pip)\n    * [Install from source](#install-from-source)\n* [Usage](#usage)\n    * [Basic usage](#basic-usage)\n    * [Advanced usage](#advanced-usage)\n    \t* [Gotchas](#gotchas)\n    * [Help](#help)\n* [Supported platforms](#supported-platforms)\n\n# Introduction\n\n## AbSeq\n`AbSeq` is a comprehensive bioinformatic pipeline for the analysis of sequencing datasets generated from antibody libraries and `abseqPy` is one of its packages. Given FASTQ or FASTA files (paired or single-ended), `abseqPy`\n_generates clonotypes tables_, _V-(D)-J germline annotations_, _functional rates_, and\n_diversity estimates_ in a combination of csv and HDF files. More specialized analyses for antibody libraries\nlike _primer specificity_, _sequence motif analysis_, and _restriction sites analysis_ are also on the list.\n\nThis program is intended to be used in conjunction with [`abseqR`](https://github.com/malhamdoosh/abseqR),\na reporting and statistical analysis package for the data generated by `abseqPy`. Although `abseqPy` works fine _without_ `abseqR`, it is highly recommended that users also install the R package in order to take the advantage of the interactive HTML reporting capabilities of the pipeline. `abseqR`'s project page shows a few [examples](https://github.com/malhamdoosh/abseqR#features) of the type of analysis `AbSeq` provides; the full documentation can be found in `abseqR`'s vignette.\n\n## Developers\n* `AbSeq` is developed by Monther Alhamdoosh and JiaHong Fong\n* For comments and suggestions, email m.hamdoosh \\<at\\> gmail \\<dot\\> com\n\n\n# Prerequisites\n\n`abseqPy` depends on a few external software to work and they should be properly\ninstalled and configured before running `abseqPy`.\n\n> `abseqPy` runs on Python 2.7. Python 3.6 support is underway.\n\n\n## Seamless installation of dependencies \n\nThis is the __recommended way__ of installing abseqPy's external dependencies.\n\nA python script is available [here](install_dependencies.py) which downloads and installs all the necessary external dependencies.\n\nThis script assumes the following is already available:\n* [perl](https://www.perl.org/get.html)\n* [git](https://git-scm.com/)\n* [python](https://www.python.org)\n* [Java JRE](http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html) version 1.6 or higher\n* [C/C++ compilers](https://gcc.gnu.org/) (not required for Windows)\n* [make](https://en.wikipedia.org/wiki/Make_(software)) (not required for Windows)\n* [CMake](https://cmake.org/) (not required for Windows)\n\nTo install external dependencies into a folder named `~/.local/abseq`:\n\n```bash\n$ mkdir -p ~/.local/abseq\n$ python install_dependencies.py ~/.local/abseq\n```\n\n> This script does _not_ install `abseqPy` itself, only its external dependencies.\n\nThis script works with Python 2 and 3, and `~/.local/abseq` can be replaced with any directory.\nHowever:\n* this directory will be there to stay, so choose wisely\n* the installation script will dump more than just binaries in this directory, it will contain databases and internal files\n \nas soon as the installation succeeds, users will be prompted with an onscreen message\nto update their environment variables to include installed dependencies in `~/.local/abseq`.\n\n## Manual installation of dependencies\n\nThis section is for when one:\n\n1. finds that the installation script failed\n2. is feeling adventurous\n\nrefer to [this document](DEPS_INSTALL.md) for a detailed guide.\n\n\n# abseqPy installation\n\nThis section demonstrates how to install `abseqPy`.\n\n## Install from `pip`\n\n```bash\n$ pip install abseqPy\n```\n\n## Install from source\n\n```bash\n$ git clone https://github.com/malhamdoosh/abseqPy.git\n$ cd abseqPy\n$ pip install .\n$ abseq --version\n```\n\nThe `abseq` command should now be available on your command line.\n\n> installing `abseqPy` also installs other python packages, consider using a python virtual environment to prevent \noverriding existing packages. See [virtualenv](https://packaging.python.org/guides/installing-using-pip-and-virtualenv/)\nor [conda](https://conda.io/docs/user-guide/tasks/manage-environments.html).\n\n\n# Usage\n\n## Basic usage\n\nTo get up and running, the following command is often sufficient:\n\n```bash\n$ abseq -f1 <read 1> -f2 <read 2> -o results --threads 4 --task all\n```\n\n`-f2` is only required if it is a paired-end sequencing experiment.\n\n\n### Advanced usage\n\nBesides calling `abseq` with command line options, `abseq` also supports `-y <file>` or `--yaml <file>` \nthat reads parameters defined in `file`. This enables multiple samples to be analyzed at the same time, each\nhaving shared or independent `abseq` parameters.\n\nThe basic YAML syntax of `file` is `key: val` where `key `is an `abseq`\n\"long\"<sup name=\"sup1\">[1](#foot1)</sup> option (see `abseq --help` for all the \"long\" option names) and\n`val` is the value supplied to the \"long\" option. Additional samples are specified one after another\nseparated by triple dashes `---`.\n\n\n###### Example\nAssuming a file named `example.yml` has the following content:\n\n```yaml\n# sample one, PCR1\nname: PCR1\nfile1: fastq/PCR1_R1.fastq.gz\nfile2: fastq/PCR1_R2.fastq.gz\n---\n# sample two, PCR2\nname: PCR2\nfile1: fastq/PCR2_R1.fastq.gz\nfile2: fastq/PCR2_R2.fastq.gz\nbitscore: 300                 # override the defaults' 350 for this sample only\ntask: abundance               # override the defaults' \"all\" for this sample only\ndetailedComposition: ~        # enables detailedComposition (-dc) for this sample only\n---\n# more samples can go here\n---\n# \"defaults\" is the only special key allowed.\n# It is not in abseq's options, but is used here\n# to denote default values to be used for ALL samples\n# if they're not specified.\ndefaults:\n    task: all\n    outdir: results\n    threads: 7\n    bitscore: 350\n    sstart: 1-3\n```\n\nthen executing `abseq -y example.yml` is equivalent to simultaneously running 2 instances of\n`abseq` with the parameters in the `defaults` field applied to both samples. Here's an\nequivalent:\n\n```bash\n$ abseq --task all --outdir results --threads 7 --bitscore 350 --sstart 1-3 \\\n>   --name PCR1 --file1 fastq/PCR1_R1.fastq.gz --file2 fastq/PCR1_R2.fastq.gz\n$ abseq --task abundance --outdir results --threads 7 --bitscore 300 --sstart 1-3 \\\n>   --name PCR2 --file1 fastq/PCR2_R1.fastq.gz --file2 fastq/PCR2_R2.fastq.gz \\\n>   --detailedComposition \n```\nUsing `--yaml` is recommended because it is self-documenting, reproducible, and simple to run.\n\n### Gotchas\n\n1. In the above example, specifying `threads: 7` in the `defaults` key of `example.yml` will run _each_ sample with\n7 threads, that is, `abseqPy` will be running with 7 * `number of samples` total processes.\n\n## Help\n\nInvoking `abseq -h` in the command line will display the options `abseqPy` uses.\n\n# Supported platforms\n\n`abseqPy` works on most Linux distros, macOS, and Windows.\n\nSome features are *disabled* when running in *Windows* due to software incompatibility, they are:\n\n* Upstream clustering in `--task 5utr`\n* Sequence logo generation in `--task diversity`\n\n---\n\n<small><b id=\"foot1\">1</b></small><small> long option names are option names with a double dash prefix, for example,\n`--help` is a long option while `-h` is not [\u21a9](#sup1)</small>",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/malhamdoosh/abseqPy",
        "keywords": "",
        "license": "",
        "maintainer": "Jia Hong Fong",
        "maintainer_email": "jiahfong@gmail.com",
        "name": "abseqPy",
        "package_url": "https://pypi.org/project/abseqPy/",
        "platform": "",
        "project_url": "https://pypi.org/project/abseqPy/",
        "project_urls": {
            "Homepage": "https://github.com/malhamdoosh/abseqPy"
        },
        "release_url": "https://pypi.org/project/abseqPy/0.99.4/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Quality control pipeline for antibody libraries",
        "version": "0.99.4"
    },
    "last_serial": 5455296,
    "releases": {
        "0.99.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6a4dfaa5b056c0b9a64063f6f68f596f",
                    "sha256": "39e52071a703a4a13da55f046f996f73aaeacae55e3fa6438c9b291d31d3d0ab"
                },
                "downloads": -1,
                "filename": "abseqPy-0.99.0.tar.gz",
                "has_sig": false,
                "md5_digest": "6a4dfaa5b056c0b9a64063f6f68f596f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 279849,
                "upload_time": "2018-10-05T09:52:23",
                "url": "https://files.pythonhosted.org/packages/af/46/d6871620e3def421514791766bace890804fdee4db8829cfb1176e675eff/abseqPy-0.99.0.tar.gz"
            }
        ],
        "0.99.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "df074bb5eb4c540864b3f702acd71e3c",
                    "sha256": "2e1e32e7a631afa7ec09231e03dd69d483adce8ecdba67607df765ad11ffabb8"
                },
                "downloads": -1,
                "filename": "abseqPy-0.99.1.tar.gz",
                "has_sig": false,
                "md5_digest": "df074bb5eb4c540864b3f702acd71e3c",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 301524,
                "upload_time": "2019-04-24T05:40:55",
                "url": "https://files.pythonhosted.org/packages/a2/83/292bf28949a1a6e7ff2b7726e71d0af7afbec3cc59832c2cf4186ca4df29/abseqPy-0.99.1.tar.gz"
            }
        ],
        "0.99.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "443bc472ec743707d8de3781732e193f",
                    "sha256": "717391ab756b6bd1ac9056a76bcf03c442c77a0f4025de05ff5463fe683f2a66"
                },
                "downloads": -1,
                "filename": "abseqPy-0.99.2.tar.gz",
                "has_sig": false,
                "md5_digest": "443bc472ec743707d8de3781732e193f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 301568,
                "upload_time": "2019-04-25T23:57:58",
                "url": "https://files.pythonhosted.org/packages/0f/ed/0c9cdaf9c8e6a1d87bfb9ee3aa0208b9723ae1a61b2ad613470756792abd/abseqPy-0.99.2.tar.gz"
            }
        ],
        "0.99.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "997b3018f48fccbf2a531917acb9ffed",
                    "sha256": "2520fa822426fd514347a4f046c271bb93ef81727981b5ff6903dc0931f33110"
                },
                "downloads": -1,
                "filename": "abseqPy-0.99.4-py2.7-macosx-10.6-x86_64.egg",
                "has_sig": false,
                "md5_digest": "997b3018f48fccbf2a531917acb9ffed",
                "packagetype": "bdist_egg",
                "python_version": "2.7",
                "requires_python": null,
                "size": 832443,
                "upload_time": "2019-06-27T06:32:40",
                "url": "https://files.pythonhosted.org/packages/31/ce/da802cb87bd34a475a7e88e939fcfc017dbdd85269fdacda107955553d82/abseqPy-0.99.4-py2.7-macosx-10.6-x86_64.egg"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "694f32932decc02c0730f08533fad5fe",
                    "sha256": "b85cc56604f4140073acfa4bdd44d158c4477ccb86a6dad76968f6c73bdb638e"
                },
                "downloads": -1,
                "filename": "abseqPy-0.99.4.tar.gz",
                "has_sig": false,
                "md5_digest": "694f32932decc02c0730f08533fad5fe",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 301725,
                "upload_time": "2019-06-27T06:32:42",
                "url": "https://files.pythonhosted.org/packages/11/81/ee45c75a7222afaeebdd7dc01f1a1fa952101b87920c7da1b264910ad317/abseqPy-0.99.4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "997b3018f48fccbf2a531917acb9ffed",
                "sha256": "2520fa822426fd514347a4f046c271bb93ef81727981b5ff6903dc0931f33110"
            },
            "downloads": -1,
            "filename": "abseqPy-0.99.4-py2.7-macosx-10.6-x86_64.egg",
            "has_sig": false,
            "md5_digest": "997b3018f48fccbf2a531917acb9ffed",
            "packagetype": "bdist_egg",
            "python_version": "2.7",
            "requires_python": null,
            "size": 832443,
            "upload_time": "2019-06-27T06:32:40",
            "url": "https://files.pythonhosted.org/packages/31/ce/da802cb87bd34a475a7e88e939fcfc017dbdd85269fdacda107955553d82/abseqPy-0.99.4-py2.7-macosx-10.6-x86_64.egg"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "694f32932decc02c0730f08533fad5fe",
                "sha256": "b85cc56604f4140073acfa4bdd44d158c4477ccb86a6dad76968f6c73bdb638e"
            },
            "downloads": -1,
            "filename": "abseqPy-0.99.4.tar.gz",
            "has_sig": false,
            "md5_digest": "694f32932decc02c0730f08533fad5fe",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 301725,
            "upload_time": "2019-06-27T06:32:42",
            "url": "https://files.pythonhosted.org/packages/11/81/ee45c75a7222afaeebdd7dc01f1a1fa952101b87920c7da1b264910ad317/abseqPy-0.99.4.tar.gz"
        }
    ]
}