# CIDC NGS Pipeline API
![Continuous Integration](https://github.com/CIMAC-CIDC/cidc-ngs-pipeline-api/workflows/Continuous%20Integration/badge.svg?branch=master) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
### Overview
This repository serves as an interface between the CIDC and Bioinformatics teams to determine specifications and documentation related to NGS pipelines.
Repository structure:
```
.
├── README.md
├── cidc_ngs_pipeline_api
│ ├── output_API.schema.json
│ ├── rna
│ │ ├── rna.md
│ │ ├── rna_config.schema.json
│ │ ├── rna_output_API.json
│ │ └── imgs
│ | └── RIMA.png
│ ├── atacseq
│ │ ├── atacseq.md
│ │ ├── atacseq_output_API.json
│ │ └── imgs
│ | └── atacseq.png
│ ├── tcr
│ │ ├── tcr.md
│ │ └── imgs
│ | └── TCRseq.png
│ └── wes
│ ├── wes.md
│ ├── wes_config.schema.json
│ ├── wes_output_API.json
│ ├── wes_tumor_only_output_API.json
│ ├── wes_output_API.py
│ └── imgs
│ └── wes.png
├── tests
│ └── test_apis.py
├── requirements.dev.txt
├── requirements.txt
├── MANIFEST.in
├── CHANGELOG.md
├── setup.py
└── .github
└── workflows
└── ci.yml
```
## cidc_ngs_pipeline_api module
* The `output_API.schema.json` file defines the schema structure:
- `filter_group`: Filter under which the file would appear during faceted search. It is the GCS-URI top-level hierarchy
- `file_path_template`: Local file path used for CLI upload
- `short_description`: Description to appear on hovering over file name in file browser
- `long_description`: Longer description to appear on file documentation page
- `file_purpose`: Assigns a tag to show up in a particular file-browser view configuration. Permissible values: `Source view`, `Analysis view`, `Clinical view`, `Miscellaneous`
* Within the directory for each assay:
* The defined schema is used to structure information about pipeline-related files in the respective `< assay >_output_API.json`.
* Information related to YAML configurations (which are generated by the CIDC and configured with CIMAC IDs to run the pipelines), are described in the respective `< assay > config.schema.json`.
* Documentation related to each pipeline is in the respective `< assay > .md`.
### Developer Setup
Install necessary dependencies.
```bash
pip install -r requirements.dev.txt
```
Install and configure pre-commit hooks.
```bash
pre-commit install
```
Raw data
{
"_id": null,
"home_page": "https://github.com/CIMAC-CIDC/cidc-ngs-pipeline-api",
"name": "cidc-ngs-pipeline-api",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "cidc_ngs_pipeline_api",
"author": "Stephen C van Nostrand",
"author_email": "vannost@ds.dfci.harvard.edu",
"download_url": "https://files.pythonhosted.org/packages/a7/6d/0daf41ca23eaf3cbe13a444dc7fb8aba5c860469d739ca4bcf67afcdc870/cidc_ngs_pipeline_api-0.1.24.tar.gz",
"platform": null,
"description": "# CIDC NGS Pipeline API\n\n![Continuous Integration](https://github.com/CIMAC-CIDC/cidc-ngs-pipeline-api/workflows/Continuous%20Integration/badge.svg?branch=master) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) \n\n### Overview\nThis repository serves as an interface between the CIDC and Bioinformatics teams to determine specifications and documentation related to NGS pipelines.\n\nRepository structure:\n```\n.\n\u251c\u2500\u2500 README.md\n\u251c\u2500\u2500 cidc_ngs_pipeline_api\n\u2502 \u251c\u2500\u2500 output_API.schema.json\n\u2502 \u251c\u2500\u2500 rna\n\u2502 \u2502\u00a0\u00a0 \u251c\u2500\u2500 rna.md\n\u2502 \u2502\u00a0\u00a0 \u251c\u2500\u2500 rna_config.schema.json\n\u2502 \u2502\u00a0\u00a0 \u251c\u2500\u2500 rna_output_API.json\n\u2502 \u2502\u00a0\u00a0 \u2514\u2500\u2500 imgs\n\u2502 | \u2514\u2500\u2500 RIMA.png\n\u2502 \u251c\u2500\u2500 atacseq\n\u2502 \u2502\u00a0\u00a0 \u251c\u2500\u2500 atacseq.md\n\u2502 \u2502\u00a0\u00a0 \u251c\u2500\u2500 atacseq_output_API.json\n\u2502 \u2502\u00a0\u00a0 \u2514\u2500\u2500 imgs\n\u2502 | \u2514\u2500\u2500 atacseq.png\n\u2502 \u251c\u2500\u2500 tcr\n\u2502 \u2502\u00a0\u00a0 \u251c\u2500\u2500 tcr.md\n\u2502 \u2502\u00a0\u00a0 \u2514\u2500\u2500 imgs\n\u2502 | \u2514\u2500\u2500 TCRseq.png\n\u2502 \u2514\u2500\u2500 wes\n\u2502 \u251c\u2500\u2500 wes.md\n\u2502 \u251c\u2500\u2500 wes_config.schema.json\n\u2502 \u251c\u2500\u2500 wes_output_API.json\n\u2502 \u251c\u2500\u2500 wes_tumor_only_output_API.json\n\u2502 \u251c\u2500\u2500 wes_output_API.py\n\u2502 \u00a0 \u2514\u2500\u2500 imgs\n\u2502 \u2514\u2500\u2500 wes.png\n\u251c\u2500\u2500 tests\n\u2502 \u2514\u2500\u2500 test_apis.py\n\u251c\u2500\u2500 requirements.dev.txt\n\u251c\u2500\u2500 requirements.txt\n\u251c\u2500\u2500 MANIFEST.in\n\u251c\u2500\u2500 CHANGELOG.md\n\u251c\u2500\u2500 setup.py\n\u2514\u2500\u2500 .github\n \u2514\u2500\u2500 workflows\n \u2514\u2500\u2500 ci.yml\n \n```\n\n## cidc_ngs_pipeline_api module\n\n* The `output_API.schema.json` file defines the schema structure:\n - `filter_group`: Filter under which the file would appear during faceted search. It is the GCS-URI top-level hierarchy\n - `file_path_template`: Local file path used for CLI upload\n - `short_description`: Description to appear on hovering over file name in file browser\n - `long_description`: Longer description to appear on file documentation page\n - `file_purpose`: Assigns a tag to show up in a particular file-browser view configuration. Permissible values: `Source view`, `Analysis view`, `Clinical view`, `Miscellaneous`\n \n* Within the directory for each assay:\n \n * The defined schema is used to structure information about pipeline-related files in the respective `< assay >_output_API.json`.\n\n * Information related to YAML configurations (which are generated by the CIDC and configured with CIMAC IDs to run the pipelines), are described in the respective `< assay > config.schema.json`.\n\n * Documentation related to each pipeline is in the respective `< assay > .md`.\n\n### Developer Setup\n\nInstall necessary dependencies.\n\n```bash\npip install -r requirements.dev.txt\n```\n\nInstall and configure pre-commit hooks.\n\n```bash\npre-commit install\n```\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "The CIDC NGS Pipeline output APIs",
"version": "0.1.24",
"split_keywords": [
"cidc_ngs_pipeline_api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2b9ff690446b9072a14f476c4044d4c313c48c79ec3fb76fe90cd347d4f936f5",
"md5": "46e1fba524d2495723a279f4633c8d3e",
"sha256": "6aa3c42509fda8413ca39732c270093e7e4f4646967656f67ca61181c5a96d9d"
},
"downloads": -1,
"filename": "cidc_ngs_pipeline_api-0.1.24-py3-none-any.whl",
"has_sig": false,
"md5_digest": "46e1fba524d2495723a279f4633c8d3e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 2343399,
"upload_time": "2023-04-27T14:15:06",
"upload_time_iso_8601": "2023-04-27T14:15:06.018873Z",
"url": "https://files.pythonhosted.org/packages/2b/9f/f690446b9072a14f476c4044d4c313c48c79ec3fb76fe90cd347d4f936f5/cidc_ngs_pipeline_api-0.1.24-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a76d0daf41ca23eaf3cbe13a444dc7fb8aba5c860469d739ca4bcf67afcdc870",
"md5": "d8fcf7fb03f6a346d4cdb8dba56828fe",
"sha256": "f680e6a56dbd79d2edd8bbabfa24cbb0b5e226a6d8c79e57cb9342e84f9a28a2"
},
"downloads": -1,
"filename": "cidc_ngs_pipeline_api-0.1.24.tar.gz",
"has_sig": false,
"md5_digest": "d8fcf7fb03f6a346d4cdb8dba56828fe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 2342291,
"upload_time": "2023-04-27T14:15:11",
"upload_time_iso_8601": "2023-04-27T14:15:11.101066Z",
"url": "https://files.pythonhosted.org/packages/a7/6d/0daf41ca23eaf3cbe13a444dc7fb8aba5c860469d739ca4bcf67afcdc870/cidc_ngs_pipeline_api-0.1.24.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-27 14:15:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "CIMAC-CIDC",
"github_project": "cidc-ngs-pipeline-api",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "jsonschema",
"specs": [
[
"==",
"3.0.1"
]
]
}
],
"lcname": "cidc-ngs-pipeline-api"
}