ASCII 3D To Feature Class (3D Analyst)

Imports 3D features from one or more ASCII files into a new output feature class. This tool imports XYZ or XYZI or GENERATE file formats.

Learn more about how ASCII 3D To Feature Class (3D Analyst) works

Usage tips


Ascii3DToFeatureClass_3d (input, in_file_type, out_feature_class, out_geometry_type, z_factor, input_coordinate_system, average_point_spacing, file_suffix, decimal_separator)
Parameter Explanation Datatype
Input (Required)

One or more input files or folders.

File | Folder; File | Folder...
Input File Format (Required)

The format of the input file(s).

Output Feature Class (Required)

The output feature class.

Feature Class
Output Feaure Class Type (Required)

The geometry type of the output feature class.

Z Factor (Optional)

A numeric value used as a multiplier on the input z values. This can be used to change vertical units and sign.

Input Coordinate System (Optional)

The coordinate system of the input data.

Coordinate System
Average Point Spacing (Required)

The average planimetric distance between points of the input. This parameter is only used when the output geometry type is set to MULTIPOINT. Its used as a means to bin, or group, the points together. Specify the spacing in the horizontal units of the target feature class.

File Suffix (Optional)

The suffix of the files to import when a folder is specified on input.

Decimal Separator (Optional)

The ASCII file separator. The default is DECIMAL_POINT.

Data types for geoprocessing tool parameters

Script Example

# Purpose: Create feature classes from text files.

# Create the Geoprocessor object
import arcgisscripting
gp = arcgisscripting.create()

#Check out the 3D Analyst extension
gp.CheckOutExtension ("3D")

    # Set the workspace (to avoid having to type in the full path to the data every time)
    gp.workspace = "D:/Docs1/GP/GPOutput"

    # Select the 3D Analyst Toolbox
    gp.toolbox = "3D"

    # Process: creating a feature class using an ASCII input file
   gp.ascii3dtofeatureclass_3d("masspntz.txt", "XYZ", "masspntz2.shp", "POINT")

    # If an error occurred while running the tool print the error messages.
    print gp.GetMessages()

See Also

  • An overview of the 3D Analyst Conversion toolset