Map Series Report (Business Analyst)

License Level:BasicStandardAdvanced

Summary

Generates a series of maps based on one or more features of a trade area.

Usage

Syntax

MapSeriesReport_ba (InputBoundaryLayer, All_Or_Single_Or_Selected, IDField, ReportMapSeriesHeadersAndFields, HideInactiveTAs, {ByID_Or_ByName}, {Single_Site}, {CreateReport}, {ReportTitle}, {OutputFolder}, {ExportToImages}, {ImagesFormat}, {ImagesFormatResolution}, {OutputFolderImages}, ReportMapSeriesLandscapeOrientation, {ReportFormats})
ParameterExplanationData Type
InputBoundaryLayer

The input feature class that contains the boundaries that will be embedded into the report.

Feature Layer
All_Or_Single_Or_Selected

Runs a Map Series Report on one or more features.

  • ALLRuns the report on all the features in the boundary layer.
  • SINGLERuns the report only a single selected feature in the boundary layer.
String
IDField

The ID of each boundary which will be reported. These IDs will be located at the top of the report when it is output.

Field
ReportMapSeriesHeadersAndFields

Select from a list of available fields in the Boundary Layer to appear as headers in the report.

Value Table
HideInactiveTAs

Removes all features in the boundary layer from being displayed in the report except for the selected feature.

  • TRUERemoves all features from being displayed in the report except for the selected feature.
  • FALSEIncludes all features for display in the report. This is the default.
Boolean
ByID_Or_ByName
(Optional)

Field used to select a feature.

  • IDSelects a feature using the boundary ID field.
  • NameSelects a feature using the boundary NAME field.
String
Single_Site
(Optional)

Identifies the single feature ID or name to be used in the report.

CreateReport
(Optional)

Generates an output report.

  • TRUECreates a map series report. This is the default.
  • FALSEDoes not create a map series report.
Boolean
ReportTitle
(Optional)

Creates a title for the report.

OutputFolder
(Optional)

The output directory that will contain the report.

ExportToImages
(Optional)

Exports the images in the map series report to a specified folder.

  • TRUEOutputs images to folder.
  • FALSEDoes not output images to folder. This is the default.
Boolean
ImagesFormat
(Optional)

The units used with the distance values. By default, the units defined in the Business Analyst preferences will be selected.

  • JPEGMissing Value
  • BMPMissing Value
  • GIFMissing Value
  • EMFMissing Value
  • PNGMissing Value
  • TIFFMissing Value
String
ImagesFormatResolution
(Optional)

Enter the dots per inch (DPI) for each exported map image.

Double
OutputFolderImages
(Optional)

The output directory that the boundary images will be saved to.

ReportMapSeriesLandscapeOrientation

Locator report page orientation.

  • LANDSCAPEGenerates a landscape-oriented report.
  • PORTRAITGenerates a portrait-oriented report.
String
ReportFormats
[ReportFormats,...]
(Optional)

Select the desired report output format.

  • Simple XML
  • PDF
  • HTML
  • CSV
  • ZIP
  • XLSV
  • Stripped XLSX
String

Code Sample

MapSeriesReport Example (Stand-alone Script)
# Name: MapSeriesReport.py
# Description: Creates a mapping report using predefined drive times.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.2\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

try:     
# Acquire extension license
  arcpy.CheckOutExtension("Business")
     
# Define input and output parameters for the Map Series Report tool

  BoundaryInput = "C:/My Output Data/Projects/Default Project/TradeAreas/DriveTime/US_Drive_Times.shp"
  Id = "ID"
  ReportName = "Map Series Report"
  ReportOut = "C:/My Output Data/Projects/Default Project/Reports/Map Series.shp"
	   	   
# Create the Map Series Report
  arcpy.MapSeriesReport_ba(BoundaryInput, ALL, "#", "#", Id, false, true, ReportName, ReportOut)
 
# Release extension license 
  arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Requires Business Analyst
ArcGIS for Desktop Standard: Requires Business Analyst
ArcGIS for Desktop Advanced: Requires Business Analyst
3/3/2014