terra (version 0.5-2)

xyRowColCell: Coordinates from a row, column or cell number and vice versa

Description

Get coordinates of the center of raster cells for a row, column, or cell number of a SpatRaster object. Or get row, column, or cell numbers from coordinates or from each other.

Cell numbers start at 1 in the upper left corner, and increase from left to right, and then from top to bottom. The last cell number equals the number of cells of the SpatRaster object. row numbers start at 1 at the top, column numbers start at 1 at the left.

Usage

# S4 method for SpatRaster,numeric
xFromCol(object, col)
# S4 method for SpatRaster,numeric
yFromRow(object, row)
# S4 method for SpatRaster,numeric
xyFromCell(object, cell, ...)
# S4 method for SpatRaster,numeric
xFromCell(object, cell)
# S4 method for SpatRaster,numeric
yFromCell(object, cell)
# S4 method for SpatRaster,numeric
colFromX(object, x)
# S4 method for SpatRaster,numeric
rowFromY(object, y)
# S4 method for SpatRaster,numeric,numeric
cellFromRowCol(object, row, col, ...)
# S4 method for SpatRaster,numeric,numeric
cellFromRowColCombine(object, row, col, ...)
# S4 method for SpatRaster,numeric
rowFromCell(object, cell)
# S4 method for SpatRaster,numeric
colFromCell(object, cell)
# S4 method for SpatRaster,numeric
rowColFromCell(object, cell)
# S4 method for SpatRaster,matrix
cellFromXY(object, xy)

Arguments

object

SpatRaster

cell

integer. cell number(s)

col

integer. column number(s)

row

integer row number(s)

x

x coordinate(s)

y

y coordinate(s)

xy

matrix of x and y coordinates

...

additional arguments. None implemented

Value

xFromCol, yFromCol, xFromCell, yFromCell: vector of x or y coordinates

xyFromCell: matrix(x,y) with coordinate pairs

colFromX, rowFromY, cellFromXY, cellFromRowCol, rowFromCell, colFromCell: vector of row, column, or cell numbers

rowColFromCell: matrix of row and column numbers

Details

Cell numbers start at 1 in the upper left corner, and increase from left to right, and then from top to bottom. The last cell number equals the number of cells of the SpatRaster (see ncell).

Examples

# NOT RUN {
r <- rast()

xFromCol(r, c(1, 120, 180))
yFromRow(r, 90)
xyFromCell(r, 10000)
xyFromCell(r, c(0, 1, 32581, ncell(r), ncell(r)+1))

cellFromRowCol(r, 5, 5)
cellFromRowCol(r, 1:2, 1:2)
cellFromRowCol(r, 1, 1:3)

# all combinations 
cellFromRowColCombine(r, 1:2, 1:2)

colFromX(r, 10)
rowFromY(r, 10)
cellFromXY(r, cbind(c(10,5), c(15, 88)))
# }