Product Family Specification, Optical, Nighttime Light Surface Radiance
Proposed revisions may be provided to: ard-contact@lists.ceos.org
Not available yet
CEOS Analysis Ready Data (CEOS-ARD) are satellite data that have been processed to a minimum set of requirements and organized into a form that allows immediate analysis with a minimum of additional user effort and interoperability both through time and with other datasets.
Product Family Specification: Optical, Nighttime Light Surface Radiance (NLSR)
Version: 1.0-draft
Applies to: Data collected by Optical sensors
Data collected with nighttime light sensors operating in the VIS/NIR wavelengths. These typically operate with ground sample distance and resolution in the order of 10-1000m; however, the Specification is not inherently limited to this resolution.
WARNING: The section numbers in front of the title (e.g. 1.1) are not stable and may change or may be removed at any time. Do not use the numbers to refer back to specific requirements! Instead, use the textual identifier that is provided below the title.
1.
General MetadataThese are metadata records describing a distributed collection of pixels. The collection of pixels referred to must be contiguous in space and time. General metadata should allow the user to assess the overall suitability of the dataset, and must meet the requirements listed below.
1.1.
TraceabilityIdentifier: meta.metadata-traceability-sr
Not required.
Data must be traceable to SI reference standard.
Notes:
1.2.
Metadata Machine ReadabilityIdentifier:
meta.metadata-machine-readability-optical
Metadata is provided in a structure that enables a computer algorithm to be used to consistently and automatically identify and extract each component part for further use.
As threshold, but metadata should be provided in a community endorsed standard that facilitates machine-readability, such as ISO 19115-2.
1.3.
Data Collection TimeIdentifier: meta.metadata-time-sr
The data collection time is identified in the metadata, expressed in date/time, to the second, with the time offset from UTC unambiguously identified.
Acquisition time for each pixel is identified (or can be reliably determined) in the metadata, expressed in date/time at UTC, to the second.
1.4.
Geographical AreaIdentifier: meta.metadata-geo-area-sr
The surface location to which the data relate is identified, typically as a series of four corner points, expressed in an accepted coordinate reference system (e.g., WGS84).
The geographic area covered by the observations is identified specifically, such as through a set of coordinates of a closely bounding polygon. The location to which each pixel refers is identified (or can be reliably determined) with the projection system (if any) and reference datum provided.
1.5.
Coordinate Reference SystemIdentifier: meta.metadata-crs-optical
The metadata lists the coordinate reference system that has been used.
As threshold.
1.6.
Map ProjectionIdentifier: meta.metadata-map-projection-nlsr
The metadata lists the map projection that has been used and any relevant parameters required in relation to use of data in that map projection.
As threshold.
1.7.
Geometric Correction MethodsIdentifier:
meta.metadata-geometric-correction-methods-sr
Not required.
Information on geometric correction methods should be available in the metadata as a single DOI landing page, including reference database and auxiliary data such as elevation model(s) and reference chip-sets.
1.8.
Geometric Accuracy of the DataIdentifier: meta.metadata-geometric-accuracy-sr
Not required.
The metadata includes metrics describing the assessed geodetic accuracy of the data, expressed units of the coordinate system of the data. Accuracy is assessed by independent verification (as well as internal model-fit where applicable). Uncertainties are expressed quantitatively, for example, as root mean square error (RMSE) or Circular Error Probability (CEP90, CEP95), etc.
Notes:
1.9.
InstrumentIdentifier: meta.metadata-instrument-optical
The instrument used to collect the data is identified in the metadata.
As threshold, but information should be available in the metadata as a single DOI landing page with references to the relevant CEOS Missions, Instruments, and Measurements Database record.
1.10.
Spectral BandsIdentifier: meta.metadata-spectral-bands
The central wavelength for each band for which data is included is identified in the metadata, expressed in SI units.
As threshold, with instrument spectral response details (e.g., full spectral response function) also included or directly accessible using details in the metadata. Central wavelength and bandwidth at full-width half maximum value of the relative spectral response function are provided at least.
Notes:
1.11.
Sensor CalibrationIdentifier: meta.metadata-sensor-calibration-optical
Not required.
Sensor calibration parameters are identified in the metadata or can be accessed using details included in the metadata. Ideally this would support machine-to-machine access.
Notes:
1.12.
Radiometric AccuracyIdentifier: meta.metadata-radiometric-accuracy-sr
Not required.
The metadata includes metrics describing the assessed absolute radiometric uncertainty of the version of the data or product, expressed as absolute radiometric uncertainty relative to appropriate, known reference sites and standards (for example, pseudo-invariant calibration sites, rigorously collected field spectra, Rayleigh, DCC, etc.)
Notes:
1.13.
AlgorithmsIdentifier: meta.metadata-algorithms-sr
All algorithms, and the sequence in which they were applied in the generation process, are identified in the metadata. For example, these may be available through Algorithm Theoretical Basis documents.
Notes:
As threshold, but only algorithms that have been published in a peer-reviewed journal.
Notes:
1.14.
Auxiliary DataIdentifier: meta.metadata-auxiliary-data-optical
The metadata identifies the sources of auxiliary data used in the generation process, ideally expressed as a single DOI landing page.
Notes:
As threshold, but information on auxiliary data should be available in the metadata as a single DOI landing page and is also available for free online download, contemporaneously with the product or through a link to the source.
1.15.
Processing Chain ProvenanceIdentifier: meta.metadata-processing-chain-prov-nlsr
Not required.
Information on processing chain provenance should be available in the metadata as a single DOI landing page containing detailed description of the processing steps used to generate the product, the organization that performed the processing, and the versions of software used, giving full transparency to the users.
1.16.
Data AccessIdentifier: meta.metadata-data-access
Information on data access should be available in the metadata as a single DOI landing page.
Notes:
As threshold.
1.17.
Overall Data QualityIdentifier: meta.metadata-data-quality-sr
Not required.
Machine-readable metrics describing the overall quality of the data are included in the metadata, at minimum the cloud cover extent, i.e.:
2.
Per-Pixel MetadataThe following minimum metadata specifications apply to each pixel. Whether the metadata are provided in a single record relevant to all pixels or separately for each pixel is at the discretion of the data provider. Per-pixel metadata should allow users to discriminate between (choose) observations on the basis of their individual suitability for applications.
2.1.
Metadata Machine ReadabilityIdentifier:
pxl.metadata-machine-readability-per-pixel-optical
Metadata is provided in a structure that enables a computer algorithm to be used to consistently and automatically identify and extract each component part for further use.
As threshold.
2.2.
No DataIdentifier: pxl.per-pixel-nodata
Pixels that do not correspond to an observation (‘empty pixels’) are flagged.
As threshold.
2.3.
Incomplete TestingIdentifier: pxl.per-pixel-incomplete-testing
The metadata identifies pixels for which the per-pixel tests (below) have not all been successfully completed.
Notes:
The metadata identifies which tests have, and have not, been successfully completed for each pixel.
2.4.
SaturationIdentifier: pxl.per-pixel-saturation
Metadata indicates where one or more pixel in the input spectral bands are saturated.
Metadata indicates which pixels are saturated for each spectral band.
2.5.
CloudIdentifier: pxl.per-pixel-cloud
Metadata indicates whether a pixel is assessed as being cloud.
As threshold, but information on cloud detection should be available in the metadata as a single DOI landing page.
2.6.
Cloud ShadowIdentifier: pxl.per-pixel-cloud-shadow-nlsr
Not required.
Metadata indicates whether a pixel is assessed as being cloud shadow. Information on cloud shadow detection should be available in the metadata as a single DOI landing page.
2.7.
Land/Water MaskIdentifier: pxl.per-pixel-land-water-nlsr
Metadata indicates whether a pixel is land or water.
As threshold, information on land/water mask should be available in the metadata as a single DOI landing page.
2.8.
Snow/Ice MaskIdentifier: pxl.per-pixel-snow-ice-nlsr
Metadata indicates whether a pixel is snow/ice.
As threshold, information on snow/ice mask should be available in the metadata as a single DOI landing page.
2.9.
Terrain Shadow MaskIdentifier: pxl.per-pixel-terrain-shadow
Not required.
The metadata indicates pixels that are not directly illuminated due to terrain shadowing.
2.10.
Terrain OcclusionIdentifier: pxl.per-pixel-terrain-occlusion
Not required.
The metadata indicates pixels that are not visible to the sensor due to terrain occlusion during off-nadir viewing.
2.11.
Lunar and Viewing GeometryIdentifier: pxl.per-pixel-view-angles-lunar
Provide average lunar and sensor viewing azimuth and zenith angles.
Provide per-pixel lunar and sensor viewing azimuth and zenith angles.
2.12.
Terrain Illumination CorrectionIdentifier: pxl.per-pixel-terrain-illumination
Not required.
Coefficients used for terrain illumination correction are provided for each pixel.
2.13.
Moon Illumination FractionIdentifier: pxl.per-pixel-moon-illumination-fraction
Provide average moon illumination fraction.
Provide per-pixel moon illumination fraction
2.14.
Brightness TemperatureIdentifier: pxl.per-pixel-brightness-temperature
Provide brightness temperature from thermal bands.
As threshold.
2.15.
Solar Zenith AngleIdentifier: pxl.per-pixel-solar-zenith-angle
Provide solar zenith angle to support stray-light corrections (see also Section “Radiometric and Atmospheric Corrections: Stray Light Corrections”).
As threshold.
3.
Radiometric and Atmospheric CorrectionsThe following requirements must be met for all pixels in a collection. The requirements indicate both the necessary outcomes and the minimum steps necessary to be deemed to have achieved those outcomes. Radiometric corrections must lead to a valid measurement.
3.1.
MeasurementIdentifier: rac.measurements-measurement-nlsr
Pixel values that are expressed as a measurement of the nighttime light radiance.
Nighttime light radiance measurements are SI traceable (see also Section “General Metadata: Traceability”).
3.2.
Measurement UncertaintyIdentifier: rac.measurements-uncertainty-sr
Note: In current practice, users determine fitness for purpose based on knowledge of the lineage of the data, rather than on a specific estimate of measurement uncertainty.
Not required.
An estimate of the certainty of the values is provided in measurement units.
Notes:
3.3.
Measurement NormalisationIdentifier: rac.measurements-normalisation-nlsr
Not required.
Measurements are normalised for viewing conditions (i.e., nadir view angle). This may include radiative transfer modelling.
Notes:
3.4.
Atmospheric CorrectionsIdentifier: rac.measurements-atmospheric-corrections
Corrections are applied for atmospheric scattering.
Metadata contains a single DOI landing page with references to:
Notes:
As threshold.
3.5.
Lunar Radiance CorrectionsIdentifier: rac.corrections-lunar-radiance
Corrections are applied for lunar radiance.
Metadata contains a single DOI landing page with references to:
Notes:
As threshold.
3.6.
Stray Light CorrectionsIdentifier: rac.corrections-stray-light
Corrections are applied for stray light.
Metadata contains a single DOI landing page with references to:
Notes:
As threshold.
4.
Geometric CorrectionsThe geometric corrections are steps that are taken to place the measurement accurately on the surface of the Earth (that is, to geolocate the measurement) allowing measurements taken through time to be compared. This section specifies any geometric correction requirements that must be met in order for the data to be analysis ready.
4.1.
Geometric CorrectionIdentifier: gcor.corrections-geometric-sr
Sub-pixel accuracy is achieved in relative geolocation, that is, the pixels from the same instrument and platform are consistently located, and are thus comparable, through time.
Sub-pixel accuracy is taken to be less than or equal to 0.5 pixel radial root mean square error (rRMSE) or equivalent in Circular Error Probability (CEP) relative to a defined reference image.
A consistent gridding/sampling frame is used, including common cell size, origin, and nominal sample point location within the cell (centre, ll, ur).
Relevant metadata must be provided under Section “General Metadata: Geometric Accuracy of the Data” and Section “General Metadata: Instrument”.
Notes:
Sub-pixel accuracy is achieved relative to an identified absolute independent terrestrial referencing system (such as a national map grid).
A consistent gridding/sampling frame is necessary to meet this requirement.
Relevant metadata must be provided under Section “General Metadata: Geometric Accuracy of the Data” and Section “General Metadata: Instrument”.
Notes:
This section aims to provide background and specific information on the processing steps that can be used to achieve analysis ready data for a specific and well-developed Product Family Specification. This Guidance material does not replace or override the specifications.
CEOS-ARD are products that have been processed to a minimum set of requirements and organized into a form that allows immediate analysis with a minimum of additional user effort. In general, these products would be resampled onto a common geometric grid (for a given product) and would provide baseline data for further interoperability both through time and with other datasets.
CEOS-ARD products are intended to be flexible and accessible products suitable for a wide range of users for a wide variety of applications, including particularly time series analysis and multi-sensor application development. They are also intended to support rapid ingestion and exploitation via high-performance computing, cloud computing and other future data architectures. They may not be suitable for all purposes and are not intended as a replacement for other types of satellite products.
The CEOS-ARD branding is applied to a particular product once:
Agencies or other entities considering undertaking an assessment process should consult the CEOS-ARD Governance Framework.
A product can continue to use CEOS-ARD branding as long as its generation and distribution remain consistent with the peer-reviewed assessment.
Threshold (Minimum) requirements are the minimum that is needed for the data to be analysis ready. This must be practical and accepted by the data producers.
Goal (Desired) requirements (previously referred to as “Target”) are the ideal; where we would like to be. Some providers may already meet these.
Products that meet all threshold requirements should be immediately useful for scientific analysis or decision-making.
Products that meet goal requirements will reduce the overall product uncertainties and enhance broad-scale applications. For example, the products may enhance interoperability or provide increased accuracy through additional corrections that are not reasonable at the threshold level.
Goal requirements anticipate continuous improvement of methods and evolution of community expectations, which are both normal and inevitable in a developing field. Over time, goal specifications may (and subject to due process) become accepted as threshold requirements.