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