# unitname

##### Name for Unit of Length

Inspect or change the name of the unit of length in a spatial dataset.

##### Usage

```
unitname(x)
unitname(x) <- value
# S3 method for im
unitname(x)
# S3 method for owin
unitname(x)
# S3 method for ppp
unitname(x)
# S3 method for psp
unitname(x)
# S3 method for quad
unitname(x)
# S3 method for tess
unitname(x)
# S3 method for im
unitname(x) <- value
# S3 method for owin
unitname(x) <- value
# S3 method for ppp
unitname(x) <- value
# S3 method for psp
unitname(x) <- value
# S3 method for quad
unitname(x) <- value
# S3 method for tess
unitname(x) <- value
```

##### Arguments

- x
A spatial dataset. Either a point pattern (object of class

`"ppp"`

), a line segment pattern (object of class`"psp"`

), a window (object of class`"owin"`

), a pixel image (object of class`"im"`

), a tessellation (object of class`"tess"`

), a quadrature scheme (object of class`"quad"`

), or a fitted point process model (object of class`"ppm"`

or`"kppm"`

or`"slrm"`

or`"dppm"`

or`"minconfit"`

).- value
Name of the unit of length. See Details.

##### Details

Spatial datasets in the spatstat package may include the name of the unit of length. This name is used when printing or plotting the dataset, and in some other applications.

`unitname(x)`

extracts this name,
and `unitname(x) <- value`

sets the name to `value`

.

A valid name is either

a single character string

a vector of two character strings giving the singular and plural forms of the unit name

a list of length 3, containing two character strings giving the singular and plural forms of the basic unit, and a number specifying the multiple of this unit.

Note that re-setting the name of the unit of length *does not*
affect the numerical values in `x`

. It changes only the string
containing the name of the unit of length. To rescale the numerical
values, use `rescale`

.

##### Value

The return value of `unitname`

is an object of class `"unitname"`

containing the name of the unit of length in `x`

. There are
methods for `print`

, `summary`

, `as.character`

,
`rescale`

and `compatible`

.

##### See Also

##### Examples

```
# NOT RUN {
X <- runifrect(20)
# if the unit of length is 1 metre:
unitname(X) <- c("metre", "metres")
# if the unit of length is 6 inches:
unitname(X) <- list("inch", "inches", 6)
# }
```

*Documentation reproduced from package spatstat.geom, version 1.65-5, License: GPL (>= 2)*