S-NPP VIIRS L3 Monthly 500m Burned Area Product File Specification
Version 1.0.1 (August 2019)

PGE Version	: 1.0.4
PGE Release	: 2019-08-16

Product ID(s): VNP64A1 (L3 Monthly 500m Burned Area)

S-NPP VIIRS Burned Area Monthly L3 Global 500m SIN Grid

Description:
This document specifies the format for the monthly S-NPP VIIRS Level 3
Burned Area 500m SIN Grid product (VNP64A1). Note: In accordance with
the terms of the NASA grant agreement funding the development of this
ESDR, the VNP64A1 product will at least initially be generated and
distributed as HDF4 files nearly identical in format to the MODIS
Collection 6 MCD64A1 monthly burned area product.


Point of Contact:
	Louis Giglio (PI)
	University of Maryland
	lgiglio@umd.edu
	(301) 405-0064

	Joanne Hall
	University of Maryland, Department of Geographical Sciences
	jhall1@umd.edu
	(301) 405-6095

===========================================================================


1. ECS Granule Metadata

1.1 CoreMetadata.0

A tiny subset of MODIS-era ECS Core metadata are stored in a single HDF
attribute as a large string of PVL text.


Name                            ECS Type
----                            --------
HorizontalTileNumber		string
VerticalTileNumber		string


1.2 StructMetadata.0

This string will be populated automatically by HDF-EOS.


2. Product-Specific Granule Metadata

The following fields are stored as individual HDF global attributes.

Name					HDF Data Type
----					-------------
BurnedCells				int32
MissingCells				int32
LandCells				int32
ValidLandCells				int32
ProductStartDay				int16
ProductEndDay				int16
year					int16
tile					six-character string (e.g., "h10v06")
CodeVersion				five-character string (e.g., "3.8.6")
VNP64A0_input_file			string
LC_input_file				string
ShortName				string ("VNP64A1")
LongName				string

3. Scientific Data Sets

Name		Data Type	Dimensions
----		---------	----------
Burn Date	int16		YDim:MOD_Grid_Monthly_500m_BA,
				XDim:MOD_Grid_Monthly_500m_BA
Description:

Ordinal date of burn, with 0 = unburned. A value of -1 is used to flag
missing data, and a value of -2 is used to flag grid cells located in water.

SDS Attributes:

Attribute		Type	Quantity	Value
---------		----	--------	--------
valid_range		int16	2		0, 366
long_name		string	19		"ordinal day of burn"
_FillValue		int16	1		-1
water			int16	1		-2

=============================================================================

Name			Data Type	Dimensions
----			---------	----------
Burn Date Uncertainty	int8		YDim:MOD_Grid_Monthly_500m_BA,
					XDim:MOD_Grid_Monthly_500m_BA
Description:

Temporal uncertainty in burn date.

SDS Attributes:

Attribute		Type	Quantity	Value
---------		----	--------	--------
units			string	4		"days"
long_name		string	23		"uncertainty day of burn"

=============================================================================

Name			Data Type	Dimensions
----			---------	----------
QA			int8		YDim:MOD_Grid_Monthly_500m_BA,
					XDim:MOD_Grid_Monthly_500m_BA
Description:

Product quality assurance flags.


Bit	Description
---	-----------
0	land/water flag
		0 = water
		1 = land

1	valid data flag
		0 = missing data
		1 = valid

2	shortened mapping period (0 = false, 1 = true)

3	class updated during contextual relabeling phase
	(0 = false, 1 = true)

4	unused (set to 0)

5-7	unburned grid cell special-condition code
		0 = none or not applicable (e.g., grid cell is burned)
		1 = valid observations spaced too sparsely in time
		2 = too few training observations
		3 = apparent burn date at limits of time series
		4 = apparent persistent water contamination
		5 = persistent hotspot

Bits 5-7 provide an explanation for any grid cells that were summarily
classified as "unburned" by the mapping algorithm due to special
circumstances.  The vast majority of unburned grid cells do not fall into this
category and will have a special-condition code of 0 (as will all burned,
missing-data, and water grid cells).

SDS Attributes:

Attribute		Type	Quantity	Value
---------		----	--------	--------
units			string	9		"bit field"

=============================================================================

Name			Data Type	Dimensions
----			---------	----------
First Day		int16		YDim:MOD_Grid_Monthly_500m_BA,
					XDim:MOD_Grid_Monthly_500m_BA
Description:

First day of reliable change detection.

SDS Attributes:

Attribute		Type	Quantity	Value
---------		----	--------	--------
valid_range		int16	2		1, 366
long_name		string	38		"first day of reliable change
						detection"
_FillValue		int16	1		-1
water			int16	1		-2

=============================================================================

Name			Data Type	Dimensions
----			---------	----------
Last Day		int16		YDim:MOD_Grid_Monthly_500m_BA,
					XDim:MOD_Grid_Monthly_500m_BA
Description:

Last day of reliable change detection.

SDS Attributes:

Attribute		Type	Quantity	Value
---------		----	--------	--------
valid_range		int16	2		1, 366
long_name		string	37		"last day of reliable change
						detection"
_FillValue		int16	1		-1
water			int16	1		-2