prepareParameters4: prepareParameters4

Description Usage Arguments Details Value Note See Also Examples

View source: R/prepareParameters4.R

Description

Prepare and normalize the parameters for functions with x0, x1 and y0, y1 parameters

Usage

1
prepareParameters4(function.name, karyoplot, data, chr, x0, x1, y0, y1, ymax, ymin, r0, r1, data.panel, filter.data=TRUE, ...)

Arguments

function.name

(character) The name of the function calling prepareParameters4. Only user for error reporting.

karyoplot

(KaryoPlot) A karyoplot object.

data

A GRanges

chr

A character representing the chromosome names.

x0

The position in the chromosome in number of bases.

x1

The position in the chromosome in number of bases.

y0

The value to be plotted.

y1

The value to be plotted.

ymax

The maximum value of y

ymin

The minimum value of y

r0

The start of the range to use for plotting

r1

The end of the range to use for plotting

data.panel

The data panel to use

filter.data

A boolean indicating if data should be filtered so only data in visible chromosomes is kept. (defaults to TRUE, filter data)

...

Any additional parameter

Details

This function prepares and normalizes the parameters for plotting functions with x0, x1, y0 and y1 parameters (as opposed to x and y) so functions can offer a richer interface while internally dealing only with standard and simple code. It extracts the positions from data if available and applies the r0 and r1 scaling. It returns the ready to plot values in a list with only chr, x0, x1, y0 and y1. All parameters are interpreted and used as explained in kpRect. It also filters out any data points corresponding to chromosomes not present in the current karyoplot.

Value

A list with five values: chr, x0, x1, y0 and y1. Each of them a vector of the same length with the normalized values to plot.

Note

This function is only useful when creating custom plotting functions. It is not intended to the general user.

For detailed documentation on the parameters, see kpRect

See Also

kpRect

Examples

1
2
3
4
kp <- plotKaryotype()
prepareParameters4("TestFunc", kp, data=NULL, chr="chr1", x0=c(10, 20, 30), x1=c(20, 30, 40), y0=c(0, 1, 2), y1=c(0.5, 1.5, 3), r0=0, r1=0.5, ymin=0, ymax=3)

 

Bioconductor-mirror/karyoploteR documentation built on July 4, 2017, 6:39 p.m.