R: Create a Satellite object

satellite {satellite} | R Documentation

## Create a Satellite object

### Description

Method to create a Satellite object.

### Usage

    ## S4 method for signature 'character'
    satellite(x, meta, log)

    ## S4 method for signature 'Raster'
    satellite(x, meta, log)

    ## S4 method for signature 'list'
    satellite(x, meta, log)

### Arguments

`x` | A vector of filenames, a (multi-layered) `Raster*` object or a `list` of single `RasterLayer` objects (see `raster`). In the latter case, be aware that bands must be arranged in ascending order (eg using `sortFilesLandsat`).
`meta` | Optional metadata object (e.g. returned from `compMetaLandsat`). If 'x' is a satellite dataset and recognised as "Landsat", then the metadata is automatically extracted from the respective meta information file if both the satellite data and the metadata file follow the USGS Earth Explorer's naming convention.
`log` | Optionally supply a log entry.

### Details

A Satellite object consists of three data sections: (i) a raster data section which holds the actual data values of the respective sensor bands, (ii) a metadata grid which holds meta information for each sensor band (e.g. calibration coefficients, type of sensor band etc.) and (iii) a list of log information which records the processing history of the entire dataset.

### Value

A `Satellite` object.

### See Also

(i) `compMetaLandsat` to get more information about the structure of the metadata component; (ii) https://landsat.usgs.gov/what-are-naming-conventions-landsat-scene-identifiers for detailed information about the naming conventions for Landsat scene identifiers; and (iii) `sortFilesLandsat` for automated rearrangement of Landsat band files.

### Examples

    ## 'character' input (i.e. filenames)
    path <- system.file("extdata", package = "satellite")
    files <- list.files(path, pattern = glob2rx("LC08*.TIF"), full.names = TRUE)

    satellite(files)

    ## raster::RasterStack input
    satellite(l8)

[Package satellite version 1.0.1 Index]