Crear puntos aleatorios (Administración de datos)

Resumen

Crea un determinado número de entidades de puntos aleatorios. Los puntos aleatorios se pueden generar en una ventana de extensión, dentro de entidades poligonales, en entidades de puntos o a lo largo de entidades de línea.

Más información sobre el funcionamiento de Crear puntos aleatorios

Uso

  • El área en la cual se generarán puntos aleatorios se puede definir con entidades obligadas de polígono, de punto o de línea, o con una ventana de extensión obligada.

  • El parámetro Cantidad de puntos se puede especificar como un número o como un campo numérico de la clase de entidad obligada que contenga los valores de la cantidad de puntos aleatorios que se deben ubicar en cada entidad. La opción de campo solamente es válida para entidades obligadas de polígono o de línea. Si la cantidad de puntos se proporciona como un número, esa cantidad de puntos aleatorios se generará dentro o a lo largo de cada entidad en la clase de entidad obligada.

    Si utiliza una clase de entidad de restricción que tiene más de una entidad y desea especificar la cantidad total de puntos aleatorios que se generarán (diferente de la cantidad de puntos aleatorios que se colocarán dentro de cada entidad), primero debe usar la herramienta Disolver para que la clase de entidad de restricción contenga una única entidad y, a continuación, debe usar esa clase de entidad disuelta como clase de entidad obligada.

  • El sistema de coordenadas de la clase de entidad de salida será el sistema de coordenadas de la

    • clase de entidad obligada si se ha especificado una.
    • Marco de datos de mapa si se ha especificado una extensión obligada en el mapa utilizando una capa del mapa o la ruta de una clase de entidad.
    • Clase de entidad si se ha especificado una extensión obligada en Python usando la ruta de una clase de entidad.
    • Entorno de geoprocesamiento de sistema de coordenadas de salida si se ha definido (e invalida los demás comportamientos que ya se han detallado)
    • Desconocido si no se cumple ninguna de las opciones anteriores

  • Para asignar valores aleatorios a puntos ubicados de manera aleatoria, genere primero puntos aleatorios con esta herramienta. A continuación, utilice la herramienta Agregar campo para crear un nuevo campo numérico en la clase de entidad de puntos aleatorios. Los tipos de campo sugeridos son entero largo o flotante. Por último, utilice la herramienta Calcular campo para asignar valores aleatorios al campo vacío en la clase de entidad de puntos aleatorios. Para generar un número entero aleatorio entre a y b (incluidos), utilice la expresión de Python random.randint(a,b). Para generar un número flotante aleatorio entre a y b (exclusivamente), utilice la expresión de Python random.uniform(a,b). En el bloque de código, importe el módulo aleatorio utilizando la expresión import random.

  • El parámetro Extensión obligada se puede introducir como un conjunto de coordenadas x e y mínimas y máximas o como igual a la extensión de una capa de entidades o clase de entidad.

  • Si se especifican tanto una clase de rasgo obligada como una extensión obligada, se utilizará el valor de la clase de rasgo obligada y se ignorará el valor de la extensión obligada.

  • Cuando no se puedan ubicar más puntos aleatorios dentro de un área obligada sin infringir la distancia mínima permitida especificada, la cantidad de puntos aleatorios del área obligada se reducirá al máximo posible dentro de la distancia mínima permitida.

  • El parámetro Distancia mínima permitida se puede especificar como una unidad lineal o un campo de las entidades obligadas que contengan valores numéricos. Este valor determina la distancia mínima permitida entre los puntos aleatorios que se encuentran dentro de cada entidad de entrada. La opción de campo solamente es válida para entidades obligadas de polígono o de línea. Los puntos aleatorios pueden estar dentro de la distancia mínima permitida si se generaron dentro de partes de entidades obligadas o a lo largo de ellas.

  • Si se utilizan entidades de puntos como la clase de entidad obligada, se crea un subconjunto aleatorio de entidades de puntos obligadas. No se generan ubicaciones de puntos nuevas.

  • Los valores positivos no enteros de los parámetros Cantidad de puntos y Distancia mínima permitida se redondean al número entero más cercano. Los valores no numéricos y negativos se establecen en 0.

Parámetros

EtiquetaExplicaciónTipo de datos
Localización de salida

Ubicación o espacio de trabajo en el que se crea la clase de entidad de puntos aleatorios. Esta ubicación o este espacio de trabajo ya debe existir.

Feature Dataset;Workspace
Clase de entidad de puntos de salida

Nombre de la clase de entidad de puntos aleatorios que se va a crear.

String
Clase de entidad obligada
(Opcional)

Los puntos aleatorios se generan dentro o a lo largo de las entidades en esta clase de entidad. La clase de entidad obligada puede ser punto, multipunto, línea o polígono. Los puntos se ubican de manera aleatoria dentro de las entidades poligonales, a lo largo de las entidades de línea o en ubicaciones de entidades de puntos. Cada entidad en esta clase de entidad tendrá el número especificado de puntos generados dentro de ella (por ejemplo, si especifica 100 puntos y la clase de entidad obligada tiene 5 entidades, se generarán 100 puntos aleatorios en cada entidad, que suman un total de 500 puntos).

Feature Layer
Extensión obligada
(Opcional)

Los puntos aleatorios se generan dentro de la extensión. La extensión obligada se utiliza solamente si no se especifica una clase de entidad obligada.

  • Extensión de visualización actual Vista de mapa: la extensión se basará en el mapa o la escena activa. La opción solo está disponible cuando haya un mapa activo.
  • Extensión de dibujo Cuadrar y terminar: la extensión se basará en un rectángulo dibujado en el mapa o la escena. Esta opción creará una clase de entidad en la geodatabase del proyecto y agregará una capa al mapa. La clase de entidad tendrá el mismo sistema de coordenadas que el mapa.
    Nota:

    Esta opción no está disponible en el cuadro de diálogo Entornos. Solo está disponible desde un parámetro de herramienta con un tipo de datos de extensión o desde la pestaña Entornos de un cuadro de diálogo de herramienta.

    Nota:

    Cuando la opción de edición Habilitar y deshabilitar edición en la pestaña Editar está activada, es preciso habilitar la edición en la pestaña Editar de la cinta para dibujar la extensión.

  • Extensión de mapa Capa: la extensión se basará en una capa de mapa activa. Use la lista desplegable para seleccionar una capa disponible o use la opción Extensión de datos en todas las capas para obtener la extensión combinada de todas las capas de mapas activos, excepto el mapa base. Esta opción solo está disponible cuando haya un mapa activo con capas.

    Cada capa de mapas tiene las opciones siguientes:

    • Todas las entidades Selecciona todo: extensión de todas las entidades en una capa.
    • Entidades seleccionadasÁrea de entidades seleccionadas: extensión de las entidades seleccionadas en la capa.
    • Entidades visibles Extent Indicator: extensión de las entidades visibles en la capa.
      Nota:

      Las extensiones de las opciones Entidades seleccionadas Área de entidades seleccionadas y Entidades visibles Extent Indicator solo están disponibles para capas de entidades.

  • Examinar Examinar: la extensión se basará en un dataset existente.
  • Portapapeles Pegar: la extensión puede copiarse y pegarse desde el portapapeles.
    • Copiar extensión Copiar: copia las coordenadas de la extensión y el sistema de coordenadas en el portapapeles.
    • Usar Pegar extensión Pegar: pega las coordenadas de la extensión y, si se desea, el sistema de coordenadas desde el portapapeles. Si los valores del portapapeles no incluyen un sistema de coordenadas, la extensión utilizará el sistema de coordenadas del mapa.
    Nota:

    Las coordenadas de la extensión se copian del portapapeles y se pegan con el mismo formato y orden que el objeto Extent de ArcPy: x-min, y-min, x-max, y-max y referencia espacial.

  • Restablecer extensión Restablecer: la extensión se restablecerá al valor predeterminado.
  • Coordenadas introducidas de forma manual: las coordenadas deben ser valores numéricos y encontrarse en el sistema de coordenadas del mapa activo.
    Precaución:

    El mapa podría utilizar unidades de visualización distintas de las coordenadas introducidas. No se admite el uso de una dirección cardinal (N, S, E, O). Utilice un valor de signo negativo para las coordenadas sur y oeste.

Extent; Feature Layer; Raster Layer
Cantidad de puntos [valor o campo]
(Opcional)

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

La cantidad de puntos se puede especificar como un número entero largo o como un campo de las entidades obligadas que contiene valores numéricos que indican la cantidad de puntos aleatorios que se ubicarán en cada entidad. La opción de campo solamente es válida para entidades obligadas de polígono o de línea. Si la cantidad de puntos se proporciona como un número entero largo, esa cantidad de puntos aleatorios se generará dentro o a lo largo de cada entidad en la clase de entidad obligada.

Field; Long
Distancia mínima permitida [valor o campo]
(Opcional)

Distancia más corta permitida entre dos puntos ubicados de manera aleatoria. Si se especifica un valor de 1 metro, todos los puntos aleatorios se ubicarán a más de 1 metro del punto más cercano.

Field; Linear Unit
Crear salida multipunto
(Opcional)

Determina si la clase de entidad de salida será una entidad multiparte o una entidad de una parte.

  • Desactivada: la salida tiene el tipo de geometría punto (cada punto es una entidad separada). Esta es la opción predeterminada.
  • Activada: la salida tiene el tipo de geometría multipunto (todos los puntos forman una sola entidad).
Boolean
Cantidad máxima de puntos por multipunto
(Opcional)

Si la opción Crear salida multipunto está activada, especifique la cantidad de puntos aleatorios que se colocarán en cada geometría multipunto.

Long

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de salida

Clase de entidad de puntos aleatorios de salida.

Feature Class

arcpy.management.CreateRandomPoints(out_path, out_name, {constraining_feature_class}, {constraining_extent}, {number_of_points_or_field}, {minimum_allowed_distance}, {create_multipoint_output}, {multipoint_size})
NombreExplicaciónTipo de datos
out_path

Ubicación o espacio de trabajo en el que se crea la clase de entidad de puntos aleatorios. Esta ubicación o este espacio de trabajo ya debe existir.

Feature Dataset;Workspace
out_name

Nombre de la clase de entidad de puntos aleatorios que se va a crear.

String
constraining_feature_class
(Opcional)

Los puntos aleatorios se generan dentro o a lo largo de las entidades en esta clase de entidad. La clase de entidad obligada puede ser punto, multipunto, línea o polígono. Los puntos se ubican de manera aleatoria dentro de las entidades poligonales, a lo largo de las entidades de línea o en ubicaciones de entidades de puntos. Cada entidad en esta clase de entidad tendrá el número especificado de puntos generados dentro de ella (por ejemplo, si especifica 100 puntos y la clase de entidad obligada tiene 5 entidades, se generarán 100 puntos aleatorios en cada entidad, que suman un total de 500 puntos).

Feature Layer
constraining_extent
(Opcional)

Los puntos aleatorios se generan dentro de la extensión. La extensión obligada se utiliza solamente si no se especifica una clase de entidad obligada.

  • MAXOF: se usará la extensión máxima de todas las entradas.
  • MINOF: se usará el área mínima común a todas las entradas.
  • DISPLAY: la extensión es igual a la visualización visible.
  • Nombre de capa: se utilizará la extensión de la capa especificada.
  • Objeto de Extent: se utilizará la extensión del objeto especificado.
  • Cadena de coordenadas delimitada por espacios: se utilizará la extensión de la cadena especificada. Las coordenadas se expresan como x-min, y-min, x-max, y-max.
Extent; Feature Layer; Raster Layer
number_of_points_or_field
(Opcional)

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

La cantidad de puntos se puede especificar como un número entero largo o como un campo de las entidades obligadas que contiene valores numéricos que indican la cantidad de puntos aleatorios que se ubicarán en cada entidad. La opción de campo solamente es válida para entidades obligadas de polígono o de línea. Si la cantidad de puntos se proporciona como un número entero largo, esa cantidad de puntos aleatorios se generará dentro o a lo largo de cada entidad en la clase de entidad obligada.

Field; Long
minimum_allowed_distance
(Opcional)

Distancia más corta permitida entre dos puntos ubicados de manera aleatoria. Si se especifica un valor de 1 metro, todos los puntos aleatorios se ubicarán a más de 1 metro del punto más cercano.

Field; Linear Unit
create_multipoint_output
(Opcional)

Determina si la clase de entidad de salida será una entidad multiparte o una entidad de una parte.

  • POINTLa salida tiene el tipo de geometría punto (cada punto es una entidad separada). Esta es la opción predeterminada.
  • MULTIPOINTLa salida tiene el tipo de geometría multipunto (todos los puntos forman una sola entidad).
Boolean
multipoint_size
(Opcional)

Si la opción create_multipoint_output está establecida en MULTIPOINT, especifique la cantidad de puntos aleatorios que se colocarán en cada geometría multipunto. El valor predeterminado es 10.

Long

Salida derivada

NombreExplicaciónTipo de datos
out_feature_class

Clase de entidad de puntos aleatorios de salida.

Feature Class

Muestra de código

Ejemplo 1 de CreateRandomPoints (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la herramienta CreateRandomPoints en el modo inmediato.

import arcpy
arcpy.management.CreateRandomPoints("c:/data/project", "samplepoints", 
                                    "c:/data/studyarea.shp", "", 500, "", 
                                    "POINT")
Ejemplo 2 de CreateRandomPoints (secuencia de comandos independiente)

La siguiente secuencia de comandos independiente de Python muestra cómo crear puntos aleatorios con valores aleatorios.

# Name: RandomPointsRandomValues.py
# Purpose: create random points with random values

# Import system modules
import arcpy

# Create random points in the features of a constraining feature class
# Number of points for each feature determined by the value in the field 
# specified
outGDB = "C:/data/county.gdb"
outName = "randpeople"
conFC = "C:/data/county.gdb/blocks"
numField = "POP2000"
arcpy.management.CreateRandomPoints(outGDB, outName, conFC, "", numField)

# set workspace
arcpy.env.workspace = "C:/data/county.gdb"

# Create fields for random values
fieldInt = "fieldInt"
fieldFlt = "fieldFlt"
arcpy.management.AddField(outName, fieldInt, "LONG")  # add long integer field
arcpy.AddField_management(outName, fieldFlt, "FLOAT") # add float field

# Calculate random values between 1-100 in the new fields
arcpy.management.CalculateField(outName, fieldInt, "random.randint(1,100)", 
                                "PYTHON", "import random")
arcpy.management.CalculateField(outName, fieldFlt, "random.uniform(1,100)", 
                                "PYTHON", "import random")
Ejemplo 3 de CreateRandomPoints (secuencia de comandos independiente)

La siguiente secuencia de comandos de Python independiente muestra varios métodos para utilizar la herramienta CreateRandomPoints.

# Name: RandomPoints.py
# Purpose: create several types of random points feature classes

# Import system modules
import arcpy

# set environment settings
arcpy.env.overwriteOutput = True

# Create random points in an extent defined simply by numbers
outFolder = "C:/data"
numExtent = "0 0 1000 1000"
numPoints = 100
outName = "myRandPnts.shp"
arcpy.env.outputCoordinateSystem = "Coordinate Systems/Projected Coordinate Systems/World/Miller Cylindrical (world).prj"
arcpy.management.CreateRandomPoints(outFolder, outName, "", numExtent, numPoints)
arcpy.env.outputCoordinateSystem = ""
 
# Create random points in an extent defined by another feature class
outName = "testpoints.shp"
fcExtent = "C:/data/studyarea.shp"
arcpy.management.CreateRandomPoints(outFolder, outName, "", fcExtent, numPoints)
 
# Create random points in the features of a constraining feature class
# Number of points for each feature determined by the value in the field specified
outGDB = "C:/data/county.gdb"
outName = "randpeople"
conFC = "C:/data/county.gdb/blocks"
numField = "POP2000"
arcpy.management.CreateRandomPoints(outGDB, outName, conFC, "", numField)

# Create random points in the features of a constraining 
# Feature class with a minimum allowed distance
outName = "constparcelpnts"
conFC = "C:/data/county.gdb/parcels"
numPoints = 10
minDistance = "5 Feet"
arcpy.management.CreateRandomPoints(outGDB, outName, conFC, "", numPoints, 
                                    minDistance) 

# Create random points with a multipoint output
outName = "randomMPs"
fcExtent = "C:/data/county.gdb/county"
numPoints = 100
numMP = 10
arcpy.management.CreateRandomPoints(outGDB, outName, "", fcExtent, numPoints, 
                                    "", "MULTIPOINT", numMP)

Información de licenciamiento

  • Basic: Sí
  • Standard: Sí
  • Advanced: Sí

Temas relacionados