Объекты индексной сетки (Картография)

Сводка

Создает сетку прямоугольных полигональных объектов, которую можно применять в качестве индексной для указания страниц пространственной серии карт. Сетку можно сделать так, чтобы в нее входили только полигональные объекты, пересекающие другие слои объектов.

Использование

  • Система координат выходного класса пространственных объектов определяется следующим образом:

    • Если определен параметр Выходная система координат в Параметрах среды, выходному классу объектов присваивается эта система координат.
    • Если параметр Выходная система координат не определен, выходной класс объектов использует систему координат входного класса объектов.
    • Если параметр среды Выходная система координат не определен, и нет активной карты (ArcGIS Pro не открыт), выходной класс объектов будет использовать систему координат первого входного объекта.
    • Если параметр среды Выходная система координат не определен, нет активной карты (ArcGIS Pro не открыт) и не указан ни один класс объектов в качестве входного, выходной класс объектов будет с неизвестной системой координат.
  • Входными объектами могут быть точки, линии, полигоны или растры.

  • Если используется параметр Использовать единицы и масштаб страницы, Масштаб карты становится обязательным параметром.

  • При изменении в диалоговом окне инструмента значений высоты и ширины полигонов в случае, если указано Начало отсчета полигональной сетки, число строк и столбцов сетки меняется автоматически. Число строк и столбцов автоматически вычисляется на основе координат начала отсчета экстента класса пространственных объектов. Если начало отсчета координат x,y меняется так, что общий экстент увеличивается, соответствующее число столбцов и строк обновляется. Если общий экстент уменьшен, изменения будут проигнорированы, и будет использоваться полный экстент объектов

  • Когда вы добавляете параметр Входные объекты, значение параметра Начало координат грида полигона вычисляется автоматически.

  • Когда параметр Использовать единицы и масштаб страницы выбран, единицы измерения Ширины полигона и Высоты полигона автоматически приводятся в соответствие с единицами, установленными для активного фрейма карты. При использовании инструмента вне сеанса ArcGIS Pro единицами измерения по умолчанию являются дюймы. Хотя вы можете указать любые единицы измерения карты, например, метры или мили, вы должны использовать только единицы измерения, подходящие для вашей страницы.

  • Если выбрана опция Использовать единицы и масштаб страницы, значение масштаба по умолчанию соответствует значению масштаба активного фрейма данных на странице компоновки. При использовании инструмента вне сеанса ArcGIS Pro значение масштаба по умолчанию равно 1.

  • Для получения наилучших результатов все входные слои и классы пространственных объектов должны иметь единую систему координат, соответствующую координатной системе карты или фрейма карты, а если вы используете инструмент вне сеанса ArcGIS Pro, все входные слои и классы пространственных объектов должны иметь одинаковую систему координат, соответствующую координатной системе первого в списке слоя или класса пространственных объектов.

Синтаксис

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})
ParameterОбъяснениеТип данных
out_feature_class

Итоговый класс пространственных объектов, содержащий полигональные индексные объекты.

Система координат выходного класса пространственных объектов определяется следующим образом:

  • Если определен параметр Выходная система координат в Параметрах среды, выходному классу объектов присваивается эта система координат.
  • Если параметр среды Выходная система координат не определен, выходной класс объектов использует систему координат активной карты (ArcGIS Pro открыто).
  • Если параметр среды Выходная система координат не определен, и нет активной карты (ArcGIS Pro не открыт), выходной класс объектов будет использовать систему координат первого входного объекта.
  • Если параметр среды Выходная система координат не определен, нет активной карты (ArcGIS Pro не открыт) и не указан ни один класс объектов в качестве входного, выходной класс объектов будет с неизвестной системой координат.
Feature Class
in_features
[in_features,...]
(Дополнительный)

Будут созданы входные объекты, использованные для определения экстента создаваемой полигональной сетки.

Feature Layer; Raster Layer
intersect_feature
(Дополнительный)

Ограничивает выходной класс пространственных объектов территориями, которые пересекают входные слои и наборы данных. Для создания индексных объектов будет использовано пересечение входных объектов.

  • INTERSECTFEATUREОграничивает выходной класс пространственных объектов территориями, которые пересекают входные слои и наборы данных. Используется по умолчанию, когда заданы входные объекты.
  • NO_INTERSECTFEATUREВыходной класс пространственных данных, содержащих сетку, создается с использованием указанных координат, строк и столбцов.
Boolean
use_page_unit
(Дополнительный)

Определяет, в единицах ли измерения страницы вводится размер полигона.

  • USEPAGEUNITВысота и ширина индексного полигона вычисляются в единицах измерения страницы.
  • NO_USEPAGEUNITВысота и ширина индексного полигона вычисляются в единицах измерения карты. Это значение по умолчанию.
Boolean
scale
(Дополнительный)

Масштаб карты. Масштаб должен быть обязательно указан, если высота и ширина полигона вычисляются в единицах измерения страницы. Если инструмент используется вне активного сеанса ArcGIS Pro, значение масштаба по умолчанию равно 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
(Дополнительный)

Задает начало нумерации страниц (подписей).

  • LABELFROMORIGINНумерация страниц (подписей) начинается с левого нижнего полигонального объекта получившейся сетки.
  • NO_LABELFROMORIGINНумерация страниц (подписей) начинается с левого верхнего угла выходной сетки. Это значение по умолчанию.
Boolean

Пример кода

GridIndexFeatures, пример 1 (окно Python)

В этом примере создаются объекты индексной сетки с использованием пересечения входных объектов и указанных в единицах измерения карты размеров ячейки.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
                                    "1000 meters", "1000 meters")
GridIndexFeatures, пример 2 (окно Python)

В этом примере создаются объекты индексной сетки с использованием полного экстента входных объектов и указанных в единицах измерения страницы размеров ячейки.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly",
                                    "NO_INTERSECTFEATURE", "USEPAGEUNIT",
                                    "100000", "5 inches", "5 inches")
GridIndexFeatures, пример 3 (окно Python)

В следующем примере создаются объекты индексной сетки с использованием пересечения входных объектов, указанных в единицах измерения карты размеров ячейки. Нумерация страниц начинается с 5.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures","poly", "", "", "",
                                    "1000 meters", "1000 meters", "", "",
                                    "", "5")
GridIndexFeatures, пример 4 (окно Python)

В следующем примере создаются объекты индексной сетки с указанием начала координат, указанных в единицах измерения карты размеров ячейки, а также количества строк и столбцов.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "", "",
                                    "1000 meters","1000 meters",
                                    "-6000000 -1600000", "15", "20")
GridIndexFeatures, пример 5 (окно Python)

В этом примере создаются объекты индексной сетки с указанием начала координат, указанных в единицах измерения страницы размеров ячейки, количества строк и столбцов.Нумерация страниц начинается с 5, а подписывание - с начала координат.

import arcpy
arcpy.env.workspace = "C:\data\ProjectData.gdb"
arcpy.GridIndexFeatures_cartography("gridIndexFeatures", "", "", "USEPAGEUNIT",
                                    "100000", "5 inches", "5 inches",
                                    "-6000000 -1600000", "15", "20", "5",
                                    "LABELFROMORIGIN")
GridIndexFeatures, пример 6 (автономный скрипт)

В этом примере создаются объекты индексной сетки с использованием пересечения входных объектов и указанных в единицах измерения карты размеров ячейки.

# 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)
GridIndexFeatures, пример 7 (автономный скрипт)

В этом примере создаются объекты индексной сетки с использованием полного экстента входных объектов и указанных в единицах измерения страницы размеров ячейки.

# 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)
GridIndexFeatures, пример 8 (автономный скрипт)

В следующем примере создаются объекты индексной сетки с использованием пересечения входных объектов, указанных в единицах измерения карты размеров ячейки. Нумерация страниц начинается с 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)
GridIndexFeatures, пример 9 (автономный скрипт)

В следующем примере создаются объекты индексной сетки с указанием начала координат, указанных в единицах измерения карты размеров ячейки, а также количества строк и столбцов.

# 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, пример 10 (автономный скрипт)

В этом примере создаются объекты индексной сетки с указанием начала координат, указанных в единицах измерения страницы размеров ячейки, количества строк и столбцов.Нумерация страниц начинается с 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: Да

Связанные разделы