裁剪
===============

1.描述
------------
提取与裁剪要素相重叠的输入要素。

此工具用于以其他要素类中的一个或多个要素作为模具来剪切掉要素类的一部分。在您想要创建一个包含另一较大要素类的地理要素子集的新要素类（也称为研究区域或感兴趣区域 (AOI)）时，裁剪工具尤为有用

2.使用限制
----------------

3.算子id
----------------
igis.gis.analysis.extract.clip

4.参数列表
---------------

+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
| 参数类型 | 参数名称          | 参数关键字             | 必要性 | 参数说明                                                                                                                                                      | 数据类型 |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
| 输入参数 | url               |                        | Y      | 数据源地址                                                                                                                                                    | String   |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
|          | datasources       |                        | N      |                                                                                                                                                               | String   |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
|          | inKeyDsMap        |                        | N      |                                                                                                                                                               | String   |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
|          | in_features       | 待裁剪图层             | Y      | 要裁剪的要素                                                                                                                                                  | String   |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
|          | clip_features     | 用于裁剪输入要素的要素 | Y      | 用于裁剪输入要素的要素。                                                                                                                                      | String   |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
|          | cluster_tolerance | 容差                   | Y      | 所有要素坐标之间的最小距离以及坐标可以沿 X 和/或 Y 方向移动的距离。如果此值设置得较高，则数据的坐标精度将会较低；如果此值设置得较低，则数据的坐标精度将会较高 | String   |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+
| 输出参数 | out_feature_class | 结果图层               | Y      | 待创建的要素类。                                                                                                                                              | String   |
+----------+-------------------+------------------------+--------+---------------------------------------------------------------------------------------------------------------------------------------------------------------+----------+

5.配置面板
--------------------

.. image:: ../../../_static/images/clip_panel.jpg
   :width: 300px


6.调用示例
------------------
.. code::
   
   {
    
     "params":{
       "url":"kudu://172.20.20.15:7051/geomesa_spark",
       "in_features":"hainan",
       "clip_features":"hainan_select",
       "out_feature_class":"hainan_clip",
       "cluster_tolerance":"0.0001"
     },
     "identifier":"igis.gis.analysis.extract.clip"
   }