dimrename: Change dimnames, rownames, or colnames

Description Usage Arguments Details Value Examples

View source: R/rename.R

Description

These functions provide an easy way to change the dimnames, rownames or colnames of an array.

Usage

1
2
3
dimrename(x, dim = 1, ..., gsub = FALSE, fixed = TRUE, warn = TRUE)
rowrename(x, ..., gsub = FALSE, fixed = TRUE, warn = TRUE)
colrename(x, ..., gsub = FALSE, fixed = TRUE, warn = TRUE)

Arguments

x

An array with dimnames

dim

A vector that indicates the dimensions

...

A sequence of named arguments

gsub

a logical value; if TRUE, gsub is used to change the dimnames of the object. That is, instead of substituting whole names, substrings of the dimnames of the object can changed.

fixed

a logical value, passed to gsub. If TRUE, substitutions are by fixed strings and not by regular expressions.

warn

logical; should a warning be issued if the pattern is not found?

Details

dimrename changes the dimnames of x along dimension(s) dim according to the remaining arguments. The argument names are the old names, the values are the new names. rowrename is a shorthand for changing the rownames, colrename is a shorthand for changing the colnames of a matrix or matrix-like object.

If gsub is FALSE, argument tags are the old dimnames, the values are the new dimnames. If gsub is TRUE, arguments are substrings of the dimnames that are substituted by the argument values.

Value

Object x with changed dimnames.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
m <- matrix(1,2,2)
rownames(m) <- letters[1:2]
colnames(m) <- LETTERS[1:2]
m
dimrename(m,1,a="first",b="second")
dimrename(m,1,A="first",B="second")
dimrename(m,2,"A"="first",B="second")

rowrename(m,a="first",b="second")
colrename(m,"A"="first",B="second")

Example output

Loading required package: lattice
Loading required package: MASS

Attaching package: 'memisc'

The following objects are masked from 'package:stats':

    contr.sum, contr.treatment, contrasts

The following object is masked from 'package:base':

    as.array

  A B
a 1 1
b 1 1
       A B
first  1 1
second 1 1
  A B
a 1 1
b 1 1
Warning messages:
1: In dimrename(m, 1, A = "first", B = "second") :
  unused dimname(s) selected
2: In dimrename(m, 1, A = "first", B = "second") :
  unused dimname(s) selected
  first second
a     1      1
b     1      1
       A B
first  1 1
second 1 1
  first second
a     1      1
b     1      1

memisc documentation built on May 2, 2019, 5:45 p.m.

Related to dimrename in memisc...