BioVenn 1.1.3
BioVenn: Create Area-Proportional Venn Diagrams from Biological Lists

Draw an area-proportional Venn diagram of 2 or 3 circles
========================================================

The draw_venn function creates an area-proportional Venn diagram of 2 or 3 circles, based on lists of (biological) identifiers. It requires three parameters: input lists X, Y and Z. For a 2-circle Venn diagram, one of these lists should be left empty. Duplicate identifiers are removed automatically, and a mapping from Entrez and/or Affymetrix to Ensembl IDs is available. BioVenn is case-sensitive. In SVG mode, text and numbers can be dragged and dropped.  

When using this BioVenn Python package for a publication, please cite:  
[T. Hulsen, BioVenn - an R and Python package for the comparison and visualization of biological lists using area-proportional Venn diagrams. Data Science 2021, 4 (1): 51-61, https://dx.doi.org/10.3233/ds-210032](https://dx.doi.org/10.3233/ds-210032)  
and  
[T. Hulsen, BioVenn: Create Area-Proportional Venn Diagrams from Biological Lists. Python Package Version 1.1.3, https://pypi.org/project/BioVenn/](https://pypi.org/project/BioVenn/)

Parameters
----------

list_x (Required) List with IDs from dataset X  
list_y (Required) List with IDs from dataset Y  
list_z (Required) List with IDs from dataset Z  
title (Optional) The title of the Venn diagram (default is "BioVenn")  
t_f (Optional) The font of the main title (default is "serif")  
t_fb (Optional) The font "face" of the main title (default is "bold")  
t_s (Optional) The size of the main title (default is 20)  
t_c (Optional) The colour of the main title (default is "black")  
subtitle (Optional) The subtitle of the Venn diagram (default is "(C) 2007-2020 Tim Hulsen")  
st_f (Optional) The font of the subtitle (default is "serif")  
st_fb (Optional) The font "face" of the subtitle (default is "bold")  
st_s (Optional) The size of the subtitle (default is 15)  
st_c (Optional) The colour of the subtitle (default is "black")  
xtitle (Optional) The X title of the Venn diagram (default is "ID set X")  
xt_f (Optional) The font of the X title (default is "serif")  
xt_fb (Optional) The font "face" of the X title (default is "bold")  
xt_s (Optional) The size of the X title (default is 10)  
xt_c (Optional) The colour of the X title (default is "black")  
ytitle (Optional) The Y title of the Venn diagram (default is "ID set Y")  
yt_f (Optional) The font of the Y title (default is "serif")  
yt_fb (Optional) The font "face" of the Y title (default is "bold")  
yt_s (Optional) The size of the Y title (default is 10)  
yt_c (Optional) The colour of the Y title (default is "black")  
ztitle (Optional) The Z title of the Venn diagram (default is "ID set Z")  
zt_f (Optional) The font of the Z title (default is "serif")  
zt_fb (Optional) The font "face" of the Z title (default is "bold")  
zt_s (Optional) The size of the Z title (default is 10)  
zt_c (Optional) The colour of the Z title (default is "black")  
nrtype (Optional) The type of the numbers to be displayed: absolute (abs) numbers or percentages (pct) (default is "abs")  
nr_f (Optional) The font of the numbers (default is "serif")  
nr_fb (Optional) The font "face" of the numbers (default is "bold")  
nr_s (Optional) The size of the numbers (default is 10)  
nr_c (Optional) The colour of the numbers (default is "black")  
x_c (Optional) The colour of the X circle (default is "red")  
y_c (Optional) The colour of the X circle (default is "green")  
z_c (Optional) The colour of the X circle (default is "blue")  
bg_c (Optional) The background colour (default is "white")  
width (Optional) The width of the output file (in pixels for BMP/JPEG/PNG/TIF or in centiinch for PDF/SVG; default is 1000)  
height (Optional) The height of the output file (in pixels for BMP/JPEG/PNG/TIF or in centiinch for PDF/SVG; default is 1000)  
output (Optional) Output format: "bmp", "jpg", "pdf", "png", "svg" or "tif" (anything else writes to the screen; default is "screen")  
filename (Optional) The name of the output file (default is "biovenn" + extension of the selected output format)  
map2ens (Optional) Map from Entrez or Affymetrix IDs to Ensembl IDs (default is False)

Returns
-------

An image of the Venn diagram is generated in the desired output format.  
Also returns an object with thirteen lists: X, Y, Z, X only, Y only, Z only, XY, XZ, YZ, XY only, XZ only, YZ only, XYZ.

Example
-------

list_x = ("1007_s_at","1053_at","117_at","121_at","1255_g_at","1294_at")  
list_y = ("1255_g_at","1294_at","1316_at","1320_at","1405_i_at")  
list_z = ("1007_s_at","1405_i_at","1255_g_at","1431_at","1438_at","1487_at","1494_f_at")  
biovenn = draw_venn(list_x, list_y, list_z, subtitle="Example diagram", nrtype="abs")