openpecha 0.4.5

OpenPecha Toolkit allows state of the art for distributed standoff annotations on moving texts

OpenPecha Toolkit

OpenPecha Toolkit allows state of the art for distributed standoff annotations on moving texts, in which Base layer can be edited without affecting annotations.

The motivation for this project it that for perfect base-text, there no big obstacles but the technical problems come in when you have to be able to edit the base-text, which can be correcting or updating the base-text. So the existing solution like using character coordinates won’t work. So we purposed the CCTV (Character Coordinate Translation Vector) to track the annotations from source base-text to edited base-text without worrying about the annotations at all. Then user can export the edited based text with updated annotations in various docuemnt format like .md, .epub, .pdf, etc. But currently it supports only markdown file.

For NLP this toolkit will provide a way to have annoated corpra with minimal errors and extract a particular type of annotation or collection of different type of annotations. NLP researchers can then use these corpus to build language model, annotations to build NER model, entity linking, ect.

Prerequisite

• Python3, you can download from here

Installation

• MacOS installer
• Windows installer

Usage

Frist we need to download all the poti which are in openpecha format.

$ openpecha download --help
Usage: openpecha download [OPTIONS]

  Command to download poti. If id and batch options are not provided then it
  will download all the poti.

Options:
  -n, --number TEXT  Work number of poti, for single poti download
  -b, --batch TEXT   path to text file containg list of names of
                     poti in separate line. Poti batch download
  -f, --filter TEXT  filter poti by layer availability, specify
                     layer names in comma separated, eg: title,yigchung,..
  -o, --out TEXT     directory to store all the poti
  --help             Show this message and exit.

Automatic updating annotations from source base-text (original) and destination base-text (edited)

$ openpecha update --help
Usage: openpecha update [OPTIONS] WORK_NUMBER

  Command to update the base text with your edits.

Options:
  --help  Show this message and exit.

Exporting and Extracting layer

$ openpecha layer --help 
Usage: openpecha layer [OPTIONS] WORK_NUMBER OUT

  Command to apply a single layer, multiple layers or all available layers
  (by default) and then export to markdown.

  Args:

      - ID is the work-id of the poti, from which given layer will be
      applied

      - OUT is the filename to the write the result. Currently support only
      Markdown file.

Options:
  -n, --name [title|tsawa|yigchung|quotes|sapche]
                                  name of a layer to be applied
  -l, --list TEXT                 list of name of layers to applied,
                                  name of layers should be comma separated
  --help                          Show this message and exit.

Developer Installation.

$ git clone https://github.com/OpenPoti/openpecha-toolkit.git
$ cd openpecha-toolkit
$ pip install -r requirements.txt
$ pip install -e .

Testing

$ pytest tests