# Module Documentation: eml-spatialRaster | Back to EML Contents

### The eml-spatialRaster module - Logical information about regularly gridded geospatial image data

The eml-spatialRaster module allows for the description of entities composed of rectangular grids of data values that are usually georeferenced to a portion of the earth's surface. Specific attributes of a spatial raster can be documented here including the spatial organization of the raster cells, the cell data values, and if derived via imaging sensors, characteristics about the image and its individual bands.

## Module details

Recommended Usage: | all spatial datasets that use spatial gridded data
Stand-alone: | yes
Imports: | eml-documentation, eml-spatialReference, eml-coverage, eml-entity, eml-resource, eml-attribute, eml-constraint
Imported By: |
View an image of the schema: | eml-spatialRaster image

## Element Definitions:
#### spatialRaster | This element has no default value.
Content of this field: | Description of this field:
Type: SpatialRasterType
| Description of a GIS layer composed of raster pixels comprising a regular-pattern grid. Generally, a raster object may be thought of as a pattern of closely spaced rows of dots that collectively form an image. Raster spatial objects are used to locate zero-, two-, or three-dimensional locations in the dataset Example(s): An interpolated grid of irregularly spaced data is an example of this element.
#### attributeList | This element has no default value.
Content of this field: | Description of this field:
Type: att:AttributeListType
| The list of attributes associated with this entity. For more information see the eml-attribute module.
#### constraint | This element has no default value.
Content of this field: | Description of this field:
Type: con:ConstraintType
| Description of any relational constraints on this entity. For more information see the eml-constraint module.
#### spatialReference | This element has no default value.
Content of this field: | Description of this field:
Type: spref:SpatialReferenceType
| Spatial Referencing systems define the coordinates used to describe horizontal and vertical locations. These are typically either geographic, projected planar, or arbitrary planar.
#### georeferenceInfo | This element has no default value.
Content of this field: | Description of this field:
Elements: | Use: | How many:
A choice of (
cornerPoint | required | 4
OR
controlPoint | required | unbounded
OR
bilinearFit | required |
)
| Information on how to position the grid within the coordinate system defined in the spatial reference module.
#### cornerPoint | This element has no default value.
Content of this field: | Description of this field:
Elements: | Use: | How many:
A sequence of (
xCoordinate | required |
yCoordinate | required |
pointInPixel | required |
corner | required |
)
| Location of a corner on the coordinate system defined in the spatial reference module. Use this element when the rows and columns of the grid are aligned with the coordinate system. One or more corner points are needed to locate a rectified grid.
#### xCoordinate | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Location of the georeferencing point expressed in units of the coordinate system defined in the spatial Reference module. Example(s): 455000
#### yCoordinate | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Y Location of the georeferencing point expressed in units of the coordinate system defined in the spatial Reference module. Example(s): 3455000
#### pointInPixel | This element has no default value.
Content of this field: | Description of this field:
| Location within the pixel of the georeferencing point. Example(s): upperLeft
Derived from: xs:string (by xs:restriction) Allowed values: upperLeft upperRight lowerRight lowerLeft center
#### corner | This element has no default value.
Content of this field: | Description of this field:
Type: rasterOriginType
| Identification of the corner in the grid corresponding to the coordinates provided. Example(s): Upper Left
#### controlPoint | This element has no default value.
Content of this field: | Description of this field:
Elements: | Use: | How many:
A sequence of (
column | required |
row | required |
xCoordinate | required |
yCoordinate | required |
pointInPixel | required |
)
| If the grid is rectified to the coordinate system, then a single point may be used to position the grid. Otherwise, a series of points is necessary to fit the grid to the coordinate system.
#### column | This element has no default value.
Content of this field: | Description of this field:
Type: xs:int
| Column location of the georeferencing point indicated as the nth column counting the cell indicated in rasterOrigin as column 1. Example(s): 1
#### row | This element has no default value.
Content of this field: | Description of this field:
Type: xs:int
| Row location of the georeferencing point indicated as the nth row counting the cell indicated in rasterOrigin as row 1. Example(s): 1
#### xCoordinate | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Location of the georeferencing point expressed in units of the coordinate system defined in the spatial Reference module. Example(s): 455000
#### yCoordinate | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Y Location of the georeferencing point expressed in units of the coordinate system defined in the spatial Reference module. Example(s): 3455000
#### pointInPixel | This element has no default value.
Content of this field: | Description of this field:
| Location within the pixel of the georeferencing point. Example(s): upperLeft
Derived from: xs:string (by xs:restriction) Allowed values: upperLeft upperRight lowerRight lowerLeft center
#### bilinearFit | This element has no default value.
Content of this field: | Description of this field:
Elements: | Use: | How many:
A sequence of (
xIntercept | required |
xSlope | required |
yIntercept | required |
ySlope | required |
)
| Intercept and slope terms to describe the orientation and position of the grid to the coordinate system based on corner point identified in the rasterOrigin element. defined in the spatial Reference module.
#### xIntercept | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| X Intercept of the rasterOrigin point within the coordinate system. Example(s): 3455000
#### xSlope | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Slope describing transformation of grid cell distances into x coordinates. Example(s): 5.0123
#### yIntercept | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Location of the rasterOrigin point on the y axis of the the coordinate system. Example(s): 455000
#### ySlope | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Slope describing transformation of grid cell distances into y axis coordinates. Example(s): 5.0123
#### horizontalAccuracy | This element has no default value.
Content of this field: | Description of this field:
Type: DataQuality
| Horizontal accuracy may be reported either as a quantitative estimate expressed in the units of the coordinate system or as a text assessment.
#### verticalAccuracy | This element has no default value.
Content of this field: | Description of this field:
Type: DataQuality
| Vertical accuracy may be reported either as a quantitative estimate expressed in the units of the height or depth measurement system or as a text assessment.
#### cellSizeXDirection | This element has no default value.
Content of this field: | Description of this field:
| Cell sizes should be expressed in the units declared in the spatialReference module. Example(s): 28.5
#### cellSizeYDirection | This element has no default value.
Content of this field: | Description of this field:
| Cell sizes should be expressed in the units declared in the spatialReference module. Example(s): 28.5
#### numberOfBands | This element has no default value.
Content of this field: | Description of this field:
| Image data may have more than one sensor band represented for each pixel. Example(s): 7
#### rasterOrigin | This element has no default value.
Content of this field: | Description of this field:
Type: rasterOriginType
| Identification the corner of the grid where the first values for both the x and y axes begin in the file. Example(s): Upper Left
#### rows | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| Maximum number of raster objects along the ordinate (y) axis Example(s): 455
#### columns | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| Maximum number of raster objects along the abscissa (x) axis Example(s): 455
#### verticals | This element has no default value.
Content of this field: | Description of this field:
| Maximum number of raster objects along the vertical (z) axis.
#### cellGeometry | This element has no default value.
Content of this field: | Description of this field:
Type: CellGeometryType
| Indication of whether the cell value is representative of a single point(matrix) within the cell or the entire cell (pixel) Example(s): pixel
#### toneGradation | This element has no default value.
Content of this field: | Description of this field:
Type: xs:integer
| Number of colors present in the image. Example(s): 255
#### scaleFactor | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| The scale factor is used for raster-rescaling operations, where the following operation is applied to each pixel in the data in the source: rescaled=(source*scaleFactor)+offset. Example(s): 2
#### offset | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| The offset is used for raster-rescaling operations, where the following operation is applied to each pixel in the data in the source: rescaled=(source*scaleFactor)+offset. Example(s): 20
#### imageDescription | This element has no default value.
Content of this field: | Description of this field:
Elements: | Use: | How many:
A sequence of (
illuminationElevationAngle | optional |
illuminationAzimuthAngle | optional |
imageOrientationAngle | optional |
imagingCondition | optional |
imageQualityCode | optional |
cloudCoverPercentage | optional |
preProcessingTypeCode | optional |
compressionGenerationQuality | optional |
triangulationIndicator | optional |
radiometricDataAvailability | optional |
cameraCalibrationInformationAvailability | optional |
filmDistortionInformationAvailability | optional |
lensDistortionInformationAvailability | optional |
bandDescription | optional | unbounded
)
| Provides information about the image's suitability for use, sensor properties, and individual band descriptions.
#### illuminationElevationAngle | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Illumination elevation measured in degrees clockwise from the target plane at intersection of the optical line of sight with the earth's surface. Example(s): 45.5
#### illuminationAzimuthAngle | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Illumination azimuth measured in degrees clockwise from true north at the time the image is taken. Example(s): 45.5
#### imageOrientationAngle | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Angle from the first row of the image to true north in degrees, clockwise. Example(s): 45.5
#### imagingCondition | This element has no default value.
Content of this field: | Description of this field:
Type: ImagingConditionCode
| Code which indicates conditions which affect the quality of the image. Example(s): cloud
#### imageQualityCode | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| Specifies the image quality. Example(s): Excellent
#### cloudCoverPercentage | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Area of the dataset obscured by clouds, expressed as a percentage of the spatial extent. Example(s): 12
#### preProcessingTypeCode | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| Image distributor's code that identifies the level of radiometric and geometric processing applied against the image. Example(s): LEVELl1A, SPOTVIEWORTHO
#### compressionGenerationQuality | This element has no default value.
Content of this field: | Description of this field:
Type: xs:integer
| Counts the number of lossy compression cycles performed on the image. Example(s): 2
#### triangulationIndicator | This element has no default value.
Content of this field: | Description of this field:
Type: xs:boolean
| Code which indicates whether or not triangulation has been performed upon the image. Example(s): false
#### radiometricDataAvailability | This element has no default value.
Content of this field: | Description of this field:
Type: xs:boolean
| Code which indicates whether or not Standard Radiometric Product data is available. Example(s): false
#### cameraCalibrationInformationAvailability | This element has no default value.
Content of this field: | Description of this field:
Type: xs:boolean
| Code which indicates whether or not constants are available which allow for camera calibration corrections. Example(s): false
#### filmDistortionInformationAvailability | This element has no default value.
Content of this field: | Description of this field:
Type: xs:boolean
| Code which indicates whether or not Calibration Reseau information is available Example(s): true
#### lensDistortionInformationAvailability | This element has no default value.
Content of this field: | Description of this field:
Type: xs:boolean
| Code which indicates whether or not lens aberration correction information is available Example(s): true
#### bandDescription | This element has no default value.
Content of this field: | Description of this field:
Type: BandType
| Description of the wavelength domain that the sensor operates in
#### sequenceIdentifier | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| Number that uniquely identifies instances of bands of wavelengths on which a sensor operates. Example(s): 3
#### highWavelength | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Highest wavelength that the sensor is capable of collecting within a designated band. Example(s): 2.456
#### lowWaveLength | This element has no default value.
Content of this field: | Description of this field:
Type: xs:float
| Lowest wavelength that the sensor is capable of collecting within a designated band. Example(s): 0.1234
#### waveLengthUnits | This element has no default value.
Content of this field: | Description of this field:
Type: spref:lengthUnits
| Units of measure for the wavelength at which the sensor collected the data. Example(s): microns
#### peakResponse | This element has no default value.
Content of this field: | Description of this field:
#### accuracyReport | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| A text statement of the data quality, included the means by which it was determined.
#### quantitativeAccuracyReport | This element has no default value.
Content of this field: | Description of this field:
Elements: | Use: | How many:
A sequence of (
quantitativeAccuracyValue | required |
quantitativeAccuracyMethod | required |
)
| A quantitative assessment of the data quality expressed as a value and the method of its determination.
#### quantitativeAccuracyValue | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| The value resulting from the accuracy test. Typically, this will be expressed in units corresponding to those declared for the parameter being assessed. Example(s): 4.5
#### quantitativeAccuracyMethod | This element has no default value.
Content of this field: | Description of this field:
Type: res:NonEmptyStringType
| Identification and explanation of the method used to calculate the quantitative accuracy assessment. Example(s): Error expressed as root mean square of 5 control points.
## Attribute Definitions:
#### id
Type: res:IDType Use: optional
#### system
Type: res:SystemType Use: optional
#### scope
Type: res:ScopeType Use: optional Default value: document
## Complex Type Definitions:
#### SpatialRasterType |
Content of this field: | Description of this field:
Elements: | Use: | How many:
A choice of (
A sequence of (
ent:EntityGroup |  |
attributeList | required |
constraint | optional | unbounded
spatialReference | required |
georeferenceInfo | optional |
horizontalAccuracy | required |
verticalAccuracy | required |
cellSizeXDirection | required |
cellSizeYDirection | required |
numberOfBands | required |
rasterOrigin | required |
rows | required |
columns | required |
verticals | required |
cellGeometry | required |
toneGradation | optional |
scaleFactor | optional |
offset | optional |
imageDescription | optional |
)
OR
res:ReferencesGroup |  |
)
Attributes: | Use: | Default Value:
id | optional
system | optional
scope | optional | document
#### BandType |
Content of this field: | Description of this field:
Elements: | Use: | How many:
A sequence of (
sequenceIdentifier | optional |
highWavelength | optional |
lowWaveLength | optional |
waveLengthUnits | optional |
peakResponse | optional |
)
#### DataQuality |
Content of this field: | Description of this field:
Elements: | Use: | How many:
A sequence of (
accuracyReport | required |
quantitativeAccuracyReport | optional | unbounded
)
## Simple Type Definitions:
### #### CellValueType
Derived from: xs:string (by xs:restriction) Allowed values: Values Coded RGB Codes HIS HLS tekHVC |
### #### ImagingConditionCode
Derived from: xs:string (by xs:restriction) Allowed values: blurredimage cloud degradingObliquity fog heavySmokeorDust night rain semiDarkness shadow snow terrainMasking |
### #### rasterOriginType
Derived from: xs:string (by xs:restriction) Allowed values: Upper Left Lower Left Upper Right Lower Right |
### #### CellGeometryType
Derived from: xs:string (by xs:restriction) Allowed values: pixel matrix |
## Group Definitions:

Web Contact: jones@nceas.ucsb.edu