Сводка
Создает сетку прямоугольных полигональных объектов, которую можно применять в качестве индексной для указания страниц атласа при использовании многостраничной компоновки (Data Driven Pages). Сетку можно сделать так, чтобы в нее входили только полигональные объекты, пересекающие другие слои объектов.
Использование
Система координат выходного класса пространственных объектов определяется следующим образом:
- Если определен параметр Выходная система координат (Output Coordinate System) в Параметрах среды (Environment Settings), выходному классу объектов присваивается эта система координат.
- Если параметр Выходная система координат (Output Coordinate System) не определен, выходной класс объектов использует систему координат активного фрейма данных (при открытом сеансе ArcMap).
- Если параметр Выходная система координат (Output Coordinate System) не определен, и нет возможности использовать активный фрейм данных (ArcMap не открыт), выходной класс объектов использует систему координат первого входного класса объектов.
- Если параметр Выходная система координат (Output Coordinate System) не определен, и нет возможности использовать активный фрейм данных (ArcMap не открыт), и не указан ни один класс объектов в качестве входного, выходной класс объектов будет с неизвестной системой координат.
Входными объектами могут быть точки, линии, полигоны или растры.
Если выбрано Использовать единицы и масштаб страницы (Use Page Unit and Scale), Масштаб карты (Map Scale) становится обязательным параметром.
При изменении значений высоты и ширины полигонов в случае, если указано Начало отсчета полигональной сетки (Grid Origin Coordinates), число строк и столбцов сетки меняется автоматически.
Когда вы добавляете Входные объекты (Input Features), Начало отсчета полигональной сетки (Grid Origin Coordinates) вычисляется автоматически.
Предпочтительным является сохранение выходного класса объектов в формате базы геоданных. Хотя сохранение в формате шейп-файла допускается, если для вычисления пространственных привязок объектов слоя планируется использовать инструменты Вычислить центральный меридиан и параллели (Calculate_Central_Meridian_And_Parallels) или Вычислить зону UTM (Calculate_UTM_Zone), длина полученных текстовых строк, содержащих данные о координатной системе, может превысить допустимую длину текстового поля (255), установленную для шейп-файла.
Когда параметр Использовать единицы и масштаб страницы (Use Page Unit and Scale) выбран, единицы измерения Ширина полигонов (Polygon Width) и Высота полигонов (Polygon Height) автоматически приводятся в соответствие с единицами, установленными для активной карты. При использовании инструмента вне сессии ArcMap единицами измерения по умолчанию являются дюймы. Хотя вы можете указать любые единицы измерения, например, метры или мили, вы должны использовать только единицы измерения, подходящие для вашей страницы.
Если выбрана опция Использовать единицы и масштаб страницы (Use Page Unit and Scale) значение масштаба по умолчанию соответствует значению масштаба активного фрейма данных в компоновке страницы активного документа ArcMap. При использовании инструмента вне сессии ArcMap значение масштаба по умолчанию равно 1.
Для получения наилучших результатов все входные слои и классы пространственных объектов должны иметь единую систему координат, соответствующую координатной системе фрейма данных, а если вы используете инструмент вне сессии ArcMap, все входные слои и классы пространственных объектов должны иметь одинаковую систему координат, соответствующую координатной системе первого в списке слоя или класса пространственных объектов.
Синтаксис
arcpy.cartography.GridIndexFeatures(out_feature_class, {in_features}, {intersect_feature}, {use_page_unit}, {scale}, {polygon_width}, {polygon_height}, {origin_coord}, {number_rows}, {number_columns}, {starting_page_number}, {label_from_origin})
Параметр | Объяснение | Тип данных |
out_feature_class | Выходной класс пространственных объектов, содержащий полигональные индексные объекты. Система координат выходного класса пространственных объектов определяется следующим образом:
| Feature Class |
in_features [in_features,...] (Дополнительный) | Входные объекты могут быть использованы для определения экстента создаваемой полигональной сетки. | Feature Layer; Raster Layer |
intersect_feature (Дополнительный) | Ограничивает выходной класс пространственных объектов территориями, которые пересекают входные слои и наборы данных. Если указаны входные объекты, значением по умолчанию является INTERSECTFEATURE. Для создания индексных объектов будет использовано пересечение входных объектов.
| Boolean |
use_page_unit (Дополнительный) | Указывает, в единицах ли измерения страницы вводится размер полигона. Значение по умолчанию – NO_USEPAGEUNIT. По умолчанию инструмент использует единицы измерения карты.
| Boolean |
scale (Дополнительный) | Масштаб должен быть обязательно указан, если высота и ширина полигона вычисляются в единицах измерения страницы. Если инструмент используется вне сессии ArcMap, значение масштаба по умолчанию равно 1. | Long |
polygon_width (Дополнительный) | Ширина полигона, указанная в единицах измерения карты или страницы. Если используются единицы измерения страницы, значение по умолчанию составляет 1 дюйм. Если используются единицы измерения карты, значение по умолчанию составляет 1 градус. | Linear unit |
polygon_height (Дополнительный) | Высота полигона, указанная в единицах измерения карты или страницы. Если используются единицы измерения страницы, значение по умолчанию составляет 1 дюйм. Если используются единицы измерения карты, значение по умолчанию составляет 1 градус. | Linear unit |
origin_coord (Дополнительный) | Координата левого нижнего угла выходной сетки. Если указаны входные объекты, значение по умолчанию определяется экстентом, полученным путем объединения этих объектов. Если входные объекты не указаны, значения координат по умолчанию – 0 и 0. | Point |
number_rows (Дополнительный) | Количество строк, которое создается по направлению y, начиная от левого нижнего угла. Значение по умолчанию равно 10. | Long |
number_columns (Дополнительный) | Количество столбцов, которое создается по направлению x, начиная от левого нижнего угла. Значение по умолчанию равно 10. | Long |
starting_page_number (Дополнительный) | Каждому объекту индексной сетки присваивается порядковый номер страницы, начиная с указанного номера. Значение по умолчанию равно 1. | Long |
label_from_origin (Дополнительный) | Нумерация страниц (подписей) с указанного номера (значение по умолчанию – 1) начинается с левой нижней ячейки получившейся сетки. Значение по умолчанию – NO_LABELFROMORIGIN.
| Boolean |
Пример кода
Пример 1 инструмента GridIndexFeatures (окно Python)
Создает GridIndexFeatures с использованием пересечения входных объектов и указанных в единицах измерения карты размеров ячейки.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters","1000 meters")
Пример 2 инструмента GridIndexFeatures (окно Python)
Создает GridIndexFeatures с использованием полного экстента входных объектов и указанных в единицах измерения страницы размеров ячейки.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
"NO_INTERSECTFEATURE","USEPAGEUNIT",
"100000", "5 inches","5 inches")
Пример 3 инструмента GridIndexFeatures (окно Python)
Создает GridIndexFeatures с использованием пересечения входных объектов, указанных в единицах измерения карты размеров ячейки. Нумерация страниц начинается с 5.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
"1000 meters", "1000 meters", "", "",
"", "5")
Пример 4 инструмента GridIndexFeatures (окно Python)
Создает GridIndexFeatures с указанием начала координат, указанных в единицах измерения карты размеров ячейки, а также количества строк и столбцов.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
"1000 meters","1000 meters",
"-6000000 -1600000", "15", "20",)
Пример инструмента GridIndexFeatures #5 (Окно Python)
Создает GridIndexFeatures с указанием начала координат, указанных в единицах измерения страницы размеров ячейки, количества строк и столбцов. Нумерация страниц начинается с 5, а подписывание – с начала координат.
import arcpy
from arcpy import env
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
"100000", "5 inches", "5 inches",
"-6000000 -1600000", "5",
"LABELFROMORIGIN")
Пример 1 инструмента GridIndexFeatures (автономный скрипт Python)
Создает GridIndexFeatures с использованием пересечения входных объектов и указанных в единицах измерения карты размеров ячейки.
# gridindexfeatures_example1.py
# Description: Creates Grid Index Features using the intersection of input
# features and specified index feature dimensions in map units
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
polygonWidth, polygonHeight)
Пример 2 инструмента GridIndexFeatures (автономный скрипт Python)
Создает GridIndexFeatures с использованием полного экстента входных объектов и указанных в единицах измерения страницы размеров ячейки.
# gridindexfeatures_example2.py
# Description: Creates Grid Index Features using the entire extent of input
# features and specified index feature dimensions in page units
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
noIntersect = "NO_INTERSECTFEATURE"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "5 inches"
polygonHeight= "5 inches"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, inFeatures, noIntersect,
usePageUnit, scale, polygonWidth,
polygonHeight)
Пример 3 инструмента GridIndexFeatures (автономный скрипт Python)
Создает GridIndexFeatures с использованием пересечения входных объектов, указанных в единицах измерения карты размеров ячейки. Нумерация страниц начинается с 5.
# gridindexfeatures_example3.py
# Description: Creates Grid Index Features using the intersection of input
# features, specified index feature dimensions in map units and 5 as the
# starting page number
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
arcpy.env.workspace = "C:\data\ProjectData.gdb"
# Set local variables
outFeatureClass = "gridIndexFeatures"
inFeatures = "poly"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
startingPageNum = "5"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass,inFeatures, "", "", "",
polygonWidth, polygonHeight, "", "", "",
startingPageNum)
Пример 4 инструмента GridIndexFeatures (автономный скрипт Python)
Создает GridIndexFeatures с указанием начала координат, указанных в единицах измерения карты размеров ячейки, а также количества строк и столбцов.
# gridindexfeatures_example4.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in map units, the number of
# rows and the number of columns
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")
# Set local variables
outFeatureClass = "gridIndexFeatures"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", "", "",
polygonWidth, polygonHeight, originCoord,
numberRows, numberColumns)
Пример инструмента GridIndexFeatures #5 (автономный скрипт Python)
Создает GridIndexFeatures с указанием начала координат, указанных в единицах измерения страницы размеров ячейки, количества строк и столбцов. Нумерация страниц начинается с 5, а подписывание – с начала координат.
# gridindexfeatures_example5.py
# Description: Creates Grid Index Features by specifying the origin
# coordinates, the index feature dimensions in page units, the number of
# rows, the number of columns, 5 as the starting page number and labeling
# to start at the origin
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:\data\ProjectData.gdb"
env.outputCoordinateSystem = arcpy.SpatialReference("North America Albers Equal Area Conic.prj")
# Set local variables
outFeatureClass = "gridIndexFeatures"
usePageUnit = "USEPAGEUNIT"
scale = "100000"
polygonWidth = "1000 meters"
polygonHeight= "1000 meters"
originCoord = "-6000000 -1600000"
numberRows = "15"
numberColumns = "20"
startingPageNum = "5"
labeling = "LABELFROMORIGIN"
# Execute GridIndexFeatures
arcpy.GridIndexFeatures_cartography(outFeatureClass, "", "", usePageUnit,
scale, polygonWidth, polygonHeight,
originCoord, numberRows, numberColumns,
startingPageNum, labeling)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да