checkForLegLoc: Find best place on plot for placing legend

In wrGraph: Graphics in the Context of Analyzing High-Throughput Data

Find best place on plot for placing legend

Description

This function tries to find the best location for placing a legend of a bivariate plot, ie scatter-plot. All 4 corners of the data to plot are inspected for the least occupation by data plotted while displaying the content of sampleGrp. Alternatively, by setting the argument showLegend the user-defined legend will be returned

Usage

checkForLegLoc(
  matr,
  sampleGrp = NULL,
  showLegend = TRUE,
  suplSpace = 4,
  testCorner = 1:4,
  silent = TRUE,
  debug = FALSE,
  callFrom = NULL
)

Arguments

matr	(matrix, list or data.frame) main data of plot
sampleGrp	(character or factor) with this option the text to be displayed in the legend may be taken into consideration for its length
showLegend	(logical or character) decide if matr should be checked for best location; if showLegend contains any of the standard legend-location designations (eg 'topleft') it will be used in the output
suplSpace	(numeric) allows to consider extra room taken in legend by symbol and surrounding space, interpreted as n additional characters
testCorner	(integer) which corners should be considered (1=left-top, 2=right-top, right-bottom, left-bottom)
silent	(logical) suppress messages
debug	(logical) additonal messages for debugging
callFrom	(character) allows easier tracking of messages produced

Value

list with $showL indicating if legend is desired and $loc for the proposition of the best location, $nConflicts gives the counts of conflicts

See Also

legend

Examples

dat1 <- matrix(c(1:5,1,1:5,5), ncol=2)
grp <- c("abc","efghijk")
(legLoc <- checkForLegLoc(dat1, grp)) 
plot(dat1, cex=3)
legend(legLoc$loc, legend=grp, text.col=2:3, pch=1, cex=0.8)

wrGraph documentation built on Oct. 20, 2023, 5:08 p.m.