VectorDataDSValidation - Vector Data validation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Vector data validation based on the fusion of features using Dempster-Shafer evidence theory framework.

Detailed description
--------------------

This application validates or unvalidate the studied samples using the Dempster-Shafer theory.

Parameters
----------

This section describes in details the parameters available for this application. Table [#]_ presents a summary of these parameters and the parameters keys to be used in command-line and programming languages. Application key is *VectorDataDSValidation* .

.. [#] Table: Parameters table for Vector Data validation.

+-------------+----------------------------------+--------------------------+
|Parameter Key|Parameter Name                    |Parameter Type            |
+=============+==================================+==========================+
|in           |Input Vector Data                 |Input vector data         |
+-------------+----------------------------------+--------------------------+
|descmod      |Descriptors model filename        |Input File name           |
+-------------+----------------------------------+--------------------------+
|belsup       |Belief Support                    |String list               |
+-------------+----------------------------------+--------------------------+
|plasup       |Plausibility Support              |String list               |
+-------------+----------------------------------+--------------------------+
|cri          |Criterion                         |String                    |
+-------------+----------------------------------+--------------------------+
|thd          |Criterion threshold               |Float                     |
+-------------+----------------------------------+--------------------------+
|out          |Output Vector Data                |Output vector data        |
+-------------+----------------------------------+--------------------------+
|inxml        |Load otb application from xml file|XML input parameters file |
+-------------+----------------------------------+--------------------------+
|outxml       |Save otb application to xml file  |XML output parameters file|
+-------------+----------------------------------+--------------------------+

- **Input Vector Data**: Input vector data to validate.
- **Descriptors model filename**: Fuzzy descriptors model (xml file).
- **Belief Support**: Dempster Shafer study hypothesis to compute belief.
- **Plausibility Support**: Dempster Shafer study hypothesis to compute plausibility.
- **Criterion**: Dempster Shafer criterion (by default (belief+plausibility)/2).
- **Criterion threshold**: Criterion threshold (default 0.5).
- **Output Vector Data**: Output VectorData containing only the validated samples.
- **Load otb application from xml file**: Load otb application from xml file.
- **Save otb application to xml file**: Save otb application to xml file.


Example
-------

To run this example in command-line, use the following: 
::

	otbcli_VectorDataDSValidation -in cdbTvComputePolylineFeatureFromImage_LI_NOBUIL_gt.shp -belsup cdbTvComputePolylineFeatureFromImage_LI_NOBUIL_gt.shp -descmod DSFuzzyModel.xml -out VectorDataDSValidation.shp

To run this example from Python, use the following code snippet: 

::

	#!/usr/bin/python

	# Import the otb applications package
	import otbApplication

	# The following line creates an instance of the VectorDataDSValidation application 
	VectorDataDSValidation = otbApplication.Registry.CreateApplication("VectorDataDSValidation")

	# The following lines set all the application parameters:
	VectorDataDSValidation.SetParameterString("in", "cdbTvComputePolylineFeatureFromImage_LI_NOBUIL_gt.shp")

	VectorDataDSValidation.SetParameterStringList("belsup", ['cdbTvComputePolylineFeatureFromImage_LI_NOBUIL_gt.shp'])

	VectorDataDSValidation.SetParameterString("descmod", "DSFuzzyModel.xml")

	VectorDataDSValidation.SetParameterString("out", "VectorDataDSValidation.shp")

	# The following line execute the application
	VectorDataDSValidation.ExecuteAndWriteOutput()

Limitations
~~~~~~~~~~~

None.

Authors
~~~~~~~

This application has been written by OTB-Team.

See Also
~~~~~~~~

These additional resources can be useful for further information: 
  | http://en.wikipedia.org/wiki/Dempster-Shafer_theory