Skip to content


bycon Plot functionality

Starting with version v1.0.30 (2023-04-14) the bycon package added the ability to produce the typical Progenetix-style CNV histograms and CNV sample plots. These plots can both be generated by adding the respective output=... option to standard Beacon queries or through use of the bycon package to visualize data from local storage. Plotting from local .pgxseg ... file is possible but so far we don't provide a ready-made for that.

Changes 2023-10-23 The plotting of is now hadled by dedicated endpoints in /services:

  • /services/collationplots for pre-computed frequency histograms and heatstrips
  • /services/sampleplots for query-derived sample plots (including histograms)
    • plot selection through plotType= with options histoplot, samplesplot and histoheatplot
    • defaults to histoplot if unspecified

Plot types

CNV histograms - /services/collationplots

CNV histograms can be generated either (fast) for one or multiple of the "collations" i.e. samples sharing a common code (diagnosis, technnique...) or identifier (cell line id, PMID ...), or as single histogram for the output of a Beacon query.

A complete list of collations can be retrieved through the /services/collations/ endpoint, e.g. /services/collations?datasetIds=progenetix&output=text.

Please note that the datasetIds parameter will fall back to the default parameter if not indicated.


CNV sample plots - /services/sampleplots

Sample selection based plotting uses the standard bycon query stack for sample retrieval (i.e. aggregation over the data model) and then generates CNV plots from the found samples, either as clustered individual profiles or as binned frequency plot data (histograms or heatstrips).

CAVE: Sample plots are very time consuming due to the retrieval and plotting of all variants per sample.


Plot parameters

Plot parameters can be given both in snake_case and in the corresponding camelCase format (plot_area_width or plotAreaWidth).

Parameter definitions

Plot parameters