Zoom the x-axis range for a normalizedMatrix coverage data
zoom_nmat(nmat, upstream_length = 500, downstream_length = 500, ...)
normalizedMatrix
object, where the length extended from
the target region is stored in attr(nmat, "extend")
as a two-element
integer vector representing upstream, and downstream length.
Each column indicated in attr(nmat, "upstream_index")
is expected
to represent equal-sized bins spanning that range. Columns are
retained if the farthest distance of the column is less
than upstream_length
.
numeric
coordinate maximum
range from the target center region. When either value is NULL
no threshold is applied, which is equivalent to Inf
.
The values are forced positive abs(upstream_length)
as these
are absolute magnitude length from the target region.
additional arguments are ignored.
This function is typically called by zoom_nmatlist()
but can
be called on an individual normalizedMatrix
object.
This function filters the matrix columns by distance, and updates important associated attributes:
attr(nmat, "upstream_index")
- the column index positions upstream the target region
attr(nmat, "downstream_index")
- the column index positions downstream the target region
attr(nmat, "target_index")
- the column index positions representing the target region
attr(nmat, "extend")
- the genomic distance upstream and downstream the target region
Other jam coverage heatmap functions:
coverage_matrix2nmat()
,
get_nmat_ceiling()
,
nmathm_row_order()
,
nmatlist2heatmaps()
,
validate_heatmap_params()
,
zoom_nmatlist()