[](https://gitpod.io/#https://github.com/rpetit3/camlhmp)
# camlhmp
🐪 camlhmp 🐪 - Classification through yAML Heuristic Mapping Protocol
`camlhmp` is a tool for generating organism typing tools from YAML schemas. Through discussions
with Tim Read, we identified a need for a straightforward method to define and manage typing
schemas for organisms of interest. YAML was chosen for its simplicity and readability.
Full documentation for `camlhmp` can be found at [https://rpetit3.github.io/camlhmp/](https://rpetit3.github.io/camlhmp/).
## Purpose
The primary purpose of `camlhmp` is to provide a framework that enables researchers to
_independently_ define typing schemas for their organisms of interest using YAML. This
approach facilitates the management and analysis biological data for researchers at any
level of experience.
`camlhmp` does not supply pre-defined typing schemas. Instead, it equips researchers
with the necessary tools to create and maintain their own schemas, ensuring these schemas
can easily remain up to date with the latest scientific developments.
Finally, the development of `camlhmp` was driven by a practical need to streamline
maintenance of multiple organism typing tools. Managing these tools separately is
time-consuming and challenging. `camlhmp` simplifies this by providing a single
framework for each tool.
## Installation
`camlhmp` is available through [PyPI](https://pypi.org/project/camlhmp/) and
[Bioconda](https://bioconda.github.io/recipes/camlhmp/README.html). While you can install it
through PyPi, it is recommended to install it through BioConda so that non-Python dependencies
are also installed.
```bash
conda create -n camlhmp -c conda-forge -c bioconda camlhmp
conda activate camlhmp
camlhmp
```
## Citing `camlhmp`
If you make use of `camlhmp` in your analysis, please cite the following:
- __camlhmp__
_Petit III RA, Read TD [camlhmp: Classification through yAML Heuristic Mapping Protocol](https://github.com/rpetit3/camlhmp) (GitHub)_
- __[BLAST+](https://blast.ncbi.nlm.nih.gov/Blast.cgi)__
_Camacho C, Coulouris G, Avagyan V, Ma N, Papadopoulos J, Bealer K, Madden TL [BLAST+: architecture and applications](http://dx.doi.org/10.1186/1471-2105-10-421). BMC Bioinformatics 10, 421 (2009)_
## Naming
If I'm being honest, I really wanted to name a tool with "camel" in it because they are my
wife's favorite animal🐪 and they also remind me of my friends in Oman!
Once it was decided YAML was going to be the format for defining schemas, I quickly stumbled
on "Classification through YAML" and quickly found out I wasn't the only once who thought
of "CAML". But, no matter, it was decided it would be something with "CAML", then Tim Read
came with the save and suggested "Heuristic Mapping Protocol". So, here we are - _camlhmp_!
## License
I'm not a lawyer and MIT has always been my go-to license. So, MIT it is!
## Funding
Support for this project came (in part) from the [Wyoming Public Health Division](https://health.wyo.gov/publichealth/), and
the [Center for Applied Pathogen Epidemiology and Outbreak Control (CAPE)](https://www.linkedin.com/company/center-for-applied-pathogen-epidemiology-and-outbreak-control/).
Raw data
{
"_id": null,
"home_page": "https://github.com/rpetit3/camlhmp",
"name": "camlhmp",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.11",
"maintainer_email": null,
"keywords": "bioinformatics, bacteria, serotype, genotype",
"author": "Robert A. Petit III",
"author_email": "robbie.petit@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/28/5f/e09389884c8aff1b357b6de0e4574480d4765d2772a97a8d9e9354dcf42c/camlhmp-1.1.0.tar.gz",
"platform": null,
"description": "[](https://gitpod.io/#https://github.com/rpetit3/camlhmp)\n\n# camlhmp\n\n\ud83d\udc2a camlhmp \ud83d\udc2a - Classification through yAML Heuristic Mapping Protocol\n\n`camlhmp` is a tool for generating organism typing tools from YAML schemas. Through discussions\nwith Tim Read, we identified a need for a straightforward method to define and manage typing\nschemas for organisms of interest. YAML was chosen for its simplicity and readability.\n\nFull documentation for `camlhmp` can be found at [https://rpetit3.github.io/camlhmp/](https://rpetit3.github.io/camlhmp/).\n\n## Purpose\n\nThe primary purpose of `camlhmp` is to provide a framework that enables researchers to\n_independently_ define typing schemas for their organisms of interest using YAML. This\napproach facilitates the management and analysis biological data for researchers at any\nlevel of experience.\n\n`camlhmp` does not supply pre-defined typing schemas. Instead, it equips researchers\nwith the necessary tools to create and maintain their own schemas, ensuring these schemas\ncan easily remain up to date with the latest scientific developments.\n\nFinally, the development of `camlhmp` was driven by a practical need to streamline\nmaintenance of multiple organism typing tools. Managing these tools separately is\ntime-consuming and challenging. `camlhmp` simplifies this by providing a single\nframework for each tool.\n\n## Installation\n\n`camlhmp` is available through [PyPI](https://pypi.org/project/camlhmp/) and\n[Bioconda](https://bioconda.github.io/recipes/camlhmp/README.html). While you can install it\nthrough PyPi, it is recommended to install it through BioConda so that non-Python dependencies\nare also installed.\n\n```bash\nconda create -n camlhmp -c conda-forge -c bioconda camlhmp\nconda activate camlhmp\ncamlhmp\n```\n\n## Citing `camlhmp`\n\nIf you make use of `camlhmp` in your analysis, please cite the following:\n\n- __camlhmp__ \n_Petit III RA, Read TD [camlhmp: Classification through yAML Heuristic Mapping Protocol](https://github.com/rpetit3/camlhmp) (GitHub)_ \n\n- __[BLAST+](https://blast.ncbi.nlm.nih.gov/Blast.cgi)__ \n_Camacho C, Coulouris G, Avagyan V, Ma N, Papadopoulos J, Bealer K, Madden TL [BLAST+: architecture and applications](http://dx.doi.org/10.1186/1471-2105-10-421). BMC Bioinformatics 10, 421 (2009)_ \n\n## Naming\n\nIf I'm being honest, I really wanted to name a tool with \"camel\" in it because they are my\nwife's favorite animal\ud83d\udc2a and they also remind me of my friends in Oman!\n\nOnce it was decided YAML was going to be the format for defining schemas, I quickly stumbled\non \"Classification through YAML\" and quickly found out I wasn't the only once who thought\nof \"CAML\". But, no matter, it was decided it would be something with \"CAML\", then Tim Read\ncame with the save and suggested \"Heuristic Mapping Protocol\". So, here we are - _camlhmp_!\n\n## License\n\nI'm not a lawyer and MIT has always been my go-to license. So, MIT it is!\n\n## Funding\n\nSupport for this project came (in part) from the [Wyoming Public Health Division](https://health.wyo.gov/publichealth/), and\nthe [Center for Applied Pathogen Epidemiology and Outbreak Control (CAPE)](https://www.linkedin.com/company/center-for-applied-pathogen-epidemiology-and-outbreak-control/).\n\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Classification through yAML Heuristic Mapping Protocol",
"version": "1.1.0",
"project_urls": {
"Homepage": "https://github.com/rpetit3/camlhmp",
"Repository": "https://github.com/rpetit3/camlhmp"
},
"split_keywords": [
"bioinformatics",
" bacteria",
" serotype",
" genotype"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ba0565cf4b93f789b3af187aee45486ca51312d4e18279f7be9b449198b29e1d",
"md5": "c12770b74a5fcd096ae22cb902ca4467",
"sha256": "46ec2773c96a9e640114aec8e75a013eb92732ca70c7d6232f193c028025f6bd"
},
"downloads": -1,
"filename": "camlhmp-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c12770b74a5fcd096ae22cb902ca4467",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.11",
"size": 28562,
"upload_time": "2024-08-25T16:53:16",
"upload_time_iso_8601": "2024-08-25T16:53:16.458065Z",
"url": "https://files.pythonhosted.org/packages/ba/05/65cf4b93f789b3af187aee45486ca51312d4e18279f7be9b449198b29e1d/camlhmp-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "285fe09389884c8aff1b357b6de0e4574480d4765d2772a97a8d9e9354dcf42c",
"md5": "f48fdf40a43e68a215df80232706f3c5",
"sha256": "0f20b94fc0bd469299bd9bec6fe384013bd7043cb4dd97e9df827895f2d06fb2"
},
"downloads": -1,
"filename": "camlhmp-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "f48fdf40a43e68a215df80232706f3c5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.11",
"size": 18486,
"upload_time": "2024-08-25T16:53:17",
"upload_time_iso_8601": "2024-08-25T16:53:17.746780Z",
"url": "https://files.pythonhosted.org/packages/28/5f/e09389884c8aff1b357b6de0e4574480d4765d2772a97a8d9e9354dcf42c/camlhmp-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-25 16:53:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rpetit3",
"github_project": "camlhmp",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "camlhmp"
}
JSON
