Clip
Clip creates subsets of your input DataFrame geometries by clipping them to areas of interest.
Usage notes
Use this tool to cut out a piece of a DataFrame using one or more of the polygons from another DataFrame as a cookie cutter. This is particularly useful for creating a DataFrame that contains a geographic subset of the records from another, larger DataFrame.
The analysis will clip records or portions of records that overlay the areas of interest.
The output geometry type will be the same type as the input geometry being clipped. For example, if you clip linestring geometries within a polygon, the output result will be linestring geometries.
All fields in the
input_
parameter will be included in the output result. Fields from the DataFrame specified indataframe clip_
parameter will not be included in the output.dataframe
Limitations
- You can only clip to polygon geometries.
Results
The tool outputs a subset of the input records that include the following fields:
Field | Description |
---|---|
datetime | If your input had a timestamp column, there will be new fields named start_ for instants, and start_ and end_ for intervals. |
clip_ | The clipped geometries. |
Performance notes
Improve the performance of Clip by doing one or more of the following:
Only analyze the records in your area of interest. You can pick the records of interest by using one of the following SQL functions:
- ST_Intersection—Clip to an area of interest represented by a polygon. This will modify your input records.
- ST_EnvIntersects—Select records that intersect an envelope.
- ST_Intersects—Select records that intersect another dataset or area of intersect represented by a polygon.
- Use ST_Generalize to lower the number or vertices in your input polygons.
Similar capabilities
Use the Overlay tool if you want to intersect, erase or union two datasets.
Use the Spatiotemporal join tool if you want to join two DataFrames based on their spatial relationship.
The following functions complete spatial overlay operations:
- ST_Aggr_Intersection
- ST_Aggr_union
- ST_Contains
- ST_Crosses
- ST_Difference
- ST_Dwithin
- ST_Equals
- ST_Intersection
- ST_Intersects
- ST_Overlaps
- ST_SymDifference
- ST_Touches
- ST_Union
- ST_Within
Syntax
For more details, go to the GeoAnalytics Engine API reference for clip.
Setter | Description | Required |
---|---|---|
run(input_ | Runs the Clip tool using the provided DataFrames. | Yes |
Examples
Run Clip
Plot results
Version table
Release | Notes |
---|---|
1.0.0 | Tool introduced |