Difference between revisions of "Statistical Algorithms Importer: Advanced Input"

From Gcube Wiki
Jump to: navigation, search
(Replaced content with "This page was moved [https://wiki.gcube-system.org/gcube/Advanced_Input here]")
 
Line 1: Line 1:
{| align="right"
+
This page was moved [https://wiki.gcube-system.org/gcube/Advanced_Input here]
||__TOC__
+
|}
+
+
:This page explains how to use advanced input definitions when developing an algorithm. These indications are valid for algorithms developed using both the Statistical Algorithms Importer (SAI) and Dataminer.
+
 
+
==Spatial Data==
+
===Defining Spatial Data===
+
:Spatial Data input are passed to an algorithm using Well-Known Text format (WKT), i.e. a text markup language for representing vector geometry objects on a map, spatial reference systems of spatial objects and transformations between spatial reference systems.<ref>[https://en.wikipedia.org/wiki/Well-known_text "Well-known text"], ''[[Wikipedia]]''</ref>
+
:When an algorithm input is defined, a WKT input can be indicated by using proper annotations in the input descriptions. In particular, the annotations highlighted in red in the following table correspond to different geometries. For example a description for an input point could be "Location of an occurrence record [WKT_POINT]".  
+
 
+
 
+
{| class="wikitable"
+
|-
+
! Name
+
! Description
+
! Type
+
! Default
+
! I/O
+
|-
+
| wktPoint
+
| wktPoint <span style="color:red">[WKT_POINT]</span>
+
| String
+
| POINT(-12993071.816027395 7729312.300197024)
+
| Input
+
|-
+
| wktLineString
+
| wktLineString <span style="color:red">[WKT_LINESTRING]</span>
+
| String
+
| LINESTRING(-16476154.320926309 7161843.802207875,-14617205.79303082 7514065.628545967,-12777825.14437634 6790054.096628778,-12601714.231207293 8081534.126535116,-11271098.442818945 7416226.232340941,-11329802.08054196 6261721.357121639)
+
| Input
+
|-
+
| wktPolygon
+
| wktPolygon <span style="color:red">[WKT_POLYGON]</span>
+
| String
+
| POLYGON((-15967389.460660174 7377090.473858931,-14264983.966692729 8257645.039704162,-12895232.41982237 7416226.232340941,-13423565.159329507 5811660.134578522,-13932330.019595642 7181411.681448881,-16123932.494588215 6750918.338146768,-15967389.460660174 7377090.473858931))
+
| Input
+
|-
+
| wktTriangle
+
| wktTriangle <span style="color:red">[WKT_TRIANGLE]</span>
+
| String
+
| POLYGON((-16495722.200167313 7259683.198412901,-15855087.594353283 8572650.25102042,-17312467.71915039 8470972.56789504,-16495722.200167313 7259683.198412901))
+
| Input
+
|-
+
| wktSquare
+
| wktSquare <span style="color:red">[WKT_SQUARE]</span>
+
| String
+
| POLYGON((-16495722.200167313 7259683.198412901,-15855087.594353283 8572650.25102042,-17312467.71915039 8470972.56789504,-16495722.200167313 7259683.198412901))
+
| Input
+
|-
+
| wktPentagon
+
| wktPentagon <span style="color:red">[WKT_PENTAGON]</span>
+
| String
+
| POLYGON((-14284551.845933735 6437832.270290686,-13783375.299284551 7626538.339655062,-14759029.882416394 8470515.936910307,-15863194.122720666 7803416.7083931435,-15569950.56925907 6547149.114045457,-14284551.845933735 6437832.270290686))
+
| Input
+
|-
+
| wktHexagon
+
| wktHexagon <span style="color:red">[WKT_HEXAGON]</span>
+
| String
+
| POLYGON((-11995109.97473614 8492459.590596221,-11950593.230512831 9941648.908612307,-13183369.622696154 10704796.199011508,-14460662.759102784 10018754.171394624,-14505179.503326092 8569564.853378538,-13272403.11114277 7806417.562979337,-11995109.97473614 8492459.590596221))
+
| Input
+
|-
+
| wktBox
+
| wktBox <span style="color:red">[WKT_BOX]</span>
+
| String
+
| POLYGON((-11995109.97473614 8492459.590596221,-11950593.230512831 9941648.908612307,-13183369.622696154 10704796.199011508,-14460662.759102784 10018754.171394624,-14505179.503326092 8569564.853378538,-13272403.11114277 7806417.562979337,-11995109.97473614 8492459.590596221))
+
| Input
+
|-
+
| wktCircle
+
| wktCircle <span style="color:red">[WKT_CIRCLE]</span>
+
| String
+
| POLYGON((-12582146.351966292 8101102.005776119,-12437487.643413674 8354330.862998396,-12345011.010682397 8630915.512769304,-12308270.27890683 8920226.962108605,-12328677.373804664 9211147.13426592,-12405448.062163413 9492496.130175157,-12535632.089482944 9753461.865705855,-12714226.55660141 9984015.573992845,-12934368.178304384 10175297.205322662,-13187597.035526661 10319955.91387528,-13464181.68529757 10412432.546606557,-13753493.13463687 10449173.278382126,-14044413.306794185 10428766.18348429,-14325762.302703422 10351995.495125541,-14586728.03823412 10221811.467806011,-14817281.74652111 10043217.000687543,-15008563.377850927 9823075.37898457,-15153222.086403545 9569846.521762293,-15245698.719134822 9293261.871991385,-15282439.45091039 9003950.422652084,-15262032.356012555 8713030.250494769,-15185261.667653807 8431681.254585532,-15055077.640334276 8170715.519054834,-14876483.173215808 7940161.810767845,-14656341.551512836 7748880.179438027,-14403112.694290558 7604221.470885409,-14126528.04451965 7511744.838154132,-13837216.59518035 7475004.106378564,-13546296.423023034 7495411.2012764,-13264947.427113798 7572181.8896351475,-13003981.691583099 7702365.9169546785,-12773427.983296111 7880960.384073146,-12582146.351966292 8101102.005776119))
+
| Input
+
|}
+
 
+
===Spatial Data on the DataMiner Interface===
+
 
+
:By using a specific widget, DataMiner is able to build a selection interface suited for the WKT input. This process is done by reading the annotation in the input description. The widget allows to easily select the area of interest and reports the WKT selected in a text area. In the end, the WKT string is passed to the algorithm:
+
 
+
[[Image:DataMinerManager_SpatialData.png|thumb|center|555px|Spatial Data, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Point.png|thumb|center|525px|WKT Point, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_LineString.png|thumb|center|525px|WKT LineString, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Polygon.png|thumb|center|525px|WKT Polygon, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Triangle.png|thumb|center|525px|WKT Triangle, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Square.png|thumb|center|525px|WKT Square, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Pentagon.png|thumb|center|525px|WKT Pentagon, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Hexagon.png|thumb|center|525px|WKT Hexagon, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Box.png|thumb|center|525px|WKT Box, DataMiner]]
+
 
+
[[Image:DataMinerManager_WKT_Circle.png|thumb|center|525px|WKT Circle, DataMiner]]
+
 
+
==Temporal Data==
+
===Temporal Data===
+
:Temporal Data are automatically interpreted using specific tags in the description of the inputs. The tags highlighted in red in the following table should be used to indicate the kind of temporal information to associate to the input. Currently, dates and time stamps are supported. For example a description for an input date could be "Date of the occurrence record [DATE]".
+
 
+
{| class="wikitable"
+
|-
+
! Name
+
! Description
+
! Type
+
! Default
+
! I/O
+
|-
+
| dateParameter
+
| dateParameter <span style="color:red">[DATE]</span>
+
| String
+
| 2016-04-01
+
| Input
+
|-
+
| timeParameter
+
| timeParameter <span style="color:red">[TIME]</span>
+
| String
+
| 15:22:01
+
| Input
+
|}
+
 
+
===Temporal Data on DataMiner===
+
:A widget on DataMiner is able to transform the annotations into a selection panel. In the following, two examples are reported:
+
 
+
 
+
[[Image:DataMinerManager_TemporalData.png|thumb|center|555px|Temporal Data, DataMiner]]
+
 
+
==References==
+
<!-- {{Reflist}} -->
+

Latest revision as of 20:31, 21 October 2016

This page was moved here