# LCP – FARSITE v.4 LCP Format¶

Driver short name

LCP

FARSITE v. 4 landscape file (LCP) is a multi-band raster format used by wildland fire behavior and fire effect simulation models such as FARSITE, FLAMMAP, and FBAT (www.fire.org). The bands of an LCP file store data describing terrain, tree canopy, and surface fuel. The LANDFIRE Data Distribrution Site distributes data in LCP format, and programs such as FARSITE and LFDAT can create LCP files from a set of input rasters.

An LCP file (.lcp) is basically a raw format with a 7,316-byte header described below. The data type for all bands is 16-bit signed integer. Bands are interleaved by pixel. Five bands are required: elevation, slope, aspect, fuel model, and tree canopy cover. Crown fuel bands (canopy height, canopy base height, canopy bulk density), and surface fuel bands (duff, coarse woody debris) are optional.

The LCP driver reads the linear unit, cell size, and extent, but the LCP file does not specify the projection. UTM projections are typical, but other projections are possible.

## Driver capabilities¶

Supports CreateCopy()

This driver supports the GDALDriver::CreateCopy() operation

Supports Georeferencing

This driver supports georeferencing

Supports VirtualIO

This driver supports virtual I/O operations (/vsimem/, etc.)

The GDAL LCP driver reports dataset- and band-level metadata:

### Dataset¶

LATITUDE: Latitude of the dataset, negative for southern hemisphere
LINEAR_UNIT: Feet or meters
DESCRIPTION: LCP file description

### Band¶

<band>_UNIT or <band>_OPTION: units or options code for the band
<band>_UNIT_NAME or <band>_OPTION_DESC: descriptive name of units/options
<band>_MIN: minimum value
<band>_MAX: maximum value
<band>_NUM_CLASSES: number of classes, -1 if > 100
<band>_VALUES: comma-delimited list of class values (fuel model band only)
<band>_FILE: original input raster file name for the band

Note: The LCP driver derives from the RawDataset helper class declared in gdal/frmts/raw. It should be implemented as gdal/frmts/raw/lcpdataset.cpp.

## Creation Options¶

The LCP driver supports CreateCopy() and metadata values can be set via creation options. Below is a list of options with default values listed first.

ELEVATION_UNIT=[METERS/FEET]: Vertical unit for elevation band.

SLOPE_UNIT=[DEGREES/PERCENT]

ASPECT_UNIT=[AZIMUTH_DEGREES/GRASS_CATEGORIES/GRASS_DEGREES]

FUEL_MODEL_OPTION=[NO_CUSTOM_AND_NO_FILE/CUSTOM_AND_NO_FILE/ NO_CUSTOM_AND_FILE/CUSTOM_AND_FILE]: Specify whether or not custom fuel models are used, and if a custom fuel model file is present.

CANOPY_COV_UNIT=[PERCENT/CATEGORIES]

CANOPY_HT_UNIT=[METERS_X_10/FEET/METERS/FEET_X_10]

CBH_UNIT=[METERS_X_10/METERS/FEET/FEET_X_10]

CBD_UNIT=[KG_PER_CUBIC_METER_X_100/POUND_PER_CUBIC_FOOT/ KG_PER_CUBIC_METER/POUND_PER_CUBIC_FOOT_X_1000/TONS_PER_ACRE_X_100]

DUFF_UNIT=[MG_PER_HECTARE_X_10/TONS_PER_ACRE_X_10]

CALCULATE_STATS=[YES/NO]: Calculate and write the min/max for each band and write the appropriate flags and values in the header. This is mostly a legacy feature used for creating legends.

CLASSIFY_DATA=[YES/NO]: Classify the data into 100 unique values or less and write and write the appropriate flags and values in the header. This is mostly a legacy feature used for creating legends.

LINEAR_UNIT=[SET_FROM_SRS/METER/FOOT/KILOMETER]: Set the linear unit, overriding (if it can be calculated) the value in the associated spatial reference. If no spatial reference is available, it defaults to METER.

LATITUDE=[-90-90]: Override the latitude from the spatial reference. If no spatial reference is available, this should be set, otherwise creation will fail.

DESCRIPTION=[…]: A short description(less than 512 characters) of the dataset

Creation options that are units of linear measure are fairly lenient. METERS=METER and FOOT=FEET for the most part.

Note: CreateCopy does not scale or change any data. By setting the units for various bands, it is assumed that the values are in the specified units.