De clase de entidad a clase de entidad (Conversión)

Resumen

Convierte un shapefile, una clase de entidad de cobertura o una clase de entidad de geodatabase en un shapefile o clase de entidad de geodatabase.

Uso

  • Los campos del dataset de salida y el contenido de esos campos se pueden controlar utilizando el Mapa de campo.

    • Para cambiar el orden de campos, seleccione un nombre de campo y arrástrelo a la posición que prefiera.
    • El tipo de datos predeterminado de un campo de salida coincide con el tipo de datos del primer campo de entrada (de ese nombre) que encuentre. El tipo de datos se puede cambiar por cualquier otro tipo de datos válido de forma manual en cualquier momento.
    • Están disponibles las siguientes reglas de fusión: primero, último, unir, sumar, valor medio, mediana, modo, mínimo, máximo, desviación estándar y recuento.
    • Cuando utiliza la regla de fusión Unir, puede especificar un delimitador como un espacio, una coma, un punto, un guion, etc. Para utilizar un espacio, asegúrese de que el puntero del ratón esté al comienzo del cuadro de entrada y pulse la barra espaciadora una vez.
    • Puede especificar las posiciones inicial y final de los campos de texto usando la opción de formato.
    • No realice la desviación estándar en una sola entrada, ya que los valores no se pueden dividir por cero, por lo que esta no es una opción válida para las entradas individuales.

    Más información sobre la asignación de campos en scripts

  • Se puede emplear una expresión SQL para seleccionar un subconjunto de entidades. Para obtener información más detallada sobre la sintaxis del parámetro Expresión, consulte los elementos utilizados en las expresiones de consulta en la referencia de SQL.

  • Al convertir los datos de la geodatabase que tiene subtipos o dominios a un shapefile, tanto el subtipo como las descripciones y los códigos de dominio pueden ser incluidos en la salida. Utilice el entorno de geoprocesamiento Transferir las descripciones de dominio de campo para controlar este comportamiento. De forma predeterminada, solo los códigos de dominio y de subtipo se incluirán en la salida, no las descripciones.

    Nota:

    La conversión a shapefiles con descripciones de dominio y subtipo puede tomar más tiempo (un rendimiento más lento) que sin descripciones. Si no necesita las descripciones de subtipo y dominio en el shapefile de salida, se recomienda que utilice el comportamiento predeterminado desactivado del entorno Transferir descripciones de dominio de campo (False o NOT_TRANSFER_DOMAINS en Python) para lograr el mejor rendimiento.

Sintaxis

arcpy.conversion.FeatureClassToFeatureClass(in_features, out_path, out_name, {where_clause}, {field_mapping}, {config_keyword})
ParámetroExplicaciónTipo de datos
in_features

La clase de entidad o capa de entidades que se convierte.

Feature Layer
out_path

La ubicación en la que se crea la clase de entidad de salida. Puede ser una geodatabase o una carpeta. Si la ubicación de salida es una carpeta, la salida será un shapefile.

Workspace;Feature Dataset
out_name

El nombre de la clase de entidad de salida.

String
where_clause
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de entidades. Para obtener más información sobre la sintaxis SQL, consulte el tema de ayuda Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression
field_mapping
(Opcional)

Controla qué campos de atributos estarán en la salida. De forma predeterminada se incluirán todos los campos de las entradas.

Se puede añadir, eliminar y reordenar los campos, además de cambiar su nombre y sus propiedades.

Las reglas de fusión le permiten especificar cómo los valores de dos o más campos de entrada se fusionan o se combinan en un único valor de salida. Hay varias reglas de fusión que puede utilizar para determinan cómo se rellena con valores el campo de salida.

  • Primero: utilizar el primer valor de los campos de entrada.
  • Último: utilizar el último valor de los campos de entrada.
  • Unir: concatenar (unir) los valores de los campos de entrada.
  • Sumar: calcular el total de los valores de los campos de entrada.
  • Valor medio: calcular el valor medio (promedio) de los valores de los campos de entrada.
  • Mediana: calcular el valor de la mediana (mitad) de los valores de los campos de entrada.
  • Modo: utilizar el valor con la mayor frecuencia.
  • Mín.: usar el valor mínimo de todos los valores de los campos de entrada.
  • Máx.: usar el valor máximo de todos los valores de los campos de entrada.
  • Desviación estándar: utilizar el método de clasificación de la desviación estándar en todos los valores de campos de entrada.
  • Conteo: buscar la cantidad de registros incluidos en los cálculos.

En Python puede utilizar la clase FieldMappings para definir este parámetro.

Field Mappings
config_keyword
(Opcional)

Especifica los parámetros de almacenamiento predeterminados (configuraciones) para las geodatabases en un sistema de administración de bases de datos relacionales (RDBMS). Esta configuración solo se aplica cuando se usan tablas de geodatabases corporativas.

El administrador de base de datos establece las palabras clave de configuración.

Más información sobre las palabras clave de configuración

String

Salida derivada

NombreExplicaciónTipo de datos
out_feature_class

La clase de entidad de salida.

Clase de entidad

Muestra de código

Ejemplo 1 de FeatureClassToFeatureClass (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función FeatureClassToFeatureClass en modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
arcpy.FeatureClassToFeatureClass_conversion("buildings_point", 
                                            "C:/output/output.gdb", 
                                            "buildings_point")
Ejemplo 2 de FeatureClassToFeatureClass (script independiente)

El siguiente script independiente muestra cómo utilizar la función FeatureClassToFeatureClass.

# Name: FeatureClassToFeatureClass_Example2.py
# Description: Use FeatureClassToFeatureClass with an expression to create a subset
#  of the original feature class.  
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data/GreenvalleyDB.gdb/Public Buildings"
 
# Set local variables
inFeatures = "buildings_point"
outLocation = "C:/output/output.gdb"
outFeatureClass = "postoffices"
delimitedField = arcpy.AddFieldDelimiters(arcpy.env.workspace, "NAME")
expression = delimitedField + " = 'Post Office'"
 
# Execute FeatureClassToFeatureClass
arcpy.FeatureClassToFeatureClass_conversion(inFeatures, outLocation, 
                                            outFeatureClass, expression)

Información de licenciamiento

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

Temas relacionados