Revision as of 02:53, 24 November 2016

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 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 WPS plugin and enter the http://dataminer.d4science.org/wps/WebProcessingService endpoint.

QGIS WPS interface

Related Links

DataMiner Tutorial

Data Mining page