PCoA_bubble.py =============== Create a series of Principal Coordinate plots for each OTU in an input list where the plot points are varied in size by the relative abundance of the OTU (relative to either Sample or the total contribution of the OTU to the data set. .. code-block:: bash usage: PCoA_bubble.py [-h] -i OTU_TABLE -m MAPPING -pc PCOA_FP -b GROUP_BY [-c COLORS] -ids OTU_IDS_FP [-o OUTPUT_DIR] [-s SAVE_AS] [--scale_by SCALE_BY] [--ggplot2_style] [-v] Required Arguments ------------------- .. cmdoption:: -i OTU_TABLE, --otu_table OTU_TABLE The biom-format file with OTU-Sample abundance data. .. cmdoption:: -m MAPPING, --mapping MAPPING The mapping file specifying group information for each sample. .. cmdoption:: -pc PCOA_FP, --pcoa_fp PCOA_FP Principal Coordinates Analysis file. Eg. unweighted_unifrac_pc.txt, or any other output from principal_coordinates.py. .. cmdoption:: -b GROUP_BY, --group_by GROUP_BY Column name in mapping file specifying group information. .. cmdoption:: -c COLORS, --colors COLORS A column name in the mapping file containing hexadecimal (#FF0000) color values that will be used to color the groups. Each sample ID must have a color entry. .. cmdoption:: -ids OTU_IDS_FP, --otu_ids_fp OTU_IDS_FP Path to a file containing one OTU ID per line. One plot will be created for each OTU. Optional Arguments ------------------ .. cmdoption:: -o OUTPUT_DIR, --output_dir OUTPUT_DIR The directory to output the PCoA plots to. .. cmdoption:: -s SAVE_AS, --save_as SAVE_AS The type of image file for PCoA plots. By default, files will be saved in SVG format. .. cmdoption:: --scale_by SCALE_BY Species relative abundance is multiplied by this factor in order to make appropriate visible bubbles in the output plots. Default is 1000. .. cmdoption:: --ggplot2_style Apply ggplot2 styling to the figure. .. cmdoption:: -v, --verbose Displays species name as each is being plotted and saved. .. cmdoption:: -h, --help Show this help message and exit Example plot -------------- PCoA bubble plots of subgingival microbiome pathogens of smokers [1]_. .. image:: PCoA/PCoA_bubble_example_smokers_pathogens.png :scale: 50% :align: center Citation: .. [1] **The Subgingival Microbiome of Clinically Healthy Current and Never Smokers**. Matthew R Mason, Philip M Preshaw, Haikady N Nagaraja, Shareef M Dabdoub, Anis Rahman and Purnima S Kumar; doi: `10.1038/ismej.2014.114 `_