ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Summarize Points Report

  • Summary
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

Summary

Aggregates data from a point layer (such as a customer layer) to a polygon layer (such as a trade area).

Learn more about how Summarize Points Report works

Usage

  • This tool allows you to generate trade areas with appended customer or store-based data.

  • Appended values must be volumetric/numeric.

  • All values appended will be summed.

  • Do not append medians, means, or averages.

  • You can generate a report or a mapping layer with the selected appended values attributed.

  • The mapping output will be thematically mapped based on the point count (that is, the number of points that fall within each polygon).

Syntax

SummarizePoints_ba (InputPointLayer, InputBoundaryLayer, IDField, NameField, SummarizePointsFields, {UseSelectedFeatures}, {UseSelectedBoundaries}, {CreateReport}, {ReportTitle}, {ReportFile}, {CreateFeatureClass}, {OutputFeatureClass}, {ReportFormats})
ParameterExplanationData Type
InputPointLayer

The point layer containing the data to be appended to the boundary layer.

Feature Layer
InputBoundaryLayer

The boundary layer that will inherit the selected attributes of the point layer.

Feature Layer
IDField

The ID field of the boundary layer.

Field
NameField

The name field associated with the boundary layer.

Field
SummarizePointsFields
[SummarizePointsFields,...]

The fields (or attributes) of the point layer that will be appended and summed to the boundary layer.

Field
UseSelectedFeatures
(Optional)

Uses selected points to summarize to the boundary layer.

  • True —Uses selected points to summarize to the boundary layer.
  • False —Summarizes the points to the boundary layer on all features. This is the default.
Boolean
UseSelectedBoundaries
(Optional)

Uses the selected boundaries for the point summarization.

  • True —Uses the selected boundaries for the point summarization.
  • False —Uses the selected boundaries for the point summarization on all features. This is the default.
Boolean
CreateReport
(Optional)

Generates a report.

  • True —Will generate a Summarize Points report. This is the default.
  • False —Will not generate a Summarize Points report.
Boolean
ReportTitle
(Optional)

The descriptive title on the output report.

String
ReportFile
(Optional)

Determines the directory the Summarize Points report will be saved to.

Folder
CreateFeatureClass
(Optional)

Generates a new boundary layer with the point data summarizations appended.

  • True —Will generate a Summarized Points boundary layer.
  • False —Will not generate a Summarized Points boundary layer. This is the default.
Boolean
OutputFeatureClass
(Optional)

Determines the directory the new boundary layer will be saved to.

Feature Class
ReportFormats
[ReportFormats,...]
(Optional)

Select the desired report output format

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

Code Sample

SummarizePoints Example (Stand-alone Script)
# Name: SummarizePoints.py
# Description: Summarizes sales data to a trade area in the San Francisco market. 
# Author: Esri

# Import system modules 
 
import arcpy 

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

try: 
# Acquire extension license 
  arcpy.CheckOutExtension("Business") 

# Define input and output parameters for the Summarize Points Report tool

  PointInput = "C:/My Output Data/Projects/Default Project/CustLayers/sf_custs/CustomerLayer.shp" 
  Boundary = "C:/My Output Data/Projects/Default Project/TradeAreas/Sub-geography/TradeArea.shp" 
  Id = "ID" 
  Name = "NAME" 
  Fields = "SALES" 
  Report = "SanFranBGs" 
  Output = "C:/My Output Data/Projects/Default Project/Reports/SummarizePoints_0/Report.rpt" 

# Create the Summarize Points report 

  arcpy.SummarizePoints_ba(PointInput, Boundary, Id, Name, Fields, "false", "false", "true", Report, Output) 

# Release extension license
  arcpy.CheckInExtension("Business")

 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

  • ArcGIS for Desktop Basic: Requires Business Analyst
  • ArcGIS for Desktop Standard: Requires Business Analyst
  • ArcGIS for Desktop Advanced: Requires Business Analyst

Related Topics

  • An overview of the Business Analyst Reports toolset
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal