In order to give an idea of the capabilities of our pipeline, we are running an instance on our server and we show how to use the S3QACore Framework to invoke it from a client machine.

Preliminaries

Before testing the following examples, the project needs to be installed (see instructions in the README.md file).

At the end, the following file should have been created: target/s3qa-uima-pipeline-core-0.0.1-SNAPSHOT.jar

Example 1: Invoking the S3QA Pipeline deployed on our cluster for creating the representation of the data

Assuming to be in the main folder of the project, the following command creates the feature representation of the ConvKN team submission at SemEval 2016 task 3-B competition:

java -jar target/s3qa-uima-pipeline-core-0.0.1-SNAPSHOT.jar -ef --input-file src/test/resources/data/XML/SemEval/English/SemEval2016-Task3-CQA-QL-train.xml --output-file convkn-semeval16-3B-train.klp -ip cqa.iyas.qcri.org -qn featureExtractionScaleout20 -rt qr

The jar executes the class Starter.java, which provides a convenient interface to invoke the functionalities of the pipeline. The option -ef indicates that feature extraction will be performed, -ip is the address of the machine where the pipeline is deployed, -qn is the name of the remote queue where the request will be sent (there might be more than one service deployed on the same remote cluster), -rt is the task, semeval task 3-B is a question re-ranking task. The representation are saved on file "convkn-semeval16-3B-train.klp" in KeLP format.

Example 2: Invoking the S3QA Pipeline deployed on our cluster for performing learning and classification

Learning can be invoked with the following command:

java -jar target/s3qa-uima-pipeline-core-0.0.1-SNAPSHOT.jar -l -ip cqa.iyas.qcri.org -qn convknLearning -if src/test/resources/data/XML/SemEval/English/SemEval2016-Task3-CQA-QL-train.xml -of convknModel -rt qr

Finally, classification can be invoked with the following command:

java -jar target/s3qa-uima-pipeline-core-0.0.1-SNAPSHOT.jar -c -if src/test/resources/data/XML/SemEval/English/SemEval2016-Task3-CQA-QL-test.xml -ip cqa.iyas.qcri.org -of scores -qn convknClassification -rt qr