qasrl_2.12

qasrl

License

License

MIT
GroupId

GroupId

org.julianmichael
ArtifactId

ArtifactId

qasrl_2.12
Last Version

Last Version

0.3.0
Release Date

Release Date

Type

Type

jar
Description

Description

qasrl_2.12
qasrl
Project URL

Project URL

https://github.com/julianmichael/qasrl-crowdsourcing
Source Code Management

Source Code Management

https://github.com/julianmichael/qasrl

Download qasrl_2.12

How to add to project

<!-- https://jarcasting.com/artifacts/org.julianmichael/qasrl_2.12/ -->
<dependency>
    <groupId>org.julianmichael</groupId>
    <artifactId>qasrl_2.12</artifactId>
    <version>0.3.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.julianmichael/qasrl_2.12/
implementation 'org.julianmichael:qasrl_2.12:0.3.0'
// https://jarcasting.com/artifacts/org.julianmichael/qasrl_2.12/
implementation ("org.julianmichael:qasrl_2.12:0.3.0")
'org.julianmichael:qasrl_2.12:jar:0.3.0'
<dependency org="org.julianmichael" name="qasrl_2.12" rev="0.3.0">
  <artifact name="qasrl_2.12" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.julianmichael', module='qasrl_2.12', version='0.3.0')
)
libraryDependencies += "org.julianmichael" % "qasrl_2.12" % "0.3.0"
[org.julianmichael/qasrl_2.12 "0.3.0"]

Dependencies

compile (1)

Group / Artifact Type Version
org.julianmichael : jjm-core_2.12 jar 0.2.0

Project Modules

There are no modules declared in this project.

qasrl

Repository for QA-SRL tools and data, including interaction, crowdsourcing, and the QA-SRL Bank 2.0.

Contents

This repository contains several modules and data utilities.

  • qasrl: General tools for validating, manipulating, and autocompleting QA-SRL.
  • qasrl-crowd: UI and server code for for crowdsourcing QA-SRL data on Mechanical Turk.
  • qasrl-crowd-example: Standalone Mill project demonstrating how to use the crowdsourcing pipeline for your own data.
  • qasrl-bank: Client library for the QA-SRL Bank 2.0.
  • qasrl-bank-service: HTTP service and server implementations for using the QA-SRL Bank 2.0.
  • apps/: Several applications using QA-SRL, including a webapp for browsing the QA-SRL Bank 2.0.
  • data/: QA-SRL data documentation and datasets (downloadable interactively with scripts/download_data.py).

Usage

The four modules qasrl, qasrl-crowd, qasrl-bank, and qasrl-bank-service are published on Maven Central. To use them, add e.g.,

  libraryDependencies += "org.julianmichael" %%% "qasrl" % "0.2.0"

to your sbt project settings, or

  ivy"org.julianmichael::qasrl::0.2.0",

to your Mill ivyDeps (and similarly for the other modules). To inflect verbs you will need our Wiktionary scrape (either via scripts/download_data.py) or here.

To compile this project and run the apps or example project in this repo, you need Mill.

Running the example project

Run python scripts/download_data.py and download the Wiktionary dataset. Then run qasrl-crowd-example/scripts/run_crowd_example.sh. Note that the example project uses an old version of the qasrl libraries as a dependency. Unfortunately a recent dependency upgrade seems to have broken the crowdsourcing interfaces and I haven't figured out the fix yet.

Autocomplete

To get an idea of how the autocomplete functionality works, try running scripts/run_autocomplete_example.sh. This will throw you into a REPL where you may type prefixes to questions (or full questions) and get the autocomplete feedback displayed to you when you press Enter.

If you wish to use the autocomplete or other functionality in your own code, take a look at scripts/autocomplete_example.scala, which was running in the previous step, for example usage.

Crowdsourcing

To start up the crowdsourcing pipeline and see a preview of the task UI, run scripts/run_crowd_example.sh and go to localhost:8888/task/generation/preview in your browser. To understand how to set everything up so it works on MTurk, adapt the instructions here to the local code. To trace the main entry points:

  • scripts/crowd_example.scala is what you run on the SBT console to get started.
  • That creates an AnnotationSetup object defined in qasrl-crowd-example, which assembles the various data and resources needed for the crowdsourcing pipeline.
  • That creates a QASRLAnnotationPipeline object, which creates the web services and interfaces with MTurk to upload and download data and assess workers.
  • Finally, telling the QASRLAnnotationPipeline object to start() will start the crowdsourcing task.

Again, see the instructions in the QAMR project for a more detailed account (though it is very slightly out of date).

Versions

Version
0.3.0
0.2.0
0.1.0