Help

ExportToLayoutGeoTIFF

Available with Production Mapping license.

Summary

Exports the page layout of an .mxd file to the Tagged Image File Format (TIFF) with spatial reference information, which is also known as a GeoTIFF.

Discussion

TIFF files are the most versatile raster format. TIFFs can store pixel data at several bit depths and can be compressed with either lossy or lossless compression techniques depending on file size and accuracy requirements.

Refer to Exporting to Layout GeoTIFF in ArcGIS for Desktop Help for more detailed discussions on exporting maps.

Syntax

ExportToLayoutGeoTIFF (map_document, out_tiff, {spatial_reference_data_frame}, {resolution}, {world_file}, {color_mode}, {tiff_compression})
ParameterExplanationData Type
map_document

A variable that references a MapDocument object.

MapDocument
out_tiff

A string that represents the path and file name for the output export file.

String
spatial_reference_data_frame

The data frame used to interpolate the spatial reference. By default, the active data frame is used to determine the spatial reference for the TIFF.

DataFrame
resolution

A number that defines the resolution of the export file in DPI (dots per inch).

(The default value is 96)

Integer
world_file

If set to True, a georeferenced world file is created. The file contains pixel scale information and real-world coordinate information.

(The default value is False)

Boolean
color_mode

This value specifies the number of bits used to describe color.

  • 24-BIT_TRUE_COLOR —24-bit true color
  • 8-BIT_PALETTE —8-bit palette
  • 8-BIT_GRAYSCALE —8-bit grayscale
  • 1-BIT_MONOCHROME_MASK —1-bit monochrome mask
  • 1-BIT_MONOCHROME_THRESHOLD —1-bit monochrome threshold

(The default value is 24-BIT_TRUE_COLOR)

String
tiff_compression

This value represents a compression scheme.

  • DEFLATE —A lossless data compression.
  • JPEG —JPEG compression.
  • LZW —Lempel-Ziv-Welch, a lossless data compression. This is the default value.
  • NONE —Compression is not applied.
  • PACK_BITS —Pack bits compression.

(The default value is LZW)

String

Code sample

ExportToLayoutGeoTIFF example 1

This script exports the map to a GeoTIFF. The Main data frame is used to obtain the spatial reference information.

import arcpy
import arcpyproduction

# Check out Production Mapping extension
arcpy.CheckOutExtension("foundation")

# Define variables
mxd = arcpy.mapping.MapDocument(r"C:\Project\Project.mxd")
out_tiff = r"C:\Project\GeoTIFFs\Project.tif"
df = arcpy.mapping.ListDataFrames(mxd, "Main")[0]

# Run function with only the required parameters defined
arcpyproduction.mapping.ExportToLayoutGeoTIFF(mxd, out_tiff, df, world_file="True")

# Check in extension
arcpy.CheckInExtension('foundation')
ExportToLayoutGeoTIFF example 2

This script exports a map document with multiple data frames, each of which has a different spatial reference. One GeoTIFF is created for each data frame, and the name of the output GeoTIFF is based on the data frame name.

import os
import arcpy
import arcpyproduction

# Check out Production Mapping extension
arcpy.CheckOutExtension("foundation")

# Define variables
mxd = arcpy.mapping.MapDocument(r"C:\Project\MXDs\Project2.mxd")
out_dir = r"C:\Project\GeoTIFFs"

# Export each data frame as a separate GeoTIFF
for df in arcpy.mapping.ListDataFrames(mxd):
    out_tiff = os.path.join(out_dir, df.name + ".tiff")
    arcpyproduction.mapping.ExportToLayoutGeoTIFF(mxd, out_tiff, df)

# Check in extension
arcpy.CheckInExtension('foundation')

Related topics