SplitByLocation

Clips the features of the input layer with the polygons of the split layer. Creates a new dataset for the features of the input layer (or portions of them) contained by each polygon from the split layer

Inputs:

Layer to be clipped - a Point, Polyline or Polygon layer
Clip layer - a polygon layer which features will be used for clipping
Output folder
Name field - a field from the Clip layer that will be used for naming of the output datasets
Prefix - a text that will be used together with the Name field for generating names of the output datasets

Outputs:

New feature classes
- The attributes are preserved
- The spatial reference of the input data set is preserved

Notes:

If there are no features from the input layer that are fully or partially within a polygon from the clip layer - no dataset will be created for this polygon

Examples:

The naming of the output dataset is based on the Name field selected and the prefix.

If the Prefix = "Rivers" and the Name field = "StateNames" the resulting feature classes will be named
- "Rivers_Nevada.shp"
- "Rivers_Texas.shp"
- "Rivers_Arizona.shp"
- ...............................
If the prefix box is left empty and the Name field = "StateNames" the resulting feature classes will be named
- "Nevada.shp"
- "Texas.shp"
- "Arizona.shp"
- .................................
If the Prefix = "Roads" and the Name field = "StateNames" and in the output folder there is an existing feature class named "Roads_Nevada.shp", the new feature class will be named "Roads_Nevada1.shp"

ToolBox implementation
(Go to TOP)

Command line syntax

ET_GPSplitByLocation <input_dataset> <clip_dataset> <out_folder> <fuzzy_tolerance> <name_field> {prefix}

Parameters

Expression	Explanation
<input_dataset>	A Point, Polyline or Polygon feature class or feature layer
<clip_dataset>	A Polygon feature class or feature layer. The features of this dataset will be used for clipping
<out_folder>	A String - the name of the output folder (must exist)
<fuzzy_tolerance>	A Double representing the Fuzzy tolerance (in the units of the input dataset) to be used
<name_field>	A String - the name of a field from the clip dataset used for generating the names of the output names
{prefix}	A String - used for generating the names of the output feature classes

Scripting syntax

ET_GPSplitByLocation (input_dataset, clip_dataset, out_folder, fuzzy_tolerance, name_field, prefix)

See the explanations above:
<> - required parameter
{} - optional parameter