MODIS Thermal Anomalies/Fire Version 6 File Specification
Document Creation: 08.01.2013

PGE Version	: 6.0.1
PGE Release	: 08.??.2013

This document specifies the format for the Aqua MODIS Level 3 Thermal
Anomalies/Fire Daily Global 1km SIN Grid product (MYD14A1).

Point of Contact:   
	Louis Giglio (PI)
	University of Maryland
	NASA Goddard Space Flight Center, Code 606.3
	Greenbelt, MD 20771
	lgiglio@umd.edu
	(301) 405-0064

	Chris Justice
	University of Maryland
	cjustice@umd.edu


1. ECS Granule Metadata

1.1 CoreMetadata.0

ECS Core metadata are stored in a single HDF attribute as a large string of
PVL text.

Name					ECS Type
----					--------
LocalGranuleID				string

SizeMBECSDataGranule			double

ProductionDateTime			DATETIME

DayNightFlag				string

ReprocessingActual			string

ReprocessingPlanned			string

LocalVersionID				string

ScienceQualityFlag			string

AutomaticQualityFlagExplanation		string

AutomaticQualityFlag			string

OperationalQualityFlagExplanation	string

OperationalQualityFlag			string

ScienceQualityFlagExplanation		string

QAPercentMissingData			integer

QAPERCENTOUTOFBOUNDSDATA		integer

QAPERCENTINTERPOLATEDDATA		integer

EquatorCrossingDate			DATE

EquatorCrossingTime			TIME

OrbitNumber				integer

EquatorCrossingLongitude		double

VersionID				integer

ShortName				string

GRingPointLongitude			double
	
GRingPointLatitude			double

GRingPointSequenceNo			integer

ExclusionGRingFlag			string

RangeEndingDate				DATE

RangeEndingTime				TIME
	
RangeBeginningDate			DATE

RangeBeginningTime			TIME

InputGranule				string

InputPointer				string

PGEVersion				string

AncillaryInputPointer			string

AncillaryInputType			string

AssociatedSensorShortName		string

AssociatedPlatformShortName		string

AssociatedInstrumentShortName		string


The following will be the AdditionalAttributes set:

     AdditionalAttribute.1 = QAPERCENTGOODQUALITY (integer)
     AdditionalAttribute.2 = QAPERCENTOTHERQUALITY (integer)
     AdditionalAttribute.3 = HORIZONTALTILENUMBER (integer)
     AdditionalAttribute.4 = VERTICALTILENUMBER (integer)
     AdditionalAttribute.5 = TileID (integer)
     



1.2 ArchiveMetadata.0

ECS Archive metadata are also stored in a single HDF attribute as a large
string of PVL text.


Name				ECS Type
----				--------
AlgorithmPackageAcceptanceDate	string

AlgorithmPackageMaturityCode	string

AlgorithmPackageName		string

AlgorithmPackageVersion		string

GEOANYABNORMAL			string

INSTRUMENTNAME			string

SystemFileName			string

AncillarySystemFileName		string

LongName			string

ProcessingCenter		string

SPSOParameters			string

NorthBoundingCoordinate		double

SouthBoundingCoordinate		double

EastBoundingCoordinate		double

WestBoundingCoordinate		double

CHARACTERISTICBINSIZE		double

InstrumentScansProcessed	integer

PercentLand			integer

scistate			integer

sciabnorm			integer

CloudPixels			integer

NoFirePixels			integer

UnknownPixels			integer

WaterPixels			integer

DESCRrevision			string

ProductionHistory		string

ProcessingEnvironment		string



2. Product-Specific Granule Metadata

The following fields are stored as individual HDF attributes.  Many are
duplicates of the ECS Core and Archive metadata fields to prevent users from
having to parse metadata stored in the confusing PVL format mandated by the
ECS.


Name			Type	Description
----			----	-----------
FirePix			int32	Daily number of fire pixels detected in tile.
				("Data Days"-element vector.)

CloudPix		int32	Daily number of cloud pixels over land in
				tile.  ("Data Days"-element vector.)

UnknownPix		int32	Daily number of pixels classified as "unknown"
				in tile.  ("Data Days"-element vector.)

MissingPix		int32	Daily number of pixels classified as "missing"
				in tile.  ("Data Days"-element vector.)

Dates			string	String containing space-delimited dates
				(normally eight) of the daily layers of the
				product Scientific Data Sets.  Format of
				individual dates is YYYY-MM-DD.

MaxT21			float32	Maximum fire-pixel band 21 brightness
				temperature (kelvins).

ProcessVersionNumber	string	Internal version number (e.g. "5.1.0").

StartDate		string	Start date of 8-day product period;
				format is YYYY-MM-DD.

EndDate			string	End date of 8-day product period; format
				is YYYY-MM-DD.

HorizontalTileNumber	int16	Tile horizontal coordinate (range 0 - 35)

VerticalTileNumber	int16	Tile vertical coordinate (range 0 - 17)



3. Structural Metadata
    This string will be populated automatically by HDF-EOS.

Grid Structure:  MODIS_Grid_Daily_Fire

Data Fields:
	FireMask, QA, MaxFRP, sample

    Dimensions:

	Dimension Name				Value

	Number of Days:MODIS_Grid_Daily_Fire	"Data Days"

	YDim:MODIS_Grid_Daily_Fire		"Data Rows"

	XDim:MODIS_Grid_Daily_Fire		"Data Columns"

    Corner Locations:

	Corner                Values

	UpperLeftPointMtrs    (Variable, Variable)

	LowerRightPointMtrs   (Variable, Variable)

    Geographic Grid Projection Parameters:

        Sinusoidal Projection
	    Projection	      GCTP_SNSOID
	    ProjParam[0]          6371007.181
	    ProjParam[1 to 7]     0.0
	    ProjParam[8]          21600
	    ProjParam[9]          0.0
	    ProjParam[10]         1.0
	    ProjParam[11 to 12]   0.0
	    Spherecode            -1
	    GridOrigin            HDFE_GD_UL


4. Scientific Data Sets


Name		Type	Dimensions
-----		----	----------
FireMask	uint8	Number of Days, XDim, YDim

Description:
The fire mask is the principle component of the Level 2 MODIS fire product. In
it, individual 1-km pixels are assigned one of nine classes as below.  The fire
mask is stored as an 8 (or less) by 1200 by 1200, 8-bit unsigned integer SDS
named "FireMask". The SDS contains eight successive daily fire masks for a
specific MODIS tile. Each of these daily masks is essentially a maximum value
composite (see important note below) of the Level 2 fire product pixel classes
for those swaths overlapping the MODIS tile during that day. Product files
containing less than eight days of data will occasionally be encountered during
time periods of missing data and should be handled in ingest software.

SDS Attributes:

Attribute		Type	Quantity	Value
---------		----	--------	--------
valid_range		uint8	2		0, 9
_FillValue		uint8	1		0

Value	Description
-----	-----------
  0	missing input data
  1	not processed (obsolete; not used in post-launch product)
  2	not processed (other reason)
  3	non-fire water
  4	cloud
  5	non-fire land
  6	unknown
  7	fire (low confidence)
  8	fire (nominal confidence)
  9	fire (high confidence)

Note: For Collection 5 and earlier, each daily mask was _precisely_ a
maximum value composite of the Level 2 fire product pixel classes.  For
Collection 6 this rule had to be modified slightly because of the potential
for fire pixels to be detected over water (i.e., offshore gas flares).
Consequently, non-fire water pixels (class 3) will now override
cloud pixels (class 4) occuring over water, just as non-fire land pixels
(class 5) have always been assigned higher priority than cloud pixels occuring
over land.

-----------------------------------------------------------------------------

Name		Type		Dimensions
--------	-------		-----------------
QA		uint8		Number of Days, XDim, YDim

Description:
Each of the daily fire masks has a corresponding simple QA layer. Each layer
is a 1200 by 1200 8-bit unsigned integer array.  Only six unique QA values
are possible, with the meanings shown below:

Bit	Description
---	-----------
0-1	land/water state
		00 = water
		01 = coast
		10 = land
		11 = missing data

2	day/night observation (0 = night, 1 = day)

For missing-data grid cells (bit pattern 11 in bits 0-1) bit 2 will always
be clear.


SDS Attributes:

Attribute	Type	Quantity	Value
------------	-------	------------	--------
valid_range	uint8	2		0, 6
units		string	9		bit field


-----------------------------------------------------------------------------

Name		Type		Dimensions
--------	-------		-----------------
MaxFRP		uint32		Number of Days, XDim, YDim

Description:
The maximum fire radiative power of all fire pixels falling within each grid
cell is provided on a daily basis in the "MaxFRP" SDS. Here the FRP values
have been scaled by a factor of 10 and stored as a 32-bit signed integer.
Multiply these scaled values by 0.1 to retrieve the maximum FRP in MW.

Attribute		Type		Quantity	Value
------------		--------	------------	--------
units			string		2		MW
scale_factor		float32		1		0.1


-----------------------------------------------------------------------------

Name		Type		Dimensions
--------	-------		-----------------
sample		uint16		Number of Days, XDim, YDim

Description:
For all grid cells assigned one of the fire pixel classes (values 7, 8, or 9),
the position of the fire pixel within the scan is recorded on a daily basis in
a 1200 by 1200 16-bit unsigned integer SDS named "sample".  Sample values have
a range of 0 to 1353.  All grid cells assigned one of the non-fire classes in
the "FireMask" SDS will be filled with a sample value of 0.

Attribute		Type		Quantity	Value
------------		--------	------------	--------
valid_range		uint8		2		0, 1353

Last updated: October 10, 2019