Skip to content

Commit e2509a7

Browse files
minniewongminniewong
authored
Add three NIghttime lights (DNB) layers (#6067)
1 parent 2e1d6b6 commit e2509a7

File tree

12 files changed

+80
-8
lines changed

12 files changed

+80
-8
lines changed

‎config/default/common/config/metadata/layers/viirs/noaa20/VIIRS_NOAA20_DayNightBand.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
The Nighttime Imagery (Day/Night Band) layer shows regions of the Earth at roughly midnight local time for the selected date. The image is in grayscale. Terrestrial features illuminated by moonlight include clouds, atmospheric gravity waves, sea ice, and snow cover. Other light sources that may be visible are city lights, lightning, auroras, fires, gas flares, and fishing fleets.
2+
3+
The composite image for a day is stitched from ~14 orbits of a sun-synchronous satellite, traveling from north to south (descending) when on the nighttime side of the Earth. For each orbit, image values are scaled against other values in the same orbit so that a histogram of all values in an orbit is approximately uniform. This histogram equalization improves contrast across the large range of values in the image. A side-effect of this process is that the image generally appears overall brightest at the new moon instead of the full moon, as may be expected. For more details, see the documentation for [SatPy](https://satpy.readthedocs.io/en/latest/api/satpy.composites.viirs.html#satpy.composites.viirs.HistogramDNB) and [Polar2Grid](https://www.ssec.wisc.edu/software/polar2grid/viirs_day_night_band.html).
4+
5+
Due to the per-orbit scaling, this is a qualitative product intended to be used strictly for image display purposes. Furthermore, pixel values for different dates should not be directly compared, as the scaling is not normalized across time. For a quantitative product that can be compared to itself across different dates, see the "Black Marble Nighttime At Sensor Radiance" layer.
6+
7+
The Nighttime Imagery (Day/Night Band) layer is available from the VIIRS instrument aboard the joint NASA/NOAA NOAA-20 satellite at a daily temporal resolution. The VIIRS Day/Night Band (DNB) sensor resolution is 750 m at nadir and the imagery resolution is 1km.
8+
9+
References: VJ102DNB [doi:10.5067/VIIRS/VJ102DNB.021](https://doi.org/10.5067/VIIRS/VJ102DNB.021); VJ103DNB [doi:10.5067/VIIRS/VJ103DNB.021](https://doi.org/10.5067/VIIRS/VJ103DNB.021)

‎config/default/common/config/metadata/layers/viirs/noaa21/VIIRS_NOAA21_DayNightBand.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
The Nighttime Imagery (Day/Night Band) layer shows regions of the Earth at roughly midnight local time for the selected date. The image is in grayscale. Terrestrial features illuminated by moonlight include clouds, atmospheric gravity waves, sea ice, and snow cover. Other light sources that may be visible are city lights, lightning, auroras, fires, gas flares, and fishing fleets.
2+
3+
The composite image for a day is stitched from ~14 orbits of a sun-synchronous satellite, traveling from north to south (descending) when on the nighttime side of the Earth. For each orbit, image values are scaled against other values in the same orbit so that a histogram of all values in an orbit is approximately uniform. This histogram equalization improves contrast across the large range of values in the image. A side-effect of this process is that the image generally appears overall brightest at the new moon instead of the full moon, as may be expected. For more details, see the documentation for [SatPy](https://satpy.readthedocs.io/en/latest/api/satpy.composites.viirs.html#satpy.composites.viirs.HistogramDNB) and [Polar2Grid](https://www.ssec.wisc.edu/software/polar2grid/viirs_day_night_band.html).
4+
5+
Due to the per-orbit scaling, this is a qualitative product intended to be used strictly for image display purposes. Furthermore, pixel values for different dates should not be directly compared, as the scaling is not normalized across time. For a quantitative product that can be compared to itself across different dates, see the "Black Marble Nighttime At Sensor Radiance" layer.
6+
7+
The Nighttime Imagery (Day/Night Band) layer is available from the VIIRS instrument aboard the joint NASA/NOAA NOAA-21 satellite at a daily temporal resolution. The VIIRS Day/Night Band (DNB) sensor resolution is 750 m at nadir and the imagery resolution is 1km.
8+
9+
References: VJ202DNB [doi:10.5067/VIIRS/VJ202DNB.021](https://doi.org/10.5067/VIIRS/VJ202DNB.021); VJ203DNB [doi:10.5067/VIIRS/VJ203DNB.021](https://doi.org/10.5067/VIIRS/VJ203DNB.021)

‎config/default/common/config/metadata/layers/viirs/snpp/VIIRS_SNPP_DayNightBand.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
The Nighttime Imagery (Day/Night Band) layer shows regions of the Earth at roughly midnight local time for the selected date. The image is in grayscale. Terrestrial features illuminated by moonlight include clouds, atmospheric gravity waves, sea ice, and snow cover. Other light sources that may be visible are city lights, lightning, auroras, fires, gas flares, and fishing fleets.
2+
3+
The composite image for a day is stitched from ~14 orbits of a sun-synchronous satellite, traveling from north to south (descending) when on the nighttime side of the Earth. For each orbit, image values are scaled against other values in the same orbit so that a histogram of all values in an orbit is approximately uniform. This histogram equalization improves contrast across the large range of values in the image. A side-effect of this process is that the image generally appears overall brightest at the new moon instead of the full moon, as may be expected. For more details, see the documentation for [SatPy](https://satpy.readthedocs.io/en/latest/api/satpy.composites.viirs.html#satpy.composites.viirs.HistogramDNB) and [Polar2Grid](https://www.ssec.wisc.edu/software/polar2grid/viirs_day_night_band.html).
4+
5+
Due to the per-orbit scaling, this is a qualitative product intended to be used strictly for image display purposes. Furthermore, pixel values for different dates should not be directly compared, as the scaling is not normalized across time. For a quantitative product that can be compared to itself across different dates, see the "Black Marble Nighttime At Sensor Radiance" layer.
6+
7+
The Nighttime Imagery (Day/Night Band) layer is available from the VIIRS instrument aboard the joint NASA/NOAA Suomi National Polar orbiting Partnership (Suomi NPP) satellite at a daily temporal resolution. The VIIRS Day/Night Band (DNB) sensor resolution is 750 m at nadir and the imagery resolution is 1km.
8+
9+
References: VNP02DNB [doi:10.5067/VIIRS/VNP02DNB.002](https://doi.org/10.5067/VIIRS/VNP02DNB.002); VNP03DNB [doi:10.5067/VIIRS/VNP03DNB.002](https://doi.org/10.5067/VIIRS/VNP03DNB.002)

‎config/default/common/config/metadata/layers/viirs/snpp/VIIRS_SNPP_DayNightBand_ENCC.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
**8 July 2023 Notice:**
2-
The Nighttime Imagery (Day/Night Band, Enhanced Near Constant Contrast) layer is no longer being produced. We are currently investigating alternative sources, but do not have an estimated date for the resumption of the imagery layer. We apologize for the inconvenience. Similar imagery layers are available in Worldview including the Black Marble Nighttime At Sensor Radiance (Day/Night Band) and Black Marble Nighttime Blue/Yellow Composite (Day/Night Band).
2+
The Nighttime Imagery (Day/Night Band, Enhanced Near Constant Contrast) layer has been discontinued. Please use other similar imagery layers including the Nighttime Imagery (Day/Night Band), the Black Marble Nighttime At Sensor Radiance (Day/Night Band), and Black Marble Nighttime Blue/Yellow Composite (Day/Night Band) layers.
33

44
---
55

66
The Nighttime Imagery (Day/Night Band, Enhanced Near Constant Contrast) layer shows the Earth’s surface and atmosphere using a sensor designed to capture low-light emission sources, under varying illumination conditions. It is displayed as a grayscale image. Sources of illumination include both natural and anthropogenic sources of light emissions. Lunar reflection can be used to highlight the location and features of clouds and other terrestrial features such as sea ice and snow cover when there is partial to full moon conditions. When there is no moonlight, natural and anthropogenic night time light emissions are highlighted such as city lights, lightning, upper-atmospheric gravity waves, auroras, fires, gas flares, and fishing fleets. This layer is useful for displaying cities and highways at night, the tracking of shipping and fishing fleets, as well as fires and the burning of waste natural gas (gas flares) from on and offshore oil/gas production sites.
77

88
The Visible Infrared Imaging Radiometer Suite (VIIRS) Nighttime Imagery (Day/Night Band, Enhanced Near Constant Contrast) layer is mainly a qualitative product and should be strictly used for image display purposes. Each VIIRS Level 1B scan (6-minutes in total length) is individually processed and normalized based on a static set of values that predict the viewing and illumination geometries of each pixel. Because of the confounding factors that influence a VIIRS scan from one night to the next (e.g., more/less cloudy days, with more/less moon illumination conditions), individual ENCC pixel-based values are not comparable over time. For accurate time-series detection (e.g., monitoring short-term increases or reductions in artificial lights at night), users are referred to NASA’s Black Marble standard product suite (VNP46A1/VNP46A2 for Suomi NPP). These standard products correct for short-term variations in lunar and environmental conditions. They also provide the necessary quality assurance (QA) flags and additional layers to identify and isolate potential sources of noise and measurement error (e.g., clouds, moon-light, and snow contaminated pixels) and variations (e.g. lunar and view angles and view time) in a statistically robust fashion.
99

10-
The current ENCC Nighttime Imagery layer is available from the VIIRS instrument aboard the joint NASA/NOAA Suomi National Polar orbiting Partnership (Suomi NPP) satellite at a daily temporal resolution. The VIIRS Day/Night Band (DNB) sensor resolution is 750 m at nadir and the ENCC imagery layer’s gridded resolution is 15 arc-second (approximately 500 meters at the equator).
10+
The ENCC Nighttime Imagery layer is available from the VIIRS instrument aboard the joint NASA/NOAA Suomi National Polar orbiting Partnership (Suomi NPP) satellite at a daily temporal resolution. The VIIRS Day/Night Band (DNB) sensor resolution is 750 m at nadir and the ENCC imagery layer’s gridded resolution is 15 arc-second (approximately 500 meters at the equator).
1111

1212
References: [Earthdata - Nighttime Lights](https://www.earthdata.nasa.gov/topics/human-dimensions/nighttime-lights)
1313

‎config/default/common/config/wv.json/layerOrder.json‎

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,6 @@
88
"ARCSIX_SPEC-Learjet_Flight_Track",
99
"ARCSIX_G-III_Flight_Track",
1010
"ARCSIX_P-3B_Flight_Track",
11-
"PREFIRE_SAT1_Outgoing_Longwave_Radiative_Flux",
12-
"PREFIRE_SAT2_Outgoing_Longwave_Radiative_Flux",
1311
"NOAA_2025_ERI_WMTS",
1412
"HLS_S30_Nadir_BRDF_Adjusted_Reflectance",
1513
"HLS_L30_Nadir_BRDF_Adjusted_Reflectance",
@@ -108,11 +106,14 @@
108106
"TEMPO_L3_Ozone_Column_Amount",
109107
"TEMPO_L3_Ozone_Cloud_Fraction",
110108
"TEMPO_L3_Ozone_UV_Aerosol_Index",
109+
"VIIRS_NOAA21_DayNightBand",
111110
"VIIRS_NOAA20_DayNightBand_At_Sensor_Radiance",
112111
"VIIRS_NOAA20_DayNightBand_AtSensor_M15",
112+
"VIIRS_NOAA20_DayNightBand",
113113
"VIIRS_SNPP_GapFilled_BRDF_Corrected_DayNightBand_Radiance",
114114
"VIIRS_SNPP_DayNightBand_At_Sensor_Radiance",
115115
"VIIRS_SNPP_DayNightBand_AtSensor_M15",
116+
"VIIRS_SNPP_DayNightBand",
116117
"VIIRS_SNPP_DayNightBand_ENCC",
117118
"VIIRS_Black_Marble",
118119
"VIIRS_Night_Lights",
@@ -129,8 +130,6 @@
129130
"VIIRS_SNPP_Thermal_Anomalies_375m_All",
130131
"VIIRS_SNPP_Thermal_Anomalies_375m_Day",
131132
"VIIRS_SNPP_Thermal_Anomalies_375m_Night",
132-
"VIIRS_SNPP_DayNightBand_ENCC",
133-
"VIIRS_Night_Lights",
134133
"VIIRS_NOAA21_Brightness_Temp_BandI5_Day",
135134
"VIIRS_NOAA21_Brightness_Temp_BandI5_Night",
136135
"VIIRS_NOAA20_Brightness_Temp_BandI5_Day",
@@ -448,6 +447,8 @@
448447
"VIIRS_NOAA20_Sea_Ice",
449448
"VIIRS_NOAA20_Ice_Surface_Temp_Day",
450449
"VIIRS_NOAA20_Ice_Surface_Temp_Night",
450+
"PREFIRE_SAT1_Outgoing_Longwave_Radiative_Flux",
451+
"PREFIRE_SAT2_Outgoing_Longwave_Radiative_Flux",
451452
"Landsat_WELD_CorrectedReflectance_TrueColor_Global_Monthly",
452453
"Landsat_WELD_CorrectedReflectance_TrueColor_Global_Annual",
453454
"Landsat_WELD_CorrectedReflectance_Bands157_Global_Annual",

‎config/default/common/config/wv.json/layers/viirs/noaa20/VIIRS_NOAA20_DayNightBand.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"layers": {
3+
"VIIRS_NOAA20_DayNightBand": {
4+
"id": "VIIRS_NOAA20_DayNightBand",
5+
"description": "viirs/noaa20/VIIRS_NOAA20_DayNightBand",
6+
"tags": "dnb night jpss-1 lights city urban nighttime black marble",
7+
"layergroup": "Earth at Night",
8+
"group": "overlays"
9+
}
10+
}
11+
}

‎config/default/common/config/wv.json/layers/viirs/noaa21/VIIRS_NOAA21_DayNightBand.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"layers": {
3+
"VIIRS_NOAA21_DayNightBand": {
4+
"id": "VIIRS_NOAA21_DayNightBand",
5+
"description": "viirs/noaa21/VIIRS_NOAA21_DayNightBand",
6+
"tags": "dnb night jpss-2 lights city urban nighttime black marble",
7+
"layergroup": "Earth at Night",
8+
"group": "overlays"
9+
}
10+
}
11+
}

‎config/default/common/config/wv.json/layers/viirs/snpp/VIIRS_SNPP_DayNightBand.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"layers": {
3+
"VIIRS_SNPP_DayNightBand": {
4+
"id": "VIIRS_SNPP_DayNightBand",
5+
"description": "viirs/snpp/VIIRS_SNPP_DayNightBand",
6+
"tags": "dnb night s-npp snpp lights city urban nighttime black marble",
7+
"layergroup": "Earth at Night",
8+
"group": "overlays"
9+
}
10+
}
11+
}

‎config/default/common/config/wv.json/measurements/Earth at Night.json‎

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
"Earth at Night": {
44
"id": "earth-at-night",
55
"title": "Earth at Night",
6-
"subtitle": "Suomi NPP/VIIRS, NOAA-20/VIIRS",
6+
"subtitle": "Suomi NPP/VIIRS, NOAA-20/VIIRS, NOAA-21/VIIRS",
77
"sources": {
88
"Suomi NPP/VIIRS": {
99
"id": "suomi-npp-viirs",
@@ -14,6 +14,7 @@
1414
"VIIRS_SNPP_GapFilled_BRDF_Corrected_DayNightBand_Radiance",
1515
"VIIRS_SNPP_DayNightBand_At_Sensor_Radiance",
1616
"VIIRS_SNPP_DayNightBand_AtSensor_M15",
17+
"VIIRS_SNPP_DayNightBand",
1718
"VIIRS_SNPP_DayNightBand_ENCC",
1819
"VIIRS_Night_Lights",
1920
"VIIRS_Black_Marble",
@@ -27,7 +28,17 @@
2728
"image": "",
2829
"settings": [
2930
"VIIRS_NOAA20_DayNightBand_At_Sensor_Radiance",
30-
"VIIRS_NOAA20_DayNightBand_AtSensor_M15"
31+
"VIIRS_NOAA20_DayNightBand_AtSensor_M15",
32+
"VIIRS_NOAA20_DayNightBand"
33+
]
34+
},
35+
"NOAA-21/VIIRS": {
36+
"id": "noaa-21-viirs",
37+
"title": "NOAA-21/VIIRS",
38+
"description": "",
39+
"image": "",
40+
"settings": [
41+
"VIIRS_NOAA21_DayNightBand"
3142
]
3243
}
3344
}

‎web/images/layers/previews/geographic/VIIRS_NOAA20_DayNightBand.jpg‎

78.3 KB
Loading

0 commit comments

Comments
 (0)