Clase de entidad Z a ASCII (3D Analyst)

Nivel de licencia:BasicStandardAdvanced

Resumen

Exporta entidades 3D para almacenar los archivos de texto ASCII , GENERATE XYZ, o datos de perfil.

Uso

Sintaxis

FeatureClassZToASCII_3d (in_feature_class, output_location, out_file, {format}, {delimiter}, {decimal_format}, {digits_after_decimal}, {decimal_separator})
ParámetroExplicaciónTipo de datos
in_feature_class

La clase de entidad poligonal, de polilínea, multipunto o punto 3D que se exportarán a un archivos ASCII.

Feature Layer
output_location

La carpeta en donde se escribirán los archivos de salida.

Folder
out_file

El nombre del archivo ASCII resultante.

Si una clase de entidad de línea o polígono se exporta a un formato XYZ, el nombre de archivo se usa como un nombre de base. Cada entidad tendrá una única salida de archivo desde el formato XYZ solo admite una línea o polígono por archivo. Las entidades multiparte también tendrán cada parte escrita en un archivo separado. El nombre de archivo se incorporará con el OID de cada entidad, así como los caracteres adicionales necesarios para hacer cada nombre de archivo único.

String
format
(Opcional)

El formato del archivo ASCII que se está creando.

  • GENERATEEscribe la salida en el formato GENERATE. Esta es la opción predeterminada.
  • XYZEscribe la información XYZ de entidades de entrada. Se creará una archivo por cada línea o polígono en la entidad de entrada.
  • PROFILEEscribe la información de perfil de las entidades de línea que se pueden utilizar en aplicaciones de gráficos exteriores.
String
delimiter
(Opcional)

El delimitador de campo que se utiliza en el archivo de texto.

  • ESPACIOSe utilizará un espacio para delimitar los valores de campo. Esta es la opción predeterminada.
  • COMASe utilizará una coma para delimitar los valores de campo. Esta opción no aplica si el separador decimal también es una coma.
String
decimal_format
(Opcional)

El método que se utiliza para determinar el número de dígitos significativos almacenados en los archivos de salida.

  • AUTOMATICEl número de dígitos significativos necesarios para conservar la precisión disponible, mientras se eliminan los ceros de acompañamiento innecesarios, se determina automáticamente. Esta es la opción predeterminada.
  • FIXEDEl número de dígitos significativos se define en el parámetro Dígitos después del decimal.
String
digits_after_decimal
(Opcional)

Se utiliza cuando la Notación decimal se establece en FIXED. Esto determina cuántos dígitos se escriben después del decimal para los valores de punto flotante escritos en los archivos de salida.

Long
decimal_separator
(Opcional)

El carácter decimal usado en el archivo de texto para diferenciar al entero de un número de su parte fraccionaria.

  • DECIMAL_POINTSe usa un punto como carácter decimal. Esta es la opción predeterminada.
  • DECIMAL_COMMASe usa una coma como carácter decimal.
String

Ejemplo de código

Ejemplo 1 de FeatureClassZToASCII (ventana de Python)

El siguiente ejemplo muestra cómo usar de esta herramienta en la ventana Python:

import arcpy
from arcpy import env

arcpy.CheckOutExtension("3D")
env.workspace = "C:/data"
arcpy.FeatureClassZToASCII_3d("LidarPts.shp", "", "ASCII_LidarPts.txt",
                            "GENERATE", "COMMA", "FIXED", 6, "DECIMAL_POINT")
Ejemplo 2 FeatureClassZToASCII (secuencia de comandos independiente)

El siguiente ejemplo muestra cómo usar esta herramienta en una secuencia de comandos independiente de Python:

'''****************************************************************************
Name: FeatureClassZToASCII Example
Description: This script demonstrates how to use the
             FeatureClassZToASCII tool to create generate files for all
             z-aware point features in a given workspace.
****************************************************************************'''
import arcpy
import exceptions, sys, traceback
from arcpy import env

try:
    # Obtain a license for the ArcGIS 3D Analyst extension
    arcpy.CheckOutExtension('3D')
    # Set environment settings
    env.workspace = 'C:/data'
    # List all points in the target workspace
    fcList = arcpy.ListFeatureClasses("*", "POINT")
    if fcList:
        # Set Local Variables
        outFolder = "C:/output"
        outFormat = "GENERATE"
        delimeter = "SPACE"
        decimal = "FIXED"
        digits = 3
        dec_sep = "DECIMAL_POINT"
        for fc in fcList:    
            # Use Describe method to evaluate whether the feature class is z-aware
            desc = arcpy.Describe(fc)
            if desc.hasZ == True:
                # Define the output file name by replacing '.shp' with _ascii.txt
                outName = fc.replace('.shp', '') + "_ascii.txt"
                #Execute FeatureClassZToASCII_3d
                arcpy.FeatureClassZToASCII_3d(fc, outFolder, outName, outFormat, delimeter, decimal, digits, dec_sep)
    else:
        print "There are no feature classes in the " + env.workspace + " directory."


except arcpy.ExecuteError:
    print arcpy.GetMessages()
except:
    # Get the traceback object
    tb = sys.exc_info()[2]
    tbinfo = traceback.format_tb(tb)[0]
    # Concatenate error information into message string
    pymsg = 'PYTHON ERRORS:\nTraceback info:\n{0}\nError Info:\n{1}'\
          .format(tbinfo, str(sys.exc_info()[1]))
    msgs = 'ArcPy ERRORS:\n {0}\n'.format(arcpy.GetMessages(2))
    # Return python error messages for script tool or Python Window
    arcpy.AddError(pymsg)
    arcpy.AddError(msgs)

Entornos

Temas relacionados

Información sobre licencias

ArcGIS for Desktop Basic: Requiere 3D Analyst
ArcGIS for Desktop Standard: Requiere 3D Analyst
ArcGIS for Desktop Advanced: Requiere 3D Analyst
5/9/2014