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 (
cornerPointrequired4
OR
controlPointrequiredunbounded
OR
bilinearFitrequired
)
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 (
xCoordinaterequired
yCoordinaterequired
pointInPixelrequired
cornerrequired
)
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 (
columnrequired
rowrequired
xCoordinaterequired
yCoordinaterequired
pointInPixelrequired
)
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 (
xInterceptrequired
xSloperequired
yInterceptrequired
ySloperequired
)
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 (
illuminationElevationAngleoptional
illuminationAzimuthAngleoptional
imageOrientationAngleoptional
imagingConditionoptional
imageQualityCodeoptional
cloudCoverPercentageoptional
preProcessingTypeCodeoptional
compressionGenerationQualityoptional
triangulationIndicatoroptional
radiometricDataAvailabilityoptional
cameraCalibrationInformationAvailabilityoptional
filmDistortionInformationAvailabilityoptional
lensDistortionInformationAvailabilityoptional
bandDescriptionoptionalunbounded
)
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 (
quantitativeAccuracyValuerequired
quantitativeAccuracyMethodrequired
)
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  
attributeListrequired
constraintoptionalunbounded
spatialReferencerequired
georeferenceInfooptional
horizontalAccuracyrequired
verticalAccuracyrequired
cellSizeXDirectionrequired
cellSizeYDirectionrequired
numberOfBandsrequired
rasterOriginrequired
rowsrequired
columnsrequired
verticalsrequired
cellGeometryrequired
toneGradationoptional
scaleFactoroptional
offsetoptional
imageDescriptionoptional
)
OR
res:ReferencesGroup  
)
Attributes: Use: Default Value:
idoptional
systemoptional
scopeoptionaldocument
BandType 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
sequenceIdentifieroptional
highWavelengthoptional
lowWaveLengthoptional
waveLengthUnitsoptional
peakResponseoptional
)
DataQuality 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
accuracyReportrequired
quantitativeAccuracyReportoptionalunbounded
)

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