onco.print.props: Oncoprint Proportions by Lesion Type

In GRIN2: Genomic Random Interval (GRIN)

Oncoprint Proportions by Lesion Type

Description

Calculates and assigns the proportion of each oncoprint rectangle to be color-filled based on the average size of lesion types. Lesion types are ordered by their average genomic size, and proportions are either computed automatically or manually specified by the user.

Usage

onco.print.props(lsn.data, clr = NULL, hgt = NULL)

Arguments

lsn.data	A data frame with five columns: ID: Subject or patient identifier chrom: Chromosome on which the lesion is located loc.start: Start genomic position of the lesion loc.end: End genomic position of the lesion lsn.type: Lesion category (e.g., gain, mutation, fusion)
clr	Optional. A named vector of colors for each lesion type. If not provided, default colors will be assigned using default.grin.colors.
hgt	Optional. A named numeric vector specifying the proportion (height) of the oncoprint rectangle to be filled for each lesion type. If not provided, proportions will be determined automatically based on average lesion sizes.

Details

In cases where a patient has multiple types of lesions (e.g., gain and mutation) in the same gene, this function ensures that all lesion types are visually represented within a single oncoprint rectangle.

If hgt is not specified, lesion types are ranked by their average genomic size (calculated as loc.end - loc.start + 1), and the oncoprint proportions are derived accordingly. Smaller lesions (like point mutations) will occupy a smaller portion of the rectangle, while larger lesions (like CNVs) will occupy a larger portion.

Alternatively, the user can manually define the fill proportions via the hgt parameter.

Value

A list with the following components:

• col: Named vector of colors assigned to each lesion type

• hgt: Named vector of normalized proportions to fill for each lesion type

• legend: Legend parameters for use in oncoprint plots

Author(s)

Lakshmi Patibandla [e-mail], Abdelrahman Elsayed [e-mail], Stanley Pounds [e-mail]

References

Cao, X., Elsayed, A. H., & Pounds, S. B. (2023). Statistical Methods Inspired by Challenges in Pediatric Cancer Multi-omics.

Examples

data(lesion_data)

# Automatically assign oncoprint proportions based on average lesion size:
onco.props <- onco.print.props(lesion_data)

# Alternatively, manually specify the oncoprint fill proportions for each lesion type:
onco.props <- onco.print.props(lesion_data,
                        hgt = c("gain" = 4, "loss" = 3, "mutation" = 2, "fusion" = 1))

GRIN2 documentation built on June 17, 2025, 9:11 a.m.