ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • Help
  • Sign Out
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS 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
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions

Data types for geoprocessing tool parameters

  • Where data types are needed
  • Determining a parameter's data type
  • String syntax
  • Data types and scripting objects

Geoprocessing is built around the concept of data types. Every tool parameter has an associated data type that defines the contents of the variable. Some simple data types are string (any set of alphanumeric characters), Boolean (a true/false value), and long (an integer value between -2,147,483,648 and 2,147,483,647). In addition to these simple data types, there are dozens of other data types built specifically for data found in ArcGIS, such as field, coordinate system, and extent.

Documentation for each data type is found in Geoprocessing_data_types.pdf. You can also open the document (Geoprocessing_data_types.pdf) from the \arcgis\Documentation folder in your ArcGIS Desktop installation location.

To view this document, you need a copy of Adobe Reader, which you can download free from https://get.adobe.com/reader/.

Where data types are needed

You will be asked to provide data types for variables and parameters in the following situations:

  • In ModelBuilder, when you create a stand-alone variable, you need to provide a data type for the variable to be created.
  • When adding a script tool using the Script Tool wizard, you need to provide the data type for each of the script tool's parameters.

In the case of ModelBuilder, most of the time you create variables from an existing tool parameter. Since all parameters have an associated data type, the variable is automatically created with the correct data type.

Determining a parameter's data type

You can determine the data type of a parameter in the following ways:

  • In a tool's reference page, the syntax section has a table describing each parameter and its data type.
  • In ModelBuilder, create a variable from a tool's parameter. Right-click the variable, click Properties, and click the Data Type tab. The data type is listed at the top of the dialog box.
  • In ModelBuilder, create a model report. The report lists all data types for all parameters.

String syntax

Every data type has a string syntax used in the tool dialog box and in scripting. Most data types have a simple string syntax, such as the path to a dataset, a number, or a keyword. For example, the field data type is the name of the field. Other data types have more complex syntax.

The string syntax for a data type can be found in the PDF file described above. If you are unclear of a particular string syntax for a data type, you can try the following:

  1. Locate a tool that uses the data type.
  2. Execute the tool using its dialog box.
  3. In the Results window, right-click the result and click Copy as Python snippet. Paste this snippet into any text editor (or the Python window) and examine the string values of all parameters.

Data types and scripting objects

The string syntax of some data types is too complex to use in a script. For example, the following is the text string for the spatial reference data type that defines an Eckert IV coordinate system:

PROJCS['World_Eckert_IV',
GEOGCS['GCS_WGS_1984',
DATUM['D_WGS_1984',
SPHEROID['WGS_1984',6378137.0,298.257223563]],
PRIMEM['Greenwich',0.0],
UNIT['Degree',0.0174532925199433]],
PROJECTION['Eckert_IV'],
PARAMETER['False_Easting',0.0],
PARAMETER['False_Northing',0.0],
PARAMETER['Central_Meridian',0.0],
UNIT['Meter',1.0]]

For data types with complex strings, ArcPy contains classes with methods and properties that allow you to easily create and modify the data type. For example, see the SpatialReference class.

ArcGIS Desktop

  • Home
  • Documentation
  • Support

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Esri Blog
  • User Conference
  • Developer Summit
Esri
Tell us what you think.
Copyright © 2021 Esri. | Privacy | Legal