Skip to contents
Chapters and reference

Complete canonical API text; task articles explain the workflows. Usage guide

Reads four columns, converts zero-based half-open coordinates to one-based inclusive positions, and retains every finite signed value and source row. Missing intervals remain absent: no zero filling, interpolation, sorting or aggregation is performed. Overlapping rows are retained as observations, not silently resolved into a single value. Choose any summarisation explicitly.

Usage

R · Example code
read_bedgraph(file = NULL, files = NULL, source_file = FALSE)

Arguments

file

Optional input path vector or glob patterns, before files.

files

Optional additional paths or wildcard patterns for bedGraph files.

source_file

Logical. Add .source_file to each row, default FALSE.

Value

A data frame with accver, start, end, value, original chromStart, chromEnd, dataValue and physical .source_line. The ggchord_import attribute records conventions, per-file row counts, and unchanged headers. When combining different signals, keep source_file = TRUE and select each signal's layers/scales explicitly. Coordinate units follow source metadata.

Details

A file contains one signal. More than one track definition is rejected; split different browser tracks explicitly rather than mixing their domains. Comments and display headers are retained in import provenance. Their colour, smoothing and other display instructions never configure a ggchord plot. Sequence identifiers, including literal track/browser, are retained verbatim. Neither value units nor sequencing coverage are inferred from the file name.

Examples

R · Example code
# Actual 100-bp-window GC percentages; not measured read coverage.
path <- system.file("extdata", "pUC19-gc-100.bedGraph", package = "ggchord")
signal <- read_bedgraph(path)
head(signal)
#>   accver start end value chromStart chromEnd dataValue .source_line
#> 1  pUC19     1 100    60          0      100        60            4
#> 2  pUC19   101 200    57        100      200        57            5
#> 3  pUC19   201 300    59        200      300        59            6
#> 4  pUC19   301 400    54        300      400        54            7
#> 5  pUC19   401 500    53        400      500        53            8
#> 6  pUC19   501 600    49        500      600        49            9

Search documentation

↑ ↓ select · Enter open · Esc close; or browse by task. API and functions