{
    "info": {
        "author": "Danielle Denisko",
        "author_email": "danielle.denisko@mail.utoronto.ca",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "# PeaKO\n\n## What is peaKO?\n\nPeaKO discovers motifs in ChIP-seq datasets with knockout controls. PeaKO takes in paired wild-type/knockout BAM files in addition to several reference files, as input. It returns a file of ranked motifs (see our paper for more details).\n\n\n## Quick start\n\n### Dependencies\n\n1. Conda (Miniconda or Anaconda)\n2. MEME Suite version 4.12.0 with our CentriMo binary* (see below)\n\n### Installation\n\n1. Download peaKO's [environment](https://peako.hoffmanlab.org/data/peako-env.yml) file.\n2. Open a terminal and run `conda env create -f peako-env.yml` in your Downloads directory. This will create a Conda environment called \"peako\".\n3. Run `conda activate peako` or `source activate peako` to activate this environment.\n4. Install peaKO from PyPI by running `python3 -m pip install peako`.\n5. You can test that this worked by running `peako --help`.\n\n### Instructions for our modified CentriMo binary\n\n*Our modified CentriMo application will be incorporated in MEME Suite's next major release.\nUntil then, you may install MEME Suite from source and replace its binary with our own to use peaKO.\n\n1. Download MEME distribution 4.12.0 from the [MEME Suite Download page](http://meme-suite.org/doc/download.html).\n2. Follow the \"Quick Install\" steps on the [MEME Suite Installation page](http://meme-suite.org/doc/install.html?man_type=web) up until `make install`.\n4. After running `make install`, replace `$HOME/meme/bin/centrimo` with our [modified CentriMo binary](https://doi.org/10.5281/zenodo.3356995).\n5. Make sure that `$HOME/meme/bin` is located on your `$PATH`. You should now be able to call `centrimo --help`.\n\n\n## Usage\n\nPeaKO uses Snakemake, which is a workflow management system.\nYou can run peaKO either locally or on a compute cluster using the Slurm job scheduling system.\nTo run on Slurm, you must create your own `cluster.config` file ([template](https://peako.hoffmanlab.org/data/cluster.json)) and provide it to peaKO via `--sm-cluster-config`.\n\nEach step of the workflow either inherits from the main activated Conda environment (\"peako\") or uses its own separate environment.\nIf you are working on a compute cluster, run peaKO first with `--sm-build-envs` on a node with internet access to create these additional Conda environments.\nThen, you can run it on the cluster without internet, providing a Slurm configuration file (see above).\n\nAfter activating peaKO's Conda environment (`conda activate peako` or `source activate peako`), you can run peako as follows:\n\n`peako <outdir> <wt-bam> <ko-bam> <organism> <chr-sizes> <trf-masked-genome> <motif-database> [options]`\n\nThere are 7 required arguments. Please provide full paths for files and directories.\n\n- `outdir`: output directory (please make sure this already exists); all output directories and files will be created here\n- `wt-bam`: wild-type sample BAM file\n- `ko-bam`: knockout sample BAM file\n- `organism`: name of organism (must be either `mouse` or `human`)\n- `chr-sizes`: chromosome sizes file of reference genome (TXT)\n- `trf-masked-genome`: TRF masked reference genome file (FASTA)\n- `motif-database`: JASPAR motif database (MEME)\n\nHere are the optional arguments:\n\nGeneral:\n\n- `-h` or `--help`: access the help message and exit\n- `-V` or `--version`: show the program's version and exit\n\nPeaKO submodule:\n\n- `-j <JASPAR_ID>`: transcription factor motif JASPAR identifier (e.g. MA0083.3)\n- `-m <MOTIF>`: transcription factor motif common name (e.g. SRF)\n- `--extra`: output all intermediate peaKO files for plotting\n- `--pickle`: use pickled peaKO dictionaries from previous run \n\nSnakemake:\n\n- `--sm-build-envs`: build conda environments for workflow and exit (requires internet connection)\n- `--sm-cluster-config`: snakemake cluster configuration file (JSON)\n\n\n## Output\n\nCurrently, peaKO generates output directories and files for each step.\nThese can all be found under your provided `outdir` directory.\nPeaKO's main output file is `<outdir>/peako_out/peaKO-rankings.txt`, which contains a ranked list of motifs.\n\n\n## Additional resources\n\nSource code is available at: https://github.com/hoffmangroup/peako.\n\nWe have deposited the [current version of the code](https://doi.org/10.5281/zenodo.3338330), [example HTML and TXT CentriMo outputs](https://doi.org/10.5281/zenodo.3338324), and a [modified CentriMo binary](https://doi.org/10.5281/zenodo.3356995) on Zenodo.\n\n\n## Citation\n\nIf you found peaKO useful, please cite:\n\nDenisko D, Viner C, Hoffman MM. Motif elucidation in ChIP-seq datasets with a knockout control. BioRxiv <ID> [Preprint]. 2019. Available from: https://doi.org/<ID>\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://bitbucket.org/hoffmanlab/peako",
        "keywords": "",
        "license": "GPLv3",
        "maintainer": "",
        "maintainer_email": "",
        "name": "peako",
        "package_url": "https://pypi.org/project/peako/",
        "platform": "",
        "project_url": "https://pypi.org/project/peako/",
        "project_urls": {
            "Homepage": "https://bitbucket.org/hoffmanlab/peako"
        },
        "release_url": "https://pypi.org/project/peako/0.0.2/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "A package for discovering motifs in ChIP-seq datasets with knockout controls",
        "version": "0.0.2"
    },
    "last_serial": 5717086,
    "releases": {
        "0.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ecc823e96977d420bc0fa45abc09c1e6",
                    "sha256": "77ee69c2f95d3609ef19fe9d95e87fd957d70e5f0cec7a3a69f69bb9e277520d"
                },
                "downloads": -1,
                "filename": "peako-0.0.1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ecc823e96977d420bc0fa45abc09c1e6",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 41756,
                "upload_time": "2019-08-17T02:28:28",
                "url": "https://files.pythonhosted.org/packages/90/f5/7ff24c61940dd69c90e10c2849b5921c7e56279fc622f2b92866f7af9082/peako-0.0.1-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "39b067bec54af9c6a82718907723bd92",
                    "sha256": "fb209423e2efaf1626a4bca75c4e4ac87fc5d7df6b5640dc2e16142551d7e1f3"
                },
                "downloads": -1,
                "filename": "peako-0.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "39b067bec54af9c6a82718907723bd92",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 24802,
                "upload_time": "2019-08-17T02:28:30",
                "url": "https://files.pythonhosted.org/packages/35/b2/1d15631e6577028cfdc961333244f47921fd6f6e580722fd186ed6be0460/peako-0.0.1.tar.gz"
            }
        ],
        "0.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3eb0cbdaee5bf9732ea5b14d46c56e2a",
                    "sha256": "111fae3bdd2b5dd934804be610157b499957d93392c2e034a7f1d6fb73d41105"
                },
                "downloads": -1,
                "filename": "peako-0.0.2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "3eb0cbdaee5bf9732ea5b14d46c56e2a",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 25767,
                "upload_time": "2019-08-22T19:58:24",
                "url": "https://files.pythonhosted.org/packages/eb/ee/f7a958fd3c758e906726a416e2ebaed2ab94dd43491d18e258e9d63a6e15/peako-0.0.2-py3-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "9a4b556cc83f31bdea72fd2790a9b451",
                    "sha256": "cb7af96168ba14b85f799d52b054b6c444da299bd8f203f88b73ce5e0e3e3eda"
                },
                "downloads": -1,
                "filename": "peako-0.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "9a4b556cc83f31bdea72fd2790a9b451",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 21675,
                "upload_time": "2019-08-22T19:58:26",
                "url": "https://files.pythonhosted.org/packages/63/41/935f084a4eb119f17f057709f9c650455dcde50a5386fd7038bea2078498/peako-0.0.2.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "3eb0cbdaee5bf9732ea5b14d46c56e2a",
                "sha256": "111fae3bdd2b5dd934804be610157b499957d93392c2e034a7f1d6fb73d41105"
            },
            "downloads": -1,
            "filename": "peako-0.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "3eb0cbdaee5bf9732ea5b14d46c56e2a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 25767,
            "upload_time": "2019-08-22T19:58:24",
            "url": "https://files.pythonhosted.org/packages/eb/ee/f7a958fd3c758e906726a416e2ebaed2ab94dd43491d18e258e9d63a6e15/peako-0.0.2-py3-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "9a4b556cc83f31bdea72fd2790a9b451",
                "sha256": "cb7af96168ba14b85f799d52b054b6c444da299bd8f203f88b73ce5e0e3e3eda"
            },
            "downloads": -1,
            "filename": "peako-0.0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "9a4b556cc83f31bdea72fd2790a9b451",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 21675,
            "upload_time": "2019-08-22T19:58:26",
            "url": "https://files.pythonhosted.org/packages/63/41/935f084a4eb119f17f057709f9c650455dcde50a5386fd7038bea2078498/peako-0.0.2.tar.gz"
        }
    ]
}