com.esri.arcgis.geoprocessing.tools.analyst3dtools
Class AddFeatureClassToTerrain

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.analyst3dtools.AddFeatureClassToTerrain

All Implemented Interfaces:

GPTool

public class AddFeatureClassToTerrain
extends AbstractGPTool

Adds one or more feature classes to a terrain dataset. The feature classes must reside in the same feature dataset as the terrain dataset. The Add Feature Class to Terrain tool is contained in the 3D Analyst Tools tool box.

Usage tips:

• The feature classes must reside in the same feature dataset as the terrain.
• The terrain dataset may need to be rebuilt using after using this tool. This depends on how the feature class is used to define the terrain dataset. The terrain dataset's Properties dialog box in ArcCatalog and the terrain layer's Properties dialog box in ArcMap both provide an indication as to whether the dataset needs to be rebuilt.
• When used in an SDE database, the input terrain cannot be registered as versioned.
• The input feature class cannot be registered as versioned.
• The terrain dataset must already have one or more pyramid levels created.

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

AddFeatureClassToTerrain()
Creates the Add Feature Class to Terrain tool with defaults.

AddFeatureClassToTerrain(Object inTerrain, Object inFeatures)
Creates the Add Feature Class to Terrain tool with the required parameters.

Method Summary

Object	getDerivedOutTerrain() Returns the Output Terrain parameter of this tool (Read only).
Object	getInFeatures() Returns the Input Feature Class parameter of this tool .
Object	getInTerrain() Returns the Input Terrain parameter of this tool .
String	getToolboxAlias() Returns the alias of the tool box containing this tool.
String	getToolboxName() Returns the name of the tool box containing this tool.
String	getToolName() Returns the name of this tool.
void	setInFeatures(Object inFeatures) Sets the Input Feature Class parameter of this tool .
void	setInTerrain(Object inTerrain) Sets the Input Terrain parameter of this tool .

Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

getParameterValues, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

AddFeatureClassToTerrain

public AddFeatureClassToTerrain()

Creates the Add Feature Class to Terrain tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.

AddFeatureClassToTerrain

public AddFeatureClassToTerrain(Object inTerrain,
                                Object inFeatures)

Creates the Add Feature Class to Terrain tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:

inTerrain - the terrain that feature classes will be added to.

inFeatures - add references to one or more feature classes that will be included in the terrain dataset. The feature classes must live inside the same feature dataset as the terrain dataset. For each feature class you'll need to set properties that indicate how it's used to define the surface. you can resize the dialog box to increase its width in case the default column width is too small. height Source: The field supplying heights for the features. If z-values are coming from the feature geometry, then the Shape field is listed; otherwise, it will be either the name of a numeric field or, in the case of z-less features, the keyword . Z-less features have no heights and their values are interpolated from the surface before they get added. sFType: This is the Surface Feature Type. It defines how the feature geometry gets incorporated into the triangulation for the surface. There are mass points, breaklines, and several polygon types. Breaklines and polygons also have 'hard' and 'soft' qualifiers. These indicate to an interpolator whether the surface crosses over the features smoothly (soft) or with a potentially sharp discontinuity (hard). group: Thematically similar data, representing the same geographic features but at different levels of detail, are placed into groups. Feature classes belonging to the same group are assigned the same group ID. An example is a study area boundary. One feature class may contain a very detailed boundary used for large-scale applications and another with a coarse boundary. Both are used the same way in the terrain, just at different scales, and thus are assigned the same group ID. minimum and Maximum Pyramid: These parameters are used for feature classes added as polyline or polygon surface feature types. They define the range of pyramid levels the features will be enforced in the surface. You provide the resolution thresholds, given in the resolution of the Terrain dataset's pyramid levels. overview: Indicates whether the feature class contributes measurements to the coarsest representation of the Terrain dataset. The overview is what's drawn by default when zoomed to the full extent of the Terrain dataset. Points are always used in the overview. The setting here is for line and polygon data sources. Only set those feature classes that must be represented in the overview to TRUE. For example, you probably don't need detailed breaklines but you might need a clip polygon, particularly if the data boundary is irregularly shaped. If the boundary you have is detailed, generalize it and use the coarser representation for the overview. The detailed version should be used in more detailed pyramid levels. embedded: Feature classes that are embedded are contained by the Terrain dataset itself. They will not be visible in ArcCatalog or the Add Data browser. Only multipoint feature classes can be embedded. They can be accessed and modified through Terrain dataset related tools. embedded Fields: If the feature class is being embedded, and has LAS (i.e., LiDAR) attributes created via the LAS To Multipoint import tool, you can have those attributes preserved. Specify here which LAS attributes to save with the embedded points.

Method Detail

getInTerrain

public Object getInTerrain()

Returns the Input Terrain parameter of this tool . This parameter is the terrain that feature classes will be added to. This is a required parameter.

Returns:

the Input Terrain

setInTerrain

public void setInTerrain(Object inTerrain)

Sets the Input Terrain parameter of this tool . This parameter is the terrain that feature classes will be added to. This is a required parameter.

Parameters:

inTerrain - the terrain that feature classes will be added to.

getInFeatures

public Object getInFeatures()

Returns the Input Feature Class parameter of this tool . This parameter is add references to one or more feature classes that will be included in the terrain dataset. The feature classes must live inside the same feature dataset as the terrain dataset. For each feature class you'll need to set properties that indicate how it's used to define the surface. you can resize the dialog box to increase its width in case the default column width is too small. height Source: The field supplying heights for the features. If z-values are coming from the feature geometry, then the Shape field is listed; otherwise, it will be either the name of a numeric field or, in the case of z-less features, the keyword . Z-less features have no heights and their values are interpolated from the surface before they get added. sFType: This is the Surface Feature Type. It defines how the feature geometry gets incorporated into the triangulation for the surface. There are mass points, breaklines, and several polygon types. Breaklines and polygons also have 'hard' and 'soft' qualifiers. These indicate to an interpolator whether the surface crosses over the features smoothly (soft) or with a potentially sharp discontinuity (hard). group: Thematically similar data, representing the same geographic features but at different levels of detail, are placed into groups. Feature classes belonging to the same group are assigned the same group ID. An example is a study area boundary. One feature class may contain a very detailed boundary used for large-scale applications and another with a coarse boundary. Both are used the same way in the terrain, just at different scales, and thus are assigned the same group ID. minimum and Maximum Pyramid: These parameters are used for feature classes added as polyline or polygon surface feature types. They define the range of pyramid levels the features will be enforced in the surface. You provide the resolution thresholds, given in the resolution of the Terrain dataset's pyramid levels. overview: Indicates whether the feature class contributes measurements to the coarsest representation of the Terrain dataset. The overview is what's drawn by default when zoomed to the full extent of the Terrain dataset. Points are always used in the overview. The setting here is for line and polygon data sources. Only set those feature classes that must be represented in the overview to TRUE. For example, you probably don't need detailed breaklines but you might need a clip polygon, particularly if the data boundary is irregularly shaped. If the boundary you have is detailed, generalize it and use the coarser representation for the overview. The detailed version should be used in more detailed pyramid levels. embedded: Feature classes that are embedded are contained by the Terrain dataset itself. They will not be visible in ArcCatalog or the Add Data browser. Only multipoint feature classes can be embedded. They can be accessed and modified through Terrain dataset related tools. embedded Fields: If the feature class is being embedded, and has LAS (i.e., LiDAR) attributes created via the LAS To Multipoint import tool, you can have those attributes preserved. Specify here which LAS attributes to save with the embedded points. This is a required parameter.

Returns:

the Input Feature Class

setInFeatures

public void setInFeatures(Object inFeatures)

Sets the Input Feature Class parameter of this tool . This parameter is add references to one or more feature classes that will be included in the terrain dataset. The feature classes must live inside the same feature dataset as the terrain dataset. For each feature class you'll need to set properties that indicate how it's used to define the surface. you can resize the dialog box to increase its width in case the default column width is too small. height Source: The field supplying heights for the features. If z-values are coming from the feature geometry, then the Shape field is listed; otherwise, it will be either the name of a numeric field or, in the case of z-less features, the keyword . Z-less features have no heights and their values are interpolated from the surface before they get added. sFType: This is the Surface Feature Type. It defines how the feature geometry gets incorporated into the triangulation for the surface. There are mass points, breaklines, and several polygon types. Breaklines and polygons also have 'hard' and 'soft' qualifiers. These indicate to an interpolator whether the surface crosses over the features smoothly (soft) or with a potentially sharp discontinuity (hard). group: Thematically similar data, representing the same geographic features but at different levels of detail, are placed into groups. Feature classes belonging to the same group are assigned the same group ID. An example is a study area boundary. One feature class may contain a very detailed boundary used for large-scale applications and another with a coarse boundary. Both are used the same way in the terrain, just at different scales, and thus are assigned the same group ID. minimum and Maximum Pyramid: These parameters are used for feature classes added as polyline or polygon surface feature types. They define the range of pyramid levels the features will be enforced in the surface. You provide the resolution thresholds, given in the resolution of the Terrain dataset's pyramid levels. overview: Indicates whether the feature class contributes measurements to the coarsest representation of the Terrain dataset. The overview is what's drawn by default when zoomed to the full extent of the Terrain dataset. Points are always used in the overview. The setting here is for line and polygon data sources. Only set those feature classes that must be represented in the overview to TRUE. For example, you probably don't need detailed breaklines but you might need a clip polygon, particularly if the data boundary is irregularly shaped. If the boundary you have is detailed, generalize it and use the coarser representation for the overview. The detailed version should be used in more detailed pyramid levels. embedded: Feature classes that are embedded are contained by the Terrain dataset itself. They will not be visible in ArcCatalog or the Add Data browser. Only multipoint feature classes can be embedded. They can be accessed and modified through Terrain dataset related tools. embedded Fields: If the feature class is being embedded, and has LAS (i.e., LiDAR) attributes created via the LAS To Multipoint import tool, you can have those attributes preserved. Specify here which LAS attributes to save with the embedded points. This is a required parameter.

Parameters:

inFeatures - add references to one or more feature classes that will be included in the terrain dataset. The feature classes must live inside the same feature dataset as the terrain dataset. For each feature class you'll need to set properties that indicate how it's used to define the surface. you can resize the dialog box to increase its width in case the default column width is too small. height Source: The field supplying heights for the features. If z-values are coming from the feature geometry, then the Shape field is listed; otherwise, it will be either the name of a numeric field or, in the case of z-less features, the keyword . Z-less features have no heights and their values are interpolated from the surface before they get added. sFType: This is the Surface Feature Type. It defines how the feature geometry gets incorporated into the triangulation for the surface. There are mass points, breaklines, and several polygon types. Breaklines and polygons also have 'hard' and 'soft' qualifiers. These indicate to an interpolator whether the surface crosses over the features smoothly (soft) or with a potentially sharp discontinuity (hard). group: Thematically similar data, representing the same geographic features but at different levels of detail, are placed into groups. Feature classes belonging to the same group are assigned the same group ID. An example is a study area boundary. One feature class may contain a very detailed boundary used for large-scale applications and another with a coarse boundary. Both are used the same way in the terrain, just at different scales, and thus are assigned the same group ID. minimum and Maximum Pyramid: These parameters are used for feature classes added as polyline or polygon surface feature types. They define the range of pyramid levels the features will be enforced in the surface. You provide the resolution thresholds, given in the resolution of the Terrain dataset's pyramid levels. overview: Indicates whether the feature class contributes measurements to the coarsest representation of the Terrain dataset. The overview is what's drawn by default when zoomed to the full extent of the Terrain dataset. Points are always used in the overview. The setting here is for line and polygon data sources. Only set those feature classes that must be represented in the overview to TRUE. For example, you probably don't need detailed breaklines but you might need a clip polygon, particularly if the data boundary is irregularly shaped. If the boundary you have is detailed, generalize it and use the coarser representation for the overview. The detailed version should be used in more detailed pyramid levels. embedded: Feature classes that are embedded are contained by the Terrain dataset itself. They will not be visible in ArcCatalog or the Add Data browser. Only multipoint feature classes can be embedded. They can be accessed and modified through Terrain dataset related tools. embedded Fields: If the feature class is being embedded, and has LAS (i.e., LiDAR) attributes created via the LAS To Multipoint import tool, you can have those attributes preserved. Specify here which LAS attributes to save with the embedded points.

getDerivedOutTerrain

public Object getDerivedOutTerrain()

Returns the Output Terrain parameter of this tool (Read only). This is an derived parameter.

Returns:

the Output Terrain

getToolName

public String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias