GRIN2 (version 2.0.0)

onco.print.props: 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)

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

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.

Author

Lakshmi Patibandla , Abdelrahman Elsayed , Stanley Pounds

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.

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))