Difference between revisions of "How to Interact with the DataMiner by client"

From Gcube Wiki
Jump to: navigation, search
Line 34: Line 34:
  
 
* An example of model (BiOnym) invoked via POST and asynchronously with input data table embedding and uploading is available at [https://svn.research-infrastructures.eu/public/d4science/gcube/trunk/data-analysis/RConfiguration/RD4SFunctions/BiOnym%20from%20R_v3.zip this link]
 
* An example of model (BiOnym) invoked via POST and asynchronously with input data table embedding and uploading is available at [https://svn.research-infrastructures.eu/public/d4science/gcube/trunk/data-analysis/RConfiguration/RD4SFunctions/BiOnym%20from%20R_v3.zip this link]
* An example of long running model (Ichtyop) invoked via POST and asynchronously is available at [http://data.d4science.org/TzZMN0hqTysvcWFCV2tNdUhsL2VIT0Nld3Fid1pGblRHbWJQNStIS0N6Yz0 this link].
+
* An example of long running model (Ichtyop) invoked via POST and asynchronously is available at [https://svn.research-infrastructures.eu/public/d4science/gcube/trunk/data-analysis/RConfiguration/RD4SFunctions/IchtyopClient.zip this link].
* An example of model (XMeans) invoked via POST and asynchronously with input data table embedding and uploading is available at [http://goo.gl/OJazer this link]
+
* An example of model (XMeans) invoked via POST and asynchronously with input data table embedding and uploading is available at [https://svn.research-infrastructures.eu/public/d4science/gcube/trunk/data-analysis/RConfiguration/RD4SFunctions/XMeansClientExample.zip this link]
  
  

Revision as of 11:16, 1 September 2017

Prerequisites

One of the following software is required:

  • Firefox or Google Chrome Web browser
  • IDE: Eclipse Java EE IDE for Web Developers. Version: 3.7+
  • R 3.3.1
  • QGIS

Introduction

Here we show how to invoke an algorithm residing on the DataMiner (DM), from outside an e-Infrastructure or from a client.

Notes on Authorization

The username required to use our clients is the one of the Web portal, e.g. john.smith, whereas the authorization token identifies the VRE to interact with. The token must be generated from the VRE home page through the "Service Authorization Token" tool that is present in the VRE home page. The user name is displayed by the same panel.

HTTP interface

Each DM execution has an HTTP link associated that can be obtained by pressing the "Show" button on the DM interface during the execution of an experiment. By changing the parameters after DataInputs parameter it is possible to manage new computations. Note that a gCube token is required.

Examples of WPS requests to the DataMiner D4Science cluster:

http://dataminer.d4science.org/wps/WebProcessingService?Request=GetCapabilities&Service=WPS&gcube-token=<VRE token>
http://dataminer.d4science.org/wps/WebProcessingService?Request=DescribeProcess&Service=WPS&Version=1.0.0&gcube-token=<VRE token>&Identifier=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.clusterers.DBSCAN
http://dataminer.d4science.org/wps/WebProcessingService?request=Execute&service=WPS&Version=1.0.0&gcube-token=<VRE token>&lang=en-US&Identifier=org.gcube.dataanalysis.wps.statisticalmanager.synchserver.mappedclasses.clusterers.DBSCAN&DataInputs=OccurrencePointsClusterLabel=OccClustersTest;epsilon=10;min_points=1;OccurrencePointsTable=http://goo.gl/VDzpch;FeaturesColumnNames=depthmean%7Csstmnmax%7Csalinitymean;

Java Client

The 52North WPS Client can be used to interact with DataMiner. Note that interactions should use either basic HTTP authentication or add the gcube-token parameter to the requests.

WPS Client

A WPS Client is also available to invoke algorithms from R. Click this link to get the client and examples.

  • An example of model (BiOnym) invoked via POST and asynchronously with input data table embedding and uploading is available at this link
  • An example of long running model (Ichtyop) invoked via POST and asynchronously is available at this link.
  • An example of model (XMeans) invoked via POST and asynchronously with input data table embedding and uploading is available at this link


QGIS

QGIS supports a number of clients for WPS. We advice using the GeoLabs WPS plugin (add the plugin repository at http://geolabs.fr/plugins.xml) and enter the http://dataminer.d4science.org/wps/WebProcessingService endpoint.

QGIS WPS interface
Maps comparison with QGIS

Related Links

DataMiner Tutorial

Data Mining page