Difference between revisions of "How to Interact with the DataMiner by client"
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 [ | + | * 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 [ | + | * 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
Contents
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.