adrop | R Documentation |
Drop degenerate dimensions of an array object. Offers less
automaticity and more control than the base drop()
function.
adrop()
is a S3 generic, with one method, adrop.default
,
supplied in the abind
package.
adrop(x, drop = TRUE, named.vector = TRUE, one.d.array = FALSE, ...)
x |
An array (including a matrix) |
drop |
A logical or numeric vector describing exactly which dimensions to
drop. It is intended that this argument be supplied always. The
default is very rarely useful ( |
named.vector |
Optional, defaults to |
one.d.array |
Optional, defaults to |
... |
There are no additional arguments allowed for
|
Dimensions can only be dropped if their extent is one, i.e., dimension
i
of array x
can be dropped only if dim(x)[i]==1
.
It is an error to request adrop
to drop a dimension whose
extent is not 1.
A 1-d array can be converted to a named vector by supplying
drop=NULL
(which means drop no dimensions, and return a 1-d
array result as a named vector).
If x
is an object with a dim
attribute (e.g., a matrix or
array
), then adrop
returns an object like x
,
but with the requested
extents of length one removed. Any accompanying dimnames
attribute is adjusted and returned with x
.
Tony Plate tplate@acm.org
abind
x <- array(1:24,dim=c(2,3,4),dimnames=list(letters[1:2],LETTERS[1:3],letters[23:26]))
adrop(x[1,,,drop=FALSE],drop=1)
adrop(x[,1,,drop=FALSE],drop=2)
adrop(x[,,1,drop=FALSE],drop=3)
adrop(x[1,1,1,drop=FALSE],drop=1)
adrop(x[1,1,1,drop=FALSE],drop=2)
adrop(x[1,1,1,drop=FALSE],drop=3)
adrop(x[1,1,1,drop=FALSE],drop=1:2)
adrop(x[1,1,1,drop=FALSE],drop=1:2,one.d=TRUE)
adrop(x[1,1,1,drop=FALSE],drop=1:2,named=FALSE)
dim(adrop(x[1,1,1,drop=FALSE],drop=1:2,one.d=TRUE))
dimnames(adrop(x[1,1,1,drop=FALSE],drop=1:2,one.d=TRUE))
names(adrop(x[1,1,1,drop=FALSE],drop=1:2,one.d=TRUE))
dim(adrop(x[1,1,1,drop=FALSE],drop=1:2))
dimnames(adrop(x[1,1,1,drop=FALSE],drop=1:2))
names(adrop(x[1,1,1,drop=FALSE],drop=1:2))
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.