# rescale.im

From spatstat v1.16-3
by Adrian Baddeley

##### Convert Pixel Image to Another Unit of Length

Converts a pixel image to another unit of length.

##### Usage

```
## S3 method for class 'im':
rescale(X, s)
```

##### Arguments

- X
- Pixel image (object of class
`"im"`

). - s
- Conversion factor: the new units are
`s`

times the old units.

##### Details

This is a method for the generic function `rescale`

.

The spatial coordinates of the pixels in `X`

will be re-expressed
in terms of a new unit of length that is `s`

times the current
unit of length given in `X`

.
(Thus, the coordinate values are *divided* by `s`

,
while the unit value is multiplied by `s`

).

The result is a pixel image representing the *same* data
but re-expressed in a different unit.

Pixel values are unchanged.

##### Value

- Another pixel image (of class
`"im"`

), containing the same pixel values, but with pixel coordinates expressed in the new units.

##### See Also

##### Examples

```
# Bramble Canes data: 1 unit = 9 metres
data(bramblecanes)
# distance transform
Z <- distmap(bramblecanes)
# convert to metres
# first alter the pixel values
Zm <- eval.im(9 * Z)
# now rescale the pixel coordinates
Zm <- rescale(Zm, 1/9)
```

*Documentation reproduced from package spatstat, version 1.16-3, License: GPL (>= 2)*

### Community examples

Looks like there are no examples yet.