{"id":35039474,"url":"https://github.com/xapple/pacmill","last_synced_at":"2026-05-22T19:31:40.511Z","repository":{"id":57450200,"uuid":"278197300","full_name":"xapple/pacmill","owner":"xapple","description":"The `pacmill` python package is a bioinformatics pipeline that is developed to process microbial 16S amplicon sequencing data and produce PDF reports detailing taxonomical assignments along with other statistics.","archived":false,"fork":false,"pushed_at":"2022-05-19T14:14:29.000Z","size":15662,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-03-21T23:17:27.025Z","etag":null,"topics":["16s-rrna","bioinformatics-pipeline","dna-sequences","pacbio-data","pdf-reports"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xapple.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-07-08T21:24:04.000Z","updated_at":"2025-12-18T06:12:23.000Z","dependencies_parsed_at":"2022-08-25T23:00:32.668Z","dependency_job_id":null,"html_url":"https://github.com/xapple/pacmill","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/xapple/pacmill","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xapple%2Fpacmill","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xapple%2Fpacmill/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xapple%2Fpacmill/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xapple%2Fpacmill/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xapple","download_url":"https://codeload.github.com/xapple/pacmill/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xapple%2Fpacmill/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33362361,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T12:23:38.849Z","status":"online","status_checked_at":"2026-05-22T02:00:06.671Z","response_time":265,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["16s-rrna","bioinformatics-pipeline","dna-sequences","pacbio-data","pdf-reports"],"created_at":"2025-12-27T08:11:15.142Z","updated_at":"2026-05-22T19:31:40.468Z","avatar_url":"https://github.com/xapple.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![PyPI version](https://badge.fury.io/py/pacmill.svg)](https://badge.fury.io/py/pacmill)\n\n# `pacmill` version 0.5.4\n\nThe `pacmill` python package is a bioinformatics pipeline that is developed to process microbial 16S amplicon sequencing data. It is specialized in the analysis of long reads such as those provided by PacBio sequencers.\n\n## Prerequisites\n\nSince `pacmill` is written in python, it is compatible with all operating systems: Linux, macOS and Windows. The only prerequisite is `python3` (which is often installed by default) along with the `pip3` package manager.\n\nTo check if you have `python3` installed, type the following on your terminal:\n\n    $ python3 -V\n\nIf you do not have `python3` installed, please refer to the section [obtaining python3](docs/markdown/installing_tips.md#obtaining-python3).\n\nTo check if you have `pip3` installed, type the following on your terminal:\n\n    $ pip3 -V\n\nIf you do not have `pip3` installed, please refer to the section [obtaining pip3](docs/markdown/installing_tips.md#obtaining-pip3).\n\n## Installing\n\nTo install the `pacmill` package, simply type the following commands on your terminal:\n\n    $ pip3 install --user pacmill\n\nAlternatively, if you want to install it for all users of the system:\n\n    $ sudo pip3 install pacmill\n\nThese commands will also automatically install all the other python modules on which `pacmill` depends.\n\n## External programs\n\nThe `pacmill` pipeline also depends on several shell commands being available. The following executables should be present in your `$PATH` environment variable:\n\n* `fastQValidator`, `fastqc`, `barrnap`, `vsearch`, `mothur`, `xelatex`, `fastq-dump`\n\nIf any of these required external programs are missing, you will be prompted to install them and given easy instructions to do so.\n\n## Usage\n\n### Metadata\n\nThe first thing to do when starting a new analysis is to fill in a metadata file that details all there is to know about the biological samples being processed.\n\nAn empty template for such a file is found under this repository at `pacmill/metadata/metadata_blank.xlsx`. You can make a copy of this file for every new project.\n\n In addition, another file named `pacmill/metadata/metadata_example.xlsx` shows typical values that the fields are supposed to take along with a short documentation for each entry. A excerpt of this file is shown below:\n\n \u003cp align=\"center\"\u003e\n \u003cimg src=\"docs/images/metadata_screenshot.png?raw=true\"\u003e\n \u003c/p\u003e\n\n### Loading the project\n\nBellow are some examples to illustrate the various ways there are to use this package.\n\n    # This example is not completed yet. TODO.\n\n### Customizing report headers\n\nTo change the text that appears inside the header of the PDF reports generated, you can adjust these three environment variables to your liking. Credit is appreciated where credit is due, but the software has a very permissive license that lets you decide what is best.\n\n    $ export PACMILL_HEADER=\"From the \\textbf{pacmill} project\"\n    $ export PACMILL_SUBHEADER=\"Written by consultants at \\url{www.sinclair.bio}\"\"\n    $ export PACMILL_LINK=\"Hosted at \\url{www.github.com/xapple/pacmill}\"\n\n## Demo project\n\nIn order to test and evaluate the pipeline, we have provided a demonstration project ready to be processed. This enables the user to see what type of outputs are generated by `pacmill` without having to bring his own DNA sequence data. Five samples are included and are taken from the following publication:\n\n* \"Confident phylogenetic identification of uncultured prokaryotes through long read amplicon sequencing of the 16S-ITS-23S rRNA operon.''\n* Joran Martijn, [many others], Thijs Ettema.\n* Science for Life Laboratory, Uppsala University\n* https://doi.org/10.1111/1462-2920.14636\n\nThe samples are publicly accessible on SRA and are described as follows:\n\n* `mock`: Genomic DNA from 38 phylogenetically distinct and diverse bacteria and archaea.\n* `p19`: Sediment sample obtained from hot spring Radiata Pool, Ngatamariki, New Zealand.\n* `pm3`: Sediment sample taken from 1.25m below the sea floor using a gravity core at Aarhus Bay, Denmark.\n* `sala`: Black biofilm that was taken at 60m depth in an old silver mine near Sala, Sweden.\n* `tns08`: Sediment sample taken from a shallow submarine hydrothermal vent field near Taketomi Island, Japan.\n\nTo run the demo project, do the following:\n\n    # This example is not completed yet. TODO.\n\n## Example graphs\n\nThe `pacmill` pipeline produces a multitude of graphs and visualizations after having processed the sequence data. Below are two examples. Firstly a sequence length distribution of cleaned reads. Secondly, a barstack of taxonomic assignments for five different samples at the phylum level.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/images/demo_len_hist.png?raw=true\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/images/demo_barstack.png?raw=true\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/images/demo_legend.png?raw=true\"\u003e\n\u003c/p\u003e\n\n## Example reports\n\nAfter running the pipeline on a set of FASTQ files, several PDF reports are auto-generated. Examples of three reports are given below. The first concerns an individual sample while the second details the results of a project containing several samples. The third focuses on taxonomic assignment results and visualizations.\n\n\u003cp align=\"center\"\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\n        \u003ca href=\"https://xapple.github.io/pacmill/demo_reports/project.pdf\"\u003e\n        \u003cimg src=\"docs/images/pdf_icon.png\" width=\"120em\"\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n        \u003ca href=\"https://xapple.github.io/pacmill/demo_reports/sample.pdf\"\u003e\n        \u003cimg src=\"docs/images/pdf_icon.png\" width=\"120em\"\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n    \u003ctd\u003e\n        \u003ca href=\"https://xapple.github.io/pacmill/demo_reports/taxonomy.pdf\"\u003e\n        \u003cimg src=\"docs/images/pdf_icon.png\" width=\"120em\"\u003e\n        \u003c/a\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n     \u003ctd\u003e\u003cp align=\"center\"\u003eProject report\u003c/p\u003e\u003c/td\u003e\n     \u003ctd\u003e\u003cp align=\"center\"\u003eSample report\u003c/p\u003e\u003c/td\u003e\n     \u003ctd\u003e\u003cp align=\"center\"\u003eTaxonomy report\u003c/p\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\u003c/p\u003e\n\n## Flowchart\n\nBelow is presented a flowchart detailing the multiple processing steps that occur in the `pacmill` pipeline in a chronological order.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"docs/images/flowchart.png?raw=true\"\u003e\n\u003c/p\u003e\n\n\n## Extra documentation\n\nMore documentation is available at:\n\n\u003chttp://xapple.github.io/pacmill/pacmill\u003e\n\nThis documentation is simply generated from the source code with:\n\n    $ pdoc --html --output-dir docs --force pacmill","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxapple%2Fpacmill","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxapple%2Fpacmill","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxapple%2Fpacmill/lists"}