Plots & Data Visualizations¶
The standard format for (plot-)images generated on Progenetix is Scalable Vector Graphics (SVG). As the name implies, SVG is scalable, i.e. images can be scaled up without loosing quality or expanding in storage size. However, some of teh generated images use also embedded rastered components which will deteriorate during scaling - this is e.g. the case for array probe plots.
All major modern web browsers—including Mozilla Firefox, Internet Explorer, Google Chrome, Opera, Safari, and Microsoft Edge—have SVG rendering support.
On most pages where plots are being displayed there is a download option for the images - (please alert us where those are missing). Browsers also have the option to export SVGs themselves e.g. as PDF.
The PGX plotting library¶
Plots on Progenetix are generated using the PGX package, a set of Perl libraries for processing and graphical representation of CNV data. The package contains tools to
- read and write e.g. Progentix segment files
- generate binned status maps
- render plots of sample-specific and aggregate CNV data, such as histograms and CNV frequency heatmaps
CNV Histogram Plots¶
There are two possibilities to plot CNV histograms through the Progenetix API w/o using the user interface:
- direct visualization of pre-computed collations, e.g. publications or diagnosttic entities
- a Beacon API query with the added option
Please use option 1 if accessing complete entities (i.e. only using a single
filters value) - this option is not limited through large sample numbers.
- customized plot for glioblastoma CNV frequencies, limited to chromosomes 7, 9 and 10
Additional plot parameters¶
Plot parameters can be added to the request using a standard
- comma-concatenated list of chromosomes to plot
- default is 1 -> 22 since X & Y are not always correctly normalized for CNV
- modifies the width of the plot image in px (default 800)
- height of the plot area (excluding labels etc.) in px (default 100)
- size in px of the title text (default 14)
- modifies the histogram's maximum value in percent (default 100)
- arbitrary labels (e.g. for genes or other regions of interest)
- format is
- multiple labels can be concatenated by
- colors are randomized from a "decent" palette
- text size for the labels (default 10)
- opacity of the region overlay on the plot (default 0.2)
- change of colors used for gains and losses