Manipulación de formas

Las funciones de manipulación de formas se pueden aplicar en la fila Geometría de la columna Expresión en un libro de trabajo Asignaciones. Las funciones se utilizan para definir cómo se transformará la geometría al cargar datos desde el origen al destino. Esta transformación puede incluir la conversión entre tipos de geometría.

Las secciones siguientes describen las funciones de manipulación de formas disponibles.

De polígono a punto

La función De polígono a punto transforma un polígono en un punto utilizando el centroide del polígono. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un polígono y el destino es un punto.

Ilustración

Función De polígono a punto

Sintaxis

polygon_to_point(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

polygon_to_point(!Shape!)

De polígono a multipunto

La función De polígono a multipunto transforma un polígono en un multipunto con un punto en cada vértice del polígono de origen. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un polígono y el destino es un multipunto.

Ilustración

Función De polígono a multipunto

Sintaxis

polygon_to_multipoint(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

polygon_to_multipoint(!Shape!)

De polígono a polilínea de diámetro

La función De polígono a polilínea de diámetro transforma un polígono en una polilínea de segmento único que conecta los dos vértices del polígono que están más alejados a lo largo de su límite. Esta función no se selecciona automáticamente en el libro de trabajo Asignaciones, y debe introducirse de forma manual en la columna Expresión.

Ilustración

Función De polígono a polilínea de diámetro

Sintaxis

polygon_to_diameter_polyline(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

polygon_to_diameter_polyline(!Shape!)

De polígono a polilínea

La función De polígono a polilínea transforma un polígono en una polilínea utilizando el límite del polígono. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un polígono y el destino es una polilínea.

Ilustración

Función De polígono a polilínea

Sintaxis

polygon_to_polyline(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

polygon_to_polyline(!Shape!)

De polilínea a polígono

La función De polilínea a polígono transforma una polilínea en un polígono usando una distancia de zona de influencia especificada. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es una polilínea y el destino es un polígono.

Ilustración

Función De polilínea a polígono

Sintaxis

polyline_to_polygon(shape, distance)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

distance

La distancia alrededor de la entidad de entrada para la zona de influencia.

Doble

Ejemplo

polyline_to_polygon(!Shape!, 20)

De polilínea a punto

La función De polilínea a punto transforma una polilínea en un punto usando una relación de la longitud de la línea. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es una polilínea y el destino es un punto.

Ilustración

Función De polilínea a punto

Sintaxis

polyline_to_point(shape, {ratio})

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

ratio (Opcional)

La distancia a lo largo de la línea donde se ubicará el punto, expresada como una proporción de 0 a 1. El valor predeterminado es 0,5.

Doble

Ejemplo

polyline_to_point(!Shape!, 0.5)

De polilínea a multipunto

La función De polilínea a multipunto transforma una polilínea en un multipunto, creando un punto en cada vértice de la polilínea de origen. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es una polilínea y el destino es un multipunto.

Ilustración

Función De polilínea a multipunto

Sintaxis

polyline_to_multipoint(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

polyline_to_multipoint(!Shape!)

De punto a polígono

La función De punto a polígono transforma un punto en un polígono usando una distancia de zona de influencia especificada. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un punto y el destino es un polígono.

Ilustración

Función De punto a polígono

Sintaxis

point_to_polygon(shape, distance)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

distance

La distancia alrededor de la entidad de entrada para la zona de influencia.

Doble

Ejemplo

point_to_polygon(!Shape!, 50)

De punto a polilínea

La función De punto a polilínea transforma un punto en una polilínea usando una distancia y un ángulo específicos. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un punto y el destino es una polilínea.

Nota:
El vértice inicial de la línea generada tendrá la misma ubicación que el punto de origen.

Ilustración

Función De punto a polilínea

Sintaxis

point_to_polyline(shape, angle, distance)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

angle

El ángulo en el que se generará la polilínea. El ángulo debe estar comprendido entre 0 y 36.

Doble

distance

La distancia alrededor de la entidad de entrada para la zona de influencia.

Doble

Ejemplo

point_to_polyline(!Shape!, 30, 100)

De punto a multipunto

La función De punto a multipunto transforma un punto en un multipunto con una colección de puntos generados aleatoriamente centrados alrededor del punto de origen. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un punto y el destino es un multipunto.

Ilustración

Función De punto a multipunto

Sintaxis

point_to_multipoint(shape, num_points, radius)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

num_points

Cantidad de puntos que se generarán de manera aleatoria.

Corto

radius

El radio dentro del que se dispersarán los puntos generados aleatoriamente.

Doble

Ejemplo

point_to_multipoint(!Shape!, 30, 200)

De multipunto a polígono

La función De multipunto a polígono transforma un multipunto en un polígono utilizando la envoltura convexa del multipunto de origen. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un multipunto y el destino es un polígono.

Nota:
Si la entidad multipunto tiene solo uno o dos puntos, se generará una zona de influencia poligonal con un tamaño de zona de influencia predeterminado. Si la entidad multipunto tiene más de dos puntos, utilizará el método de envoltura convexa para la generación de polígonos.

Ilustración

Función De multipunto a polígono

Sintaxis

multipoint_to_polygon(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

multipoint_to_polygon(!Shape!)

De multipunto a polilínea

La función De multipunto a polilínea transforma un multipunto en una polilínea utilizando la envoltura convexa del multipunto de origen. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un multipunto y el destino es una polilínea.

Nota:
Si la entidad multipunto tiene un solo punto, se generará una polilínea con una dirección y longitud predeterminadas. Si la entidad multipunto tiene dos o más puntos, utilizará el método de envoltura convexa para la generación de polilíneas.

Ilustración

Función De multipunto a polilínea

Sintaxis

multipoint_to_polyline(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

multipoint_to_polyline(!Shape!)

De multipunto a punto

La función De multipunto a punto transforma un multipunto en un punto utilizando el centroide del multipunto de origen. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es un multipunto y el destino es un punto.

Ilustración

Función De multipunto a punto

Sintaxis

multipoint_to_point(shape)

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

Ejemplo

multipoint_to_point(!Shape!)

Crear punto

La función Crear punto crea un punto a partir de las coordenadas x e y de una tabla. También puede incluir z, m e información de referencia espacial. La función se selecciona automáticamente en el libro de trabajo Asignaciones cuando el origen es una tabla y el destino es un punto.

Sintaxis

create_point(x, y, {z}, {m}, {spatial_reference})

NombreExplicaciónTipo de datos

x

El valor x o el campo que contiene el valor x.

Doble

y

El valor y o el campo que contiene el valor y.

Doble

z (Opcional)

El valor z o el campo que contiene el valor z.

Doble

m (Opcional)

El valor m o el campo que contiene el valor m.

Doble

spatial_reference (Opcional)

El sistema de coordenadas horizontales que define la referencia espacial. El sistema de coordenadas se puede configurar mediante un archivo de proyección, un nombre o un código de fábrica.

SpatialReference

Ejemplo

create_point(!x!, !y!, !z!, !m!, 8745)

Mover entidad

La función Mover entidad mueve las coordenadas x, y y z de cualquier tipo de geometría por un valor. Esta función no se selecciona automáticamente en el libro de trabajo Asignaciones, y debe introducirse de forma manual en la columna Expresión.

Sintaxis

move(shape, {x}, {y}, {z})

NombreExplicaciónTipo de datos

shape

El campo que contiene geometría de forma.

Geometría

x (Opcional)

La cantidad para cambiar el valor x.

Doble

y (Opcional)

La cantidad para cambiar el valor y.

Doble

z (Opcional)

La cantidad para cambiar el valor z.

Doble

Ejemplo

move(!Shape!, 50, 50, 50)