https://github.com/dkpro/dkpro-argumentation

DKPro Argumentation is a general framework for argumentation mining
https://github.com/dkpro/dkpro-argumentation

Last synced: 10 months ago
JSON representation

DKPro Argumentation is a general framework for argumentation mining

• Host: GitHub
• URL: https://github.com/dkpro/dkpro-argumentation
• Owner: dkpro
• License: apache-2.0
• Created: 2015-08-18T09:01:02.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2017-08-02T10:10:27.000Z (almost 9 years ago)
• Last Synced: 2025-08-12T16:58:24.309Z (11 months ago)
• Language: Java
• Homepage:
• Size: 436 KB
• Stars: 4
• Watchers: 15
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

          
# DKPro Argumentation

[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.dkpro.argumentation/dkpro-argumentation/badge.svg?style=flat)](http://maven-badges.herokuapp.com/maven-central/org.dkpro.argumentation/dkpro-argumentation)

Java framework for demonstration purposes of working with DKPro/UIMA typesystem for argumentation annotation and argumentation mining.

## Requirements

Java 1.8 and higher

## Installation

DKPro Argumentation is available from Maven Central. For working with the UIMA type system, add the following dependencies to your `pom.xml`

```

    org.dkpro.argumentation

    dkpro-argumentation-types

    0.1.0

```

* Current development version: 0.2.0-SNAPSHOT

## Modules

### org.dkpro.argumentation.types

The UIMA type system is the central part of DKPro Argumentation. It allows one to annotate argument components and relations on top of the UIMA/DKPro framework.

The class hierarchy contains two central classes, ``ArgumentComponent`` and ``ArgumentRelation``.

![DKPro-argumentation type system hierarchy](dkpro-argumentation-typesystem-draw.io.png)

### IO

Contains ``ArgumentDumpWriter`` class that debugs all argument annotations in a document to the file/stdout.

### Misc

Provides classes to easily operate with argument component annotations.

### Preprocessing

Contains several annotators for casting the problem of argument component identification as BIO tagging (i.e. ``ArgumentTokenBIOAnnotator``)

### Examples

#### Example project for reading annotated data

as shown in

> Habernal, I., Eckle-Kohler, J., & Gurevych, I. (2014). Argumentation Mining on the Web from Information Seeking Perspective. In E. Cabrio, S. Villata, & A. Wyner (Eds.), Proceedings of the Workshop on Frontiers and Connections between Argumentation Theory and Natural Language Processing (pp. 26-39). Bertinoro, Italy: CEUR-WS. Retrieved from http://ceur-ws.org/Vol-1341/

##### Requirements

- Annotated data

  - packaged separately, available at https://www.ukp.tu-darmstadt.de/data/argumentation-mining/argument-annotated-user-generated-web-discourse/

##### How-to

1. Modify paths to gold data

  - Modify `org.dkpro.argumentation.tutorial.ArgumentationCorpusDebugger` and set the `annotatedCorpusDir` variable to point to the gold data located in `gold.data.toulmin` directory

2. Run `ArgumentationCorpusDebugger`

  - It will print annotated argument components, relations, and other info to the std. out

3. Explore it further!

  - Have a look at `org.dkpro.argumentation.io.writer.ArgumentDumpWriter` from the `org.dkpro.argumentation.io.writer` package which shows how to access the argument components, their text, tokens, sentences, etc.

© 2013-2017 UKP

Argumentation Mining Special Interest Group members

https://www.ukp.tu-darmstadt.de/ukp-home/research-areas/argumentation-mining/