Create Fishnet (Data Management)

Summary

Creates a fishnet of rectangular cells. The output can be polyline or polygon features.

Learn more about how Create Fishnet works

Usage

  • The coordinate system of the output can be set by either entering a feature class or layer in the Template Extent parameter or setting the Output Coordinate System environment variable.

  • In addition to creating the output fishnet, a new point feature class is created with label points at the center of each fishnet cell if the Create Label Points parameter is checked. The name of this feature class is the same as the output feature class with a suffix of _label and is created in the same location.

  • Using the Geometry Type parameter, you can create output polyline (default) or polygon cells. Creating a polygon fishnet may be slower, depending on the number of rows and columns.

  • The Cell Size Width and the Cell Size Height parameter values are in the same units as defined by the output feature class.

Parameters

LabelExplanationData Type
Output Feature Class

The output feature class containing the fishnet of rectangular cells.

Feature Class
Fishnet Origin Coordinate

The starting pivot point of the fishnet.

Point
Y-Axis Coordinate

The y-axis coordinate is used to orient the fishnet. The fishnet is rotated by the same angle as defined by the line connecting the origin and the y-axis coordinate.

Point
Cell Size Width

The width of each cell. To calculate the cell width using the Number of Rows parameter value, leave this parameter unspecified or set the value to zero; the width will be calculated when the tool is run.

Double
Cell Size Height

The height of each cell. To calculate the cell height using the Number of Columns parameter value, leave this parameter unspecified or set the value to zero; the height will be calculated when the tool is run.

Double
Number of Rows

The number of rows the fishnet will have. To calculate the number of rows using the Cell Size Width parameter value, leave this parameter unspecified or set the value to zero; the number of rows will be calculated when the tool is run.

Long
Number of Columns

The number of columns the fishnet will have. To calculate the number of columns using the Cell Size Height parameter value, leave this parameter unspecified or set the value to zero; the number of columns will be calculated when the tool is run.

Long
Opposite corner of Fishnet
(Optional)

The opposite corner of the fishnet set by the Fishnet Origin Coordinate parameter. The values for opposite corner are automatically set if the Template Extent parameter is specified.

This parameter is inactive if the Fishnet Origin Coordinate, Y-Axis Coordinate, Cell Size Width, Cell Size Height, Number of Rows and Number of Columns parameters are specified.

Point
Create Label Points
(Optional)

Specifies whether a point feature class will be created containing label points at the center of each fishnet cell.

  • Checked—A point feature class will be created. This is the default.
  • Unchecked—A point feature class will not be created.
Boolean
Template Extent
(Optional)

The extent of the fishnet. The extent can be entered by specifying the coordinates or using a template dataset.

  • Default—The extent will be based on the maximum extent of all participating inputs. This is the default.
  • Current Display Extent—The extent is equal to the data frame or visible display. The option is not available when there is no active map.
  • As Specified Below—The extent will be based on the minimum and maximum extent values specified.
  • Browse—The extent will be based on an existing dataset.
Extent
Geometry Type
(Optional)

Specifies whether the output fishnet cells will be polyline or polygon features.

  • PolylineOutput will be a polyline feature class. Each cell is defined by four line features.
  • PolygonOutput will be a polygon feature class. Each cell is defined by one polygon feature.
String

Derived Output

LabelExplanationData Type
Output Label Feature Class (Optional)

A new point feature class is created with label points at the center of each fishnet cell

If the Create Label Points parameter is checked, a new point feature class will be created with label points at the center of each fishnet cell. The name of this feature class is the same as the output feature class with a suffix of _label and is created in the same location.

If the labels parameter is set to LABELS, a new point feature class will be created with label points at the center of each fishnet cell. The name of this feature class is the same as the output feature class with a suffix of _label and is created in the same location.

Feature Class

arcpy.management.CreateFishnet(out_feature_class, origin_coord, y_axis_coord, cell_width, cell_height, number_rows, number_columns, {corner_coord}, {labels}, {template}, {geometry_type})
NameExplanationData Type
out_feature_class

The output feature class containing the fishnet of rectangular cells.

Feature Class
origin_coord

The starting pivot point of the fishnet.

Point
y_axis_coord

The y-axis coordinate is used to orient the fishnet. The fishnet is rotated by the same angle as defined by the line connecting the origin and the y-axis coordinate.

Point
cell_width

The width of each cell. To calculate the cell width using the number_rows parameter value, leave this parameter unspecified or set the value to zero; the width will be calculated when the tool is run.

Double
cell_height

The height of each cell. To calculate the cell height using the number_columns parameter value, leave this parameter unspecified or set the value to zero; the height will be calculated when the tool is run.

Double
number_rows

The number of rows the fishnet will have. To calculate the number of rows using the cell_width parameter value, leave this parameter unspecified or set the value to zero; the number of rows will be calculated when the tool is run.

Long
number_columns

The number of columns the fishnet will have. To calculate the number of columns using the cell_height parameter value, leave this parameter unspecified or set the value to zero; the number of columns will be calculated when the tool is run.

Long
corner_coord
(Optional)

The opposite corner of the fishnet set by the origin_coord parameter.

This parameter is disabled if the origin_coord, y_axis_coord, cell_width, cell_height, number_rows and number_columns parameters are specified.

Point
labels
(Optional)

Specifies whether a point feature class will be created containing label points at the center of each fishnet cell.

  • LABELSA point feature class will be created. This is the default.
  • NO_LABELSA point feature class will not be created.
Boolean
template
(Optional)

The extent of the fishnet. The extent can be entered by specifying the coordinates or using a template dataset.

  • MAXOF—The maximum extent of all inputs will be used.
  • MINOF—The minimum area common to all inputs will be used.
  • DISPLAY—The extent is equal to the visible display.
  • Layer name—The extent of the specified layer will be used.
  • Extent object—The extent of the specified object will be used.
  • Space delimited string of coordinates—The extent of the specified string will be used. Coordinates are expressed in the order of x-min, y-min, x-max, y-max.
Extent
geometry_type
(Optional)

Specifies whether the output fishnet cells will be polyline or polygon features.

  • POLYLINEOutput will be a polyline feature class. Each cell is defined by four line features.
  • POLYGONOutput will be a polygon feature class. Each cell is defined by one polygon feature.
String

Derived Output

NameExplanationData Type
out_label

A new point feature class is created with label points at the center of each fishnet cell

Feature Class

Code sample

CreateFishnet example 1 (Python window)

The following Python window script demonstrates how to use the CreateFishnet function in immediate mode.

import arcpy

# Create a fishnet with 9 columns and 9 rows
# with origin at (1, 1) and output geometry is set to default (POLYLINE)
arcpy.CreateFishnet_management("C:/data/output/fishnet1.shp", "1 1", "1 9", "1", "1", "9", "9", "#", "NO_LABELS")
CreateFishnet example 2 (stand-alone script)

The following stand-alone script shows how to create rectangular cells (fishnet) using the CreateFishnet function.

# Name: CreateFishnet.py
# Description: Creates rectangular cells

# import system module
import arcpy
from arcpy import env

# set workspace environment
env.workspace = "C:/data/output"

# Set coordinate system of the output fishnet
env.outputCoordinateSystem = arcpy.SpatialReference("NAD 1983 UTM Zone 11N")

outFeatureClass = "fishnet10by10.shp"

# Set the origin of the fishnet
originCoordinate = '1037.26 4145.81'

# Set the orientation
yAxisCoordinate = '1037.26 4155.81'

# Enter 0 for width and height - these values will be calcualted by the tool
cellSizeWidth = '0'
cellSizeHeight = '0'

# Number of rows and columns together with origin and opposite corner 
# determine the size of each cell 
numRows =  '10'
numColumns = '10'

oppositeCoorner = '19273.61 18471.17'

# Create a point label feature class 
labels = 'LABELS'

# Extent is set by origin and opposite corner - no need to use a template fc
templateExtent = '#'

# Each output cell will be a polygon
geometryType = 'POLYGON'

arcpy.CreateFishnet_management(outFeatureClass, originCoordinate, yAxisCoordinate, cellSizeWidth, cellSizeHeight, numRows, numColumns, oppositeCoorner, labels, templateExtent, geometryType)