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...

Market Potential Volume Report

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

Summary

Measures the likely demand for a product or service for your market area by a specific geography level by household counts and volume (sales) from market potential data.

Learn more about how Market Potential Volume Report (Business Analyst) works

Usage

  • Total adult population includes individuals 18 years old or older.

  • Typically this report is generated using an MRI profile as the target profile and the boundary of your market as a geographic base profile.

Syntax

MarketPotentialVolumeReport_ba (InputGeographyLevel, BaseProfile, TargetProfile, OutputDirectoryParameterName, {TitleParameterName}, {SegmentationBase}, {CreateThematicMap}, {ThematicMapField}, {OutputFeatureClass}, {ReportFormats})
ParameterExplanationData Type
InputGeographyLevel

The level of geography that will be used to calculate the Market Penetration.

Feature Layer
BaseProfile

The base profile used in the calculation of the index and percent penetration. This profile is usually based on the geographic extent of your customers.

Folder
TargetProfile

The target profile that will be compared to the base profile. Typically, this is based on your customers and is generated using the Segmentation Profile tools.

Folder
OutputDirectoryParameterName

The output directory that will contain the report.

Folder
TitleParameterName
(Optional)

Title for the report.

String
SegmentationBase
(Optional)

The base for the profile.

  • Total Adult Population —Generates a profile using Total Adult Population (18+) as the base.
  • Total Households —Generates a profile using Total Households as the base.
String
CreateThematicMap
(Optional)

Select this option to generate a thematic map on a selected variable.

  • CREATE_THEMATIC —Generates a thematic map.
  • NO_THEMATIC —Does not generate a thematic map.
Boolean
ThematicMapField
(Optional)

Select the field to generate the thematic map.

  • Expected Customers —The estimated number of adults or households that use a particular product or service.
  • Percent Penetration —The measure of the percent of adults or households that use a particular product or service compared to the Total Households or Total Adults in the geography.
  • Index —Measures the likelihood of adults or households in a specified area to exhibit certain consumer behavior compared to the U.S. nation average. The index is tabulated to represent a value of 100 as the overall demand for the base area. A value of more than 100 represents high demand, and a value of less than 100 represents low demand.
String
OutputFeatureClass
(Optional)

The output feature class for the market potential report.

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

Select the desired report output format.

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

Code Sample

MarketPotentialVolumeReport Example (Stand-alone Script)
# Name: MarketPotentialVolumeReport.py
# Description: Generates a market potential report based on ZIP Codes.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.3\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business")

# Define input and output parameters for the Market Potential Report tool
  GeoLayer = "C:/ArcGIS/Business Analyst/US_2014/Data/Demographic Data/esri_zip5.bds"
  Base = "C:/My Output Data/Projects/Default Project/Segmentation/Profiles/Base/Profile.xml"
  Target = "C:/My Output Data/Projects/Default Project/Segmentation/Profiles/Target/Profile.xml"
  OutPath = "C:/My Output Data/Projects/Default Project/Reports/Market Potential"
 
# Create a Market Potential Report
  arcpy.MarketPotentialReport_ba(GeoLayer, Base, Target, OutPath)
 
# 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 Segmentation Analysis 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