Difference between revisions of "Advanced Input"

From Gcube Wiki
Jump to: navigation, search
(Other Inputs)
Line 131: Line 131:
 
===Other Inputs===  
 
===Other Inputs===  
  
'''Table Input:''' [a http link to a table ]
+
'''Table Input:''' [a http link to a table ] (Example: [https://i-marine.d4science.org/group/biodiversitylab/data-miner?OperatorId=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.clusterers.DBSCAN DBSCAN])
  
'''File Input:''' [a http link to a file]
+
'''File Input:''' [a http link to a file] (Example: [https://i-marine.d4science.org/group/biodiversitylab/data-miner?OperatorId=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.generators.FEED_FORWARD_A_N_N_DISTRIBUTION FEED_FORWARD_A_N_N_DISTRIBUTION])
  
'''List of Tables:''' [a sequence of http links separated by | , each indicating a table ]
+
'''List of Tables:''' [a sequence of http links separated by | , each indicating a table ] (Example [https://i-marine.d4science.org/group/biodiversitylab/data-miner?OperatorId=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.transducerers.BIOCLIMATE_HCAF BIOCLIMATE_HCAF])
  
'''List of columns from a table:''' [a sequence of names of columns from <NameOfTheTableParameter> separated by | ]
+
'''List of columns from a table:''' [a sequence of names of columns from <NameOfTheTableParameter> separated by | ] (Example: [https://i-marine.d4science.org/group/biodiversitylab/data-miner?OperatorId=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.generators.FEED_FORWARD_A_N_N_DISTRIBUTION FEED_FORWARD_A_N_N_DISTRIBUTION])
 
   
 
   
'''Column name from a table:''' [the name of a column from <NameOfTheTableParameter> ]
+
'''Column name from a table:''' [the name of a column from <NameOfTheTableParameter> ] (Example: [https://i-marine.d4science.org/group/biodiversitylab/data-miner?OperatorId=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.transducerers.OCCURRENCE_ENRICHMENT OCCURRENCE_ENRICHMENT])
 
   
 
   
'''List of strings:''' [a sequence of values separated by | ]
+
'''List of strings:''' [a sequence of values separated by | ] (Example: https://i-marine.d4science.org/group/biodiversitylab/data-miner?OperatorId=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.transducerers.OCCURRENCE_ENRICHMENT OCCURRENCE_ENRICHMENT)
 
+
  
 
==References==
 
==References==
 
<!-- {{Reflist}} -->
 
<!-- {{Reflist}} -->

Revision as of 23:29, 21 October 2016

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.[1]
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]".


Name Description Type Default I/O
wktPoint wktPoint [WKT_POINT] String POINT(-12993071.816027395 7729312.300197024) Input
wktLineString wktLineString [WKT_LINESTRING] 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 [WKT_POLYGON] 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 [WKT_TRIANGLE] String POLYGON((-16495722.200167313 7259683.198412901,-15855087.594353283 8572650.25102042,-17312467.71915039 8470972.56789504,-16495722.200167313 7259683.198412901)) Input
wktSquare wktSquare [WKT_SQUARE] String POLYGON((-16495722.200167313 7259683.198412901,-15855087.594353283 8572650.25102042,-17312467.71915039 8470972.56789504,-16495722.200167313 7259683.198412901)) Input
wktPentagon wktPentagon [WKT_PENTAGON] 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 [WKT_HEXAGON] 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 [WKT_BOX] 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 [WKT_CIRCLE] 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:
Spatial Data, DataMiner
WKT Point, DataMiner
WKT LineString, DataMiner
WKT Polygon, DataMiner
WKT Triangle, DataMiner
WKT Square, DataMiner
WKT Pentagon, DataMiner
WKT Hexagon, DataMiner
WKT Box, DataMiner
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]".
Name Description Type Default I/O
dateParameter dateParameter [DATE] String 2016-04-01 Input
timeParameter timeParameter [TIME] 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:


Temporal Data, DataMiner

Other Inputs

Table Input: [a http link to a table ] (Example: DBSCAN)

File Input: [a http link to a file] (Example: FEED_FORWARD_A_N_N_DISTRIBUTION)

List of Tables: [a sequence of http links separated by | , each indicating a table ] (Example BIOCLIMATE_HCAF)

List of columns from a table: [a sequence of names of columns from <NameOfTheTableParameter> separated by | ] (Example: FEED_FORWARD_A_N_N_DISTRIBUTION)

Column name from a table: [the name of a column from <NameOfTheTableParameter> ] (Example: OCCURRENCE_ENRICHMENT)

List of strings: [a sequence of values separated by | ] (Example: https://i-marine.d4science.org/group/biodiversitylab/data-miner?OperatorId=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.transducerers.OCCURRENCE_ENRICHMENT OCCURRENCE_ENRICHMENT)

References

  1. "Well-known text", Wikipedia