R语言【raster】——raster()：创建一个RasterLayer对象

Package raster version 3.6-27

Description

创建RasterLayer对象的方法。RasterLayer对象可以从无到有，一个文件，一个范围对象，一个矩阵，一个“图像”对象，或者从Raster*， Spatial*， im (spatstat) asc, kasc (adehabitat*)， grf (geoR)或kde对象创建。

在许多情况下，例如，当一个RasterLayer是从一个文件中创建的，它(最初)不包含任何单元格(像素)值在(RAM)内存中，它只有描述RasterLayer的参数。您可以使用getValues、extract和相关函数访问单元格值。你可以用setValues和replacement来赋值。

Usage

## S4 method for signature 'character'
raster(x, band=1, ...)

## S4 method for signature 'RasterLayer'
raster(x) 

## S4 method for signature 'RasterStack'
raster(x, layer=0) 

## S4 method for signature 'RasterBrick'
raster(x, layer=0) 

## S4 method for signature 'missing'
raster(nrows=180, ncols=360, xmn=-180, xmx=180, ymn=-90, ymx=90, 
		crs, ext, resolution, vals=NULL)

## S4 method for signature 'Extent'
raster(x, nrows=10, ncols=10, crs="", ...)

## S4 method for signature 'matrix'
raster(x, xmn=0, xmx=1, ymn=0, ymx=1, crs="", template=NULL)

## S4 method for signature 'Spatial'
raster(x, origin, ...) 

## S4 method for signature 'SpatialGrid'
raster(x, layer=1, values=TRUE)

## S4 method for signature 'SpatialPixels'
raster(x, layer=1, values=TRUE)

## S4 method for signature 'sf'
raster(x, origin, ...) 

Arguments

参数【x】：filename (character)， Extent, Raster*， sf, SpatialPixels*， SpatialGrid*， object， 'image'， matrix, im，或missing。支持的文件类型是“本地”光栅包格式和GDAL可以读取的文件类型。

参数【band】：整数值。在多层文件中使用的层。

参数【...】：其他参数，见Details。

参数【layer】：整数值。在多层文件中使用的层(变量)，或者从RasterStack/Brick或SpatialPixelsDataFrame或SpatialGridDataFrame中提取的层。如果layer=0，则返回一个空的RasterLayer(没有关联值)。

参数【values】：逻辑值。如果为TRUE， 'x'的单元格值被复制到返回的RasterLayer对象中。

参数【nrows】：大于0的整数值。行数量。

参数【ncols】：大于0的整数值。列数量。

参数【xmn】：最小的 x 坐标（左边界）。

参数【xmx】：最大的 x 坐标（右边界）。

参数【ymn】：最小的 y 坐标（下边界）。

参数【ymx】：最大的 y 坐标（上边界）。

参数【ext】：类Extent的对象。如果存在，则忽略参数 xmn、xmx、ymn和ymx。

参数【crs】：字符值或类CRS的对象。project .4坐标参考系(地图投影)的类型描述。如果缺少这个参数，并且x坐标在-360-360度，y坐标在-90-90度，就使用“+proj=longlat +datum=WGS84”。如果x是一个字符(filename)，请参见Details。

参数【resolution】：长度为1或2的数字向量，用于设置分辨率(参见res)。如果使用此参数，则忽略参数ncols和nrows。

参数【vals】：可选项。新光栅层的值。接受的格式与setValues一样。

参数【origin】：最小的 y 坐标值（下边界）。

参数【template】：Raster*或Extent对象用于设置范围(在Raster*对象的情况下是CRS)。如果不是NULL，则忽略参数xmn, xmx, ymn, ymx和crs(除非模板是Extent对象)。

Details

如果x是文件名，则识别以下附加参数：

参数【sub】：正整数。包含子数据集的文件的子数据集号。

参数【native】：逻辑值。默认为FALSE。如果为TRUE, IDRISI、BIL、BSQ、BIP、SAGA和Arc ASCII文件的读写是通过本地(raster包)驱动程序完成的，而不是通过GDAL。'raster'和netcdf格式文件总是通过本地驱动程序读取。

参数【RAT】：逻辑值。默认值为TRUE，在这种情况下，将为具有栅格属性表的文件创建栅格属性表。

参数【offset】：整数值。指示非标准ascii文件的头行数(很少有用;请谨慎使用)。

参数【crs】：字符值。用于设置CRS的PROJ.4字符串。当文件提供可解释的CRS描述时忽略。

如果x表示NetCDF文件，则识别以下附加参数：

参数【varname】：字符值。变量名，如'tasmax'或'pr'。如果没有提供，并且文件有多个变量，则会进行猜测(并报告)。

参数【lvar】：大于0的整数值（默认为3）。如果文件有4个维度(例如深度而不是时间)，选择要使用的“level变量”(第三维度变量)。

参数【level】：大于0的整数值（默认为1）。选择使用的纬度，如果文件有四个维度，例如，创建一个RasterBrick天气随时间在一定高度。

要使用NetCDF文件，nccd4包需要可用。假设这些文件遵循或兼容CF-1约定(GMT格式也可以工作)。如果ncdf文件没有标准扩展名(用于识别文件格式)，则可以使用参数ncdf=TRUE来指示格式。

如果x是一个空间或范围对象，则附加参数用于签名为“missing”的方法。

Value

RasterLayer。