Crear referencia espacial

Resumen

Crea un objeto de referencia espacial para utilizar en ModelBuilder.

Uso

• Puede crear una referencia espacial con un conjunto definido de sistema de coordenadas, dominios espaciales y precisión. Los dominios espaciales y la precisión de la referencia espacial de salida se pueden modificar aún más utilizando los parámetros Dominio XY, Dominio Z, Dominio M, Plantillas de dominios XY y Aumentar el dominio XY por porcentaje.

• Las extensiones XY, Z y M no son las mismas que los dominios de referencia espacial. Los dominios XY, Z y M de una referencia espacial definen el rango válido de valores de coordenadas que se pueden almacenar en una clase de entidad. Las extensiones de la clase de entidad reflejan el rango real de valores de coordenadas que existen dentro de la clase de entidad. Estas extensiones no pueden ser más grandes que los dominios.

• No es necesario que el parámetro Plantillas de dominios XY esté en el mismo sistema de coordenadas que el especificado en Referencia espacial o Plantilla de referencia espacial. Si son distintas, las extensiones serán proyectadas para que concuerden.

• Si los parámetros Referencia espacial y Plantilla de referencia espacial están establecidos, el parámetro de Referencia espacial tendrá prioridad.

• Todos los parámetros de la herramienta son opcionales. Si no se especifica ningún parámetro, la referencia espacial se definirá como Desconocida y el Dominio XY asumirá valores predeterminados estándares.

• En ModelBuilder, la salida de esta herramienta se puede utilizar como entrada para herramientas con un parámetro de referencia espacial (por ejemplo, Crear clase de entidad, Crear dataset de entidades y Crear capa de eventos XY).

• En Python, la clase de SpatialReference también se puede utilizar para crear una referencia espacial.

Sintaxis

arcpy.management.CreateSpatialReference({spatial_reference}, {spatial_reference_template}, {xy_domain}, {z_domain}, {m_domain}, {template}, {expand_ratio})

Parámetro	Explicación	Tipo de datos
spatial_reference (Opcional)	El nombre de la referencia espacial que se va a crear.	Spatial Reference
spatial_reference_template (Opcional)	Capa o clase de entidad que se utilizará como plantilla para establecer el valor de la referencia espacial.	Feature Layer; Raster Catalog Layer; Raster Dataset
xy_domain (Opcional)	El rango de coordenadas permisible para coordenadas x,y.	Envelope
z_domain (Opcional)	El rango de coordenadas permisible para los valores z.	String
m_domain (Opcional)	El rango de coordenadas permisible para los valores m.	String
template [template,...] (Opcional)	Las capas o clases de entidad que se pueden utilizar para definir el dominio XY.	Feature Layer
expand_ratio (Opcional)	El porcentaje con el cual se expandirá el dominio XY.	Double

Salida derivada

Nombre	Explicación	Tipo de datos
out_spatial_reference	La referencia espacial de salida. En ModelBuilder, la salida de esta herramienta se puede utilizar como entrada para herramientas con un parámetro de referencia espacial (por ejemplo, Crear clase de entidad, Crear dataset de entidades y Crear capa de eventos XY).	Referencia espacial

Muestra de código

Ejemplo de CreateSpatialReference (script independiente)

La siguiente secuencia de comandos independiente utiliza la función CreateSpatialReference como parte de un flujo de trabajo que se repite en una carpeta y encuentra todos los shapefiles que terminan en ST, crea referencias espaciales y las incorpora a una clase de entidad de geodatabase.

# This script reprojects a shapefile in Redlands folder
# from NAD 1983 UTM Zone 11N
# to NAD 1983 StatePlane California V FIPS 0405 (US Feet)

# import system modules
import arcpy
 
try:
    # set the workspace environment
    arcpy.env.workspace = r"C:\data\Redlands"

    # create a spatial reference object to be used as output coordinate system
    out_sr = arcpy.CreateSpatialReference_management("NAD 1983 StatePlane California V FIPS 0405 (US Feet)")

    # use the output of CreateSpatialReference as input to Project tool
    # to reproject the shapefile
    arcpy.Project_management("citylimit_Project1.shp", "city_CA_FIPS0405", out_sr)

except arcpy.ExecuteError:
    # print geoprocessing message
    print(arcpy.GetMessages(2))
          
except Exception as ex:
    # print the exception message
    print(ex.args[0])

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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