table2geotable

Преобразуйте таблицу в геопространственную таблицу

свернуть все на странице

Синтаксис

GT = table2geotable(T)
GT = table2geotable(T,coordinateSystemType,varnames)
GT = table2geotable(___,Name=Value)

Описание

пример

GT = table2geotable(T) преобразовывает таблицу или расписание T к геопространственной таблице GT. Функция создает Shape переменная GT при помощи долготы широты или x-y координирует в T. Каждая переменная T переменная GT.

GT = table2geotable(T,coordinateSystemType,varnames) создает Shape переменная GT при помощи системы координат вводят coordinateSystemType и табличные переменные varnames. Используйте этот синтаксис, чтобы создать Shape переменная из строковых представлений известного текста (WKT) геометрии или из координатных данных.

GT = table2geotable(___,Name=Value) задает опции с помощью аргументов name-value. Например, укажите, что координаты представляют точки, линии или многоугольники при помощи GeometryType аргумент значения имени. Используйте этот синтаксис с любым из входных параметров в предыдущих синтаксисах.

Примеры

свернуть все

Скрипт Open Live Script

Импортируйте данные о событиях цунами как таблица. Координаты широты и долготы точек источника находятся в Latitude и Longitude табличные переменные.

T = readtable("tsunamis.xlsx");

Преобразуйте таблицу в геопространственную таблицу. table2geotable функция обнаруживает Latitude и Longitude переменные и используют их, чтобы создать Shape переменная.

GT = table2geotable(T);

Просмотрите Shape переменная.

GT.Shape
ans = 
  162x1 geopointshape array with properties:

               NumPoints: [162x1 double]
                Latitude: [162x1 double]
               Longitude: [162x1 double]
                Geometry: "point"
    CoordinateSystemType: "geographic"
           GeographicCRS: []
Скрипт Open Live Script

Составьте демонстрационную таблицу. Первая табличная переменная (WKTString) содержит строковое представление WKT геометрии для линий в плоских координатах. Вторая переменная (Name) содержит имена.

wkt1 = "LINESTRING (210320.1875 913333.8125,210320.140625 913366.6875)";
wkt2 = "LINESTRING (210320.4375 913170.9375,210320.34375 913231.1875)";
name1 = "Line 1";
name2 = "Line 2";
T = table([wkt1;wkt2],[name1;name2],VariableNames={'WKTString','Name'})
T=2×2 table
                               WKTString                                  Name  
    ________________________________________________________________    ________

    "LINESTRING (210320.1875 913333.8125,210320.140625 913366.6875)"    "Line 1"
    "LINESTRING (210320.4375 913170.9375,210320.34375 913231.1875)"     "Line 2"

Преобразуйте таблицу в геопространственную таблицу. Создайте Shape переменная таблицы при помощи строк WKT. В данном примере задайте спроектированный CRS как Мир, Равноотстоящий Цилиндрический, который имеет код полномочий EPSG 4087.

GT = table2geotable(T,"planar","WKTString", ...
    CoordinateReferenceSystem=projcrs(4087))
GT=2×3 table
       Shape                                   WKTString                                  Name  
    ____________    ________________________________________________________________    ________

    maplineshape    "LINESTRING (210320.1875 913333.8125,210320.140625 913366.6875)"    "Line 1"
    maplineshape    "LINESTRING (210320.4375 913170.9375,210320.34375 913231.1875)"     "Line 2"

Просмотрите Shape переменная геопространственной таблицы.

GT.Shape
ans=2×1 object
  2x1 maplineshape array with properties:

                NumParts: [2x1 double]
                Geometry: "line"
    CoordinateSystemType: "planar"
            ProjectedCRS: [1x1 projcrs]

Входные параметры

свернуть все

Входная таблица в виде table или timetable объект.

table2geotable функция обнаруживает координаты, когда табличные переменные имеют эти имена, игнорируя регистр.

  • Координаты широты — Latitude или Lat

  • Координаты долготы — Longitudelon , или Long

  • x - координаты — X

  • y - координаты — Y

Если вы задаете входную таблицу с переменной под названием Shape, затем table2geotable функционируйте перезаписывает его.

Типы данных: table

Тип системы координат в виде одной из этих опций:

  • "planar" — Координаты находятся в плоской системе координат.

  • "geographic" — Координаты находятся в географической системе координат.

Типы данных: string

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

  • Создайте Shape переменная из одной табличной переменной, которая содержит строковые представления WKT геометрии путем определения varnames как строковый скаляр, такой как "WKT"

  • Создайте Shape переменная из двух табличных переменных, которые содержат долготу широты или x-y координаты путем определения varnames как двухэлементный вектор строки, такой как ["Lats" "Lons"].

Типы данных: string

Аргументы name-value

Задайте дополнительные пары аргументов как Name1=Value1,...,NameN=ValueN, где Name имя аргумента и Value соответствующее значение. Аргументы name-value должны появиться после других аргументов, но порядок пар не имеет значения.

Пример: table2geotable(T,CoordinateReferenceSystem=geocrs(4326)) задает географический CRS как Мировую Геодезическую Систему 1 984, который имеет код EPSG 4326.

Система координат (CRS), чтобы использовать при создании Shape переменная геопространственной таблицы в виде projcrs или geocrs объект.

Задайте projcrs возразите когда coordinateSystemType "planar" и задайте geocrs возразите когда coordinateSystemType "geographic".

Тип геометрии координатных переменных в виде одной из этих опций:

  • "point" — Координатные поля представляют точки.

  • "line" — Координатные поля представляют линии.

  • "polygon" — Координатные поля представляют многоугольники.

Когда вы указываете, что геометрия вводит как "polygon", table2geotable функция принимает, что координаты задают многоугольники с допустимой топологией. Многоугольник имеет допустимую топологию когда:

  • Внутренние части области направо, когда вы прослеживаете контуры от вершины до вершины.

  • Контуры не имеют никаких самопересечений.

В общем случае внешние границы многоугольников с допустимой топологией имеют вершины в по часовой стрелке, порядок и внутренние отверстия имеют вершины в против часовой стрелки порядок.

Если вы задаете varnames как табличная переменная, содержащая строковые представления WKT геометрии, затем table2geotable функция игнорирует этот аргумент.

Выходные аргументы

свернуть все

Выведите геопространственную таблицу. Геопространственной таблицей является table или timetable объект с Shape переменная, которая содержит geopointshape, geolineshape, geopolyshape, mappointshape, maplineshape, или mappolyshape объекты.

Для входной таблицы размера M-by-N, размер GT M (N + 1).

Советы

  • Когда входная таблица имеет поля долготы широты и x-y переменные, table2geotable функция составляет геопространственную таблицу с помощью переменных долготы широты. Составьте геопространственную таблицу с помощью x-y переменные путем определения coordinateSystemType и varnames аргументы.

Смотрите также

Функции

Темы

Введенный в R2021b

Документация Mapping Toolbox

Поддержка

Для просмотра документации необходимо авторизоваться на сайте