R: Add points to a plotting region

circos.points {circlize} | R Documentation

## Add points to a plotting region

### Description

Add points to a plotting region

### Usage

    circos.points(x, y, sector.index = get.cell.meta.data("sector.index"),
        track.index = get.cell.meta.data("track.index"),
        pch = par("pch"), col = par("col"), cex = par("cex"), bg = par("bg"))

### Arguments

`x` | Data points on x-axis, measured in "current" data coordinate
`y` | Data points on y-axis, measured in "current" data coordinate
`sector.index` | Index for the sector
`track.index` | Index for the track
`pch` | Point type
`col` | Point color
`cex` | Point size
`bg` | backgrond of points

### Details

This function can only add points in one specified cell. Pretending a low-level plotting function, it can only be applied in plotting region which has been created.

You can think the function similar as the normal `points` function, just adding points in the circular plotting region. The position of cell is identified by `sector.index` and `track.index`, if they are not specified, they are in 'current' sector and 'current' track.

Data points out of the plotting region will also be added, but with warning messages.

Other graphics parameters which are available in the function are `pch`, `col` and `cex` which have same meaning as those in the `par`.

It is recommended to use `circos.points` inside `panel.fun` in `circos.trackPlotRegion` so that it draws points directly on "curent" cell.

### References

Gu, Z. (2014) circlize implements and enhances circular visualization in R. Bioinformatics.

### Examples

    circos.initialize(letters[1:8], xlim = c(0, 1))
    circos.track(ylim = c(0, 1), panel.fun = function(x, y) {
        circos.points(runif(10), runif(10))
    })
    circos.points(runif(10), runif(10), sector.index = "c", pch = 16, col = "red")
    circos.clear()

[Package circlize version 0.4.5 Index]