NITF Tagged Record Extensions Background
TREs contain information that cannot be stored in the NITF file header or segment subheaders. One or more TREs that apply to the entire NITF dataset can be present in the file header, and each segment (image or text) can also have one or more TREs associated with it. In some cases, TREs are applied to the data in a file or segment to enhance the utility of the data. Unless there is a large amount of data in a TRE, the TRE data is stored in the main header or segment subheader to which the TRE applies. For TREs too large to fit in the segment TRE area, a Data Extension Segment (DES) is created at the end of the file, and a pointer to this DES is stored within the header.
TREs come in two forms: Registered Extensions (REs) and Controlled Extensions (CEs). The NITF Standard Technical Board (NTB) maintains a registry of known CEs and REs: the main difference is that both the TRE name and TRE layout of CEs are controlled by the NTB, whereas only the TRE names of REs are registered with the NTB to prevent different users from using the same TRE name. Therefore, CEs can be interpreted based on the published information contained in the NTB repository, whereas REs require specific knowledge of the TRE contents available to the creator of the TRE that may not be available to the data consumer.
An example of a TRE is the RPC00B (Rapid Positioning Capability) TRE that can be associated with an image segment in a NITF dataset. This TRE provides coefficients that can be used to orthorectify the associated image segment. Other Controlled Extension TREs specify processing history, information about specific targets in an image, collection information, and other types of metadata.
The repository of Controlled Extension and Registered Extension TREs can be viewed online at the JITC web site.
For information on classified TREs, please visit our Request Technical Support web page.
Supported TREs
There are two levels of TRE support in the NITF Module:
- Unsupported TREs: TREs for which no definition is available, or the definition does not match the physical layout of the TRE. Only the raw data of TREs of this type can be viewed.
- Supported TREs: TREs that match a valid TRE definition. The data in these TREs can be read and written. The data in these TREs can be viewed with the appropriate header information in the Metadata Viewer. These TREs may be parsed into their specific components, and the value associated with each field in the TRE is displayed in the Metadata Viewer. To view the information contained in this type of TRE, open the TRE container. Each field in the TRE is displayed as a single entry.
The data in these TREs can be written into file, image, and text segments of new NITF files. When saving to NITF, you can view these TREs in the Metadata Viewer. Although the supported TREs for writing data can be displayed in the editor, only PIA TREs can be added, edited, or removed from their associated file header, image or text segment.
Each supported TRE references an XML definition file. Definition files for a partial list of the NTB-registered CEs are installed with ENVI. Support for TREs can be added by creating TRE definitions for the desired TREs. For more information about these TREs, contact Technical Support.
When opening a NITF image, ENVI does not parse the TRE fields if there is
no corresponding XML definition file. When writing a NITF file that contains a TRE with no
corresponding XML file, ENVI passes through this unknown TRE.
The following table describes TREs that ENVI currently supports for reading and writing data. The Reference column lists the applicable NITF specification document.
-
BPJ2K01: BIIF Profile for JPEG 2000
- MIL-PRF-89034: Digital Point Positioning Data Base (DPPDB)
-
NGA.STND.0044_1.3_MIE4NITF: Standard for MIE4NITF
- NSGPDD: National System for Geospatial Intelligence Product Definition Document
- RSM: Replacement Sensor Model Tagged Record Extensions Specification for NITF 2.1
-
STDI-0002: The Compendium of Controlled Extensions for NITF version 2.1
-
STDI-0006: National Transmission Format (NITF) Version 2.1 Commercial Dataset Requirements Document (NCDRD)
|
TRE/DES Name |
Filename |
Descriptive Name |
Reference |
|---|---|---|---|
|
ACCHZB |
|
Horizontal Accuracy Extension |
STDI-0002 |
|
ACCPOB |
|
Positional Accuracy Extension |
STDI-0002 |
|
ACCVTB |
|
Vertical Accuracy Extension |
STDI-0002 |
|
ACFTA |
|
Aircraft Information Version A |
STDI-0002 |
|
ACFTB |
|
Aircraft Information Version B |
STDI-0002 |
|
AIMIDA |
|
Additional Image Identification Version A |
STDI-0002 |
|
AIMIDB |
|
Additional Image Identification Version B |
STDI-0002 |
|
BANDSA |
|
Multispectral/ Hyperspectral Band Parameters |
STDI-0002 |
|
BANDSB |
|
Extended Multispectral/Hyperspectral Band Parameters |
STDI-0002 |
|
BCKGDA |
|
Background Data |
STDI-0002 |
|
BLOCKA |
|
Image Block Information |
STDI-0002 |
|
BNDPLB |
|
Bounding Polygon |
STDI-0002 |
|
CAMSDA |
|
Camera Set Definition, Version A |
NGA.STND.0044_1.3_MIE4NITF |
|
CCINFA |
|
Country Code Information, Version A |
STDI-0002 |
|
CMETAA |
|
Complex Metadata Tagged Record Extension Version A |
STDI-0002 |
|
CSATTA_DES |
|
Commercial Source Attitude Data, Version A |
STDI-0002 |
|
CSATTB |
|
Common Sensor Attitude Data |
NSGPDD |
|
CSCCGA |
|
Cloud Cover Grid |
STDI-0006 |
|
CSCRNA |
|
Corner Footprint |
STDI-0006 |
|
CSCSDB |
|
Common Sensor Covariance Support Data |
NSGPDD |
|
CSDIDA |
|
Dataset Identification |
STDI-0006 |
|
CSEPHA |
|
Ephemeris Data |
STDI-0006 |
|
CSEPHB |
|
Common Sensor Ephemeris Data |
STDI-0002 |
|
CSEXRA |
|
Exploitation Reference Data |
STDI-0006 |
|
CSEXRB |
|
Common Sensor Exploitation Reference Data |
STDI-0002 |
|
CSPROA |
|
Processing Information |
STDI-0006 |
|
CSRLSB |
|
Common Sensor Rolling Shutter Terms |
STDI-0002 |
|
CSSFAA |
|
Sensor Field Alignment Data |
STDI-0006 |
|
CSSFAB |
|
Common Sensor Field Alignment Data |
STDI-0002 |
|
CSSHPA |
|
Common Sensor Shapefile |
STDI-0006 |
|
CSSHPB |
|
Common Sensor Shapefile |
NSGPDD |
|
CSWRPB |
|
Common Sensor Warping Terms |
STDI-0002 |
|
ENGRDA |
|
Engineering Data |
STDI-0002 |
|
EXOPTA |
|
Exploitation Usability Optical Information |
STDI-0002 |
|
EXPLTA |
|
Exploitation Related Information Version A |
STDI-0002 |
|
EXPLTB |
|
Exploitation Related Information Version B |
STDI-0002 |
|
EXT_DEF_CONTENT |
|
Externally defined content DES |
STDI-0002 |
|
FASYWA |
|
Frame-Asynchronous Metadata Wrapper, Version A |
STDI-0002 |
|
FCRNSA |
|
File/Segment Corner Footprint |
STDI-0002 |
|
FREESA |
|
Free Space |
NGA.STND.0044_1.3_MIE4NITF |
| FRMSGA | FRMSGA.xml
|
Framing Array Segment | STDI-0002 |
|
FSYNWA |
|
Frame-Synchronous Metadata Wrapper, Version A |
NGA.STND.0044_1.3_MIE4NITF |
|
GEOLOB |
|
Local Geographic (lat/long) Coordinate System Extension |
STDI-0002 |
|
GEOPSB |
|
Geographical Positioning for geo-referencing parameters including datum, ellipsoids |
STDI-0002 |
|
GRDPSB |
|
Grid Positioning Version B |
STDI-0002 |
|
HISTOA |
|
Softcopy History Tagged Record Extension |
STDI-0002 |
|
ICHIPA |
|
Image Chip Support Data Extension Version A |
STDI-0002 |
|
ICHIPB |
|
Image Chip Support Data Extension Version B |
STDI-0002 |
|
ILLUMA |
|
Illumination, Version A |
STDI-0002 |
|
ILLUMB |
|
Illumination, Version B |
STDI-0002 |
|
IMASDA |
|
Segment Image Support Data |
MIL-PRF-89034 |
|
IMCBDA |
|
Segment Image Compressed Blocks Directory |
MIL-PRF-89034 |
|
IMRFCA |
|
Segment Image Rational Function Coefficients |
MIL-PRF-89034 |
|
IOMAPA |
|
Input/Output Mapping Tagged Record Extension |
STDI-0002 |
|
J2KLRA |
|
JPEG 2000 Parameters |
BPJ2K01 |
|
MAPLOB |
|
Local Cartographic (x/y) Coordinate System Extension |
STDI-0002 |
|
MATESA |
|
Mates |
STDI-0002 |
|
MENSRA |
|
Airborne SAR Mensuration Data Version A |
STDI-0002 |
|
MENSRB |
|
Airborne SAR Mensuration Data Version B |
STDI-0002 |
|
MIMCSA |
|
Motion Imagery Collection Summary, Version A |
NGA.STND.0044_1.3_MIE4NITF |
|
MPDSRA |
|
Mensuration Data |
STDI-0002 |
|
MSDIRA |
|
Master Product Directory Definition |
MIL-PRF-89034 |
|
MSTGTA |
|
Mission Target |
STDI-0002 |
|
MTIMFA |
|
Motion Imagery File, Version A |
NGA.STND.0044_1.3_MIE4NITF |
|
MTIMSA |
|
Motion Imagery Segment, Version A |
NGA.STND.0044_1.3_MIE4NITF |
|
MTIRPA |
|
Moving Target Information Report Version A |
STDI-0002 |
|
MTIRPB |
|
Moving Target Information Report Version B |
STDI-0002 |
|
MTXFIL |
|
MATRIX Fill |
|
|
NBLOCA |
|
(Number of Bytes) Image Block or Frame is Offset. |
STDI-0002 |
|
OFFSET |
|
(NITF 2.1) Offset of the first pixel of an image from the first pixel of the full image. |
STDI-0002 |
|
PATCHA |
|
Patch Information Version A |
STDI-0002 |
|
PATCHB |
|
Patch Information Version B |
STDI-0002 |
|
PIAEQA ** * |
|
Profile for Imagery Archives Equipment |
STDI-0002 |
|
PIAEVA ** * |
|
Profile for Imagery Archives Event |
STDI-0002 |
|
PIAIMB ** |
|
Profile for Imagery Archives Image |
STDI-0002 |
|
PIAIMC * |
|
Profile for Imagery Access Image |
STDI-0002 |
|
PIAPEA ** |
|
Profile for Imagery Archives Person |
STDI-0002 |
|
PIAPEB * |
|
Profile for Imagery Access Person |
STDI-0002 |
|
PIAPRC ** |
|
Profile for Imagery Archives Product |
STDI-0002 |
|
PIAPRD * |
|
Profile for Imagery Access Product |
STDI-0002 |
|
PIATGA ** |
|
Profile for Imagery Archives Target |
STDI-0002 |
|
PIATGB * |
|
Profile for Imagery Access Target |
STDI-0002 |
|
PIXMTA |
|
Pixel Metrics, Version A |
STDI-0002 |
|
PIXQLA |
|
Pixel Quality |
STDI-0002 |
|
PPRSDA |
|
Product Accuracy (Shear) Data |
MIL-PRF-89034 |
|
PRADAA |
|
Product Accuracy Data (Absolute) Definition |
STDI-0002 |
|
PRADRA |
|
Product Accuracy Data (Relative) Definition |
STDI-0002 |
|
PRJPSB |
|
Projection Parameters Extension |
STDI-0002 |
|
PSUPDA |
|
Product Support Data |
MIL-PRF-89034 |
|
PTPRAA |
|
Segment to Segment Relative Accuracy |
MIL-PRF-89034 |
|
REGPTB |
|
Registration Points Extension |
STDI-0002 |
|
RGRDRA |
|
Reference Graphic Directory Definition |
MIL-PRF-89034 |
|
RPC00A |
|
Rapid Positioning Capability Support Data Extension |
STDI-0002 |
|
RPC00B |
|
Rapid Positioning Capability Support Data Extension |
STDI-0002 |
|
RSMAPA |
|
RSM Adjustable Parameters |
STDI-0002 |
|
RSMAPB |
|
Replacement Sensor Model Adjustable Parameters |
STDI-0002 |
|
RSMDCA |
|
RSM Direct Error Covariance |
STDI-0002 |
|
RSMDCB |
|
Replacement Sensor Model Direct Error Covariance |
STDI-0002 |
|
RSMECA |
|
RSM Error Covariance |
STDI-0002 |
|
RSMECB |
|
Replacement Sensor Model Indirect Error Covariance |
STDI-0002 |
|
RSMGGA |
|
RSM Ground-to-image Grid |
STDI-0002 |
|
RSMGIA |
|
RSM Ground-to-image Grid Identification |
STDI-0002 |
|
RSMIDA |
|
RSM Identification |
STDI-0002 |
|
RSMPCA |
|
RSM Polynomial Coefficients |
STDI-0002 |
|
RSMPIA |
|
RSM Polynomial Identification |
STDI-0002 |
|
SECTGA |
|
Secondary Target Information |
STDI-0002 |
|
SEGSPA |
|
Stereo Image Segment Shear Point Data |
MIL-PRF-89034 |
|
SENSRA |
|
EO-IR Sensor Parameters |
STDI-0002 |
|
SENSRB |
|
EO-IR Sensor Parameters |
STDI-0002 |
|
SISDDA |
|
Stereo Image Segment Data |
MIL-PRF-89034 |
|
SSDPDA |
|
Stereo Image Segment Diagnostic Point Data |
MIL-PRF-89034 |
|
STDIDC |
|
Standard ID Extension |
STDI-0002 |
|
STREOA |
|
Stereo Information |
STDI-0002 |
|
STREOB |
|
Stereo Information |
STDI-0002 |
|
TMINTA |
|
Time Interval Definition, Version A |
NGA.STND.0044_1.3_MIE4NITF |
|
USE00A |
|
Exploitation Usability Extension |
STDI-0002 |
| XML_DATA_CONTENT |
|
XML data content DES |
STDI-0002 |
* Indicates TREs that can be created, edited and deleted.
** Indicates TREs that can only be edited and deleted. These TREs cannot be added.