Caribe 0.2.9

Trinidad dialect to standard english

Caribe

This python library takes trinidadian dialect and converts it to standard english. Future updates would include the conversion of other caribbean dialects to standard english and additional natural language processing methods.

---

Installation

Use the below command to install package/library

pip install Caribe 

---

Usage

Sample 1: Checks the dialect input against existing known phrases before decoding the sentence into a more standardized version of English language. A corrector is used to check and fix small grammatical errors.

# Sample 1
import Caribe as cb
from Caribe import trinidad_decode, trinidad_decode_split, caribe_corrector

sentence = "Ah wah mi modda phone"
standard = cb.phrase_decode(sentence)
standard = cb.trinidad_decode(standard)
fixed = cb.caribe_corrector(standard)
print(fixed) #Output: I want my mother phone

Sample 2: Checks the dialect input against existing known phrases

# Sample 2 
import Caribe as cb
from Caribe import trinidad_decode, trinidad_decode_split, caribe_corrector

sentence = "Waz de scene"
standard = cb.phrase_decode(sentence)

print(standard) # Outputs: How are you

Sample 3: Checks the sentence for any grammatical errors or incomplete words and corrects it.

#Sample 3
import Caribe as cb
from Caribe import trinidad_decode, trinidad_decode_split, caribe_corrector

sentence = "I am playin fotball outsde"
standard = cb.caribe_corrector(sentence)

print(standard) # Outputs: I am playing football outside

Sample 4: Makes parts of speech tagging on dialect words.

#Sample 4
import Caribe as cb
from Caribe import trinidad_decode, trinidad_decode_split, caribe_corrector

sentence = "wat iz de time there"
analyse = cb.nlp()
output = analyse.caribe_pos(sentence)

print(output) # Outputs: ["('wat', 'PRON')", "('iz', 'VERB')", "('de', 'DET')", "('time', 'NOUN')", "('there', 'ADV')"]

Sample 5: Remove punctuation marks.

#Sample 5
import Caribe as cb
from Caribe import trinidad_decode, trinidad_decode_split, caribe_corrector

sentence = "My aunt, Shelly is a lawyer!"
analyse = cb.remove_signs(sentence)


print(analyse) # Outputs: My aunt Shelly is a lawyer

Sample 6: Sentence Correction using T5-KES.

#Sample 6 Using t5_kes_corrector
import Caribe as cb


sentence = "Wat you doin for d the christmas"
correction = cb.t5_kes_corrector(sentence)


print(correction) # Output: What are you doing for christmas?

Sample 7: Sentence Correction using Decoder and T5-KES.

#Sample 7 Using t5_kes_corrector and decoder
import Caribe as cb


sentence = "Ah want ah phone for d christmas"
decoded= cb.trinidad_decode(sentence)
correction = cb.t5_kes_corrector(decoded)


print(correction) # Output: I want a phone for christmas.

---

• Additional Information

  • trinidad_decode() : Decodes the sentence as a whole string.
  • trinidad_decode_split(): Decodes the sentence word by word.
  • phrase_decode(): Decodes the sentence against known dialect phrases.
  • caribe_corrector(): Corrects grammatical errors in a sentence using gingerit.
  • t5_kes_corrector(): Corrects grammatical errors in a sentence using a trained NLP model.
  • trinidad_encode(): Encodes a sentence to trinidadian dialect.
  • caribe_pos(): Generates parts of speech tagging on dialect.
  • pos_report(): Generates parts of speech tagging on english words.
  • remove_signs(): Takes any sentence and remove inefficient punctuation marks.

---

• File Encodings on NLP datasets

Caribe introduces file encoding (Beta) in version 0.1.0. This allows a dataset or any supported filetype to be creolised in trinidad dialect.

• Usage of File Encodings:

import Caribe as cb

convert = cb.file_encode("test.txt", "text")
# Generates a translated text file
convert = cb.file_encode("test.json", "json")
# Generates a translated json file
convert = cb.file_encode("test.csv", "csv")
# Generates a translated csv file

---

Dictionary Data

The encoder and decoder utilises a dictionary data structure. The data for the dictionary was gathered from web-scapping social media sites among other websites and using Lise Winer Dictionary of the English Creole of Trinidad and Tobago among other scholarly resources.

---

Transformer Models

State of the art NLP grammar correction T5-KES model was trained on a modified version of the JFLEG dataset and is currently being tested against existing models and benchmarks. The T5-KES model may be used as both of a grammar corrector and a parser for Trinidad dialect via training using custom datasets in a future update.

---

T5_KES_Corrector vs Caribe Corrector(Ginger Grammar Corrector)

Initial Tests were carried out with performance factors to measure the accuracy of the correction and the degree of sentence distortion from the correct sentence. Initial tests showed that the T5 corrector performed better in terms of accuracy with a lower sentence distortion.

---

• Contact

For any concerns, issues with this library or want to become a collaborator to this project.

Email: [e-mail]

---

CHANGELOG =======================================

Version 0.0.1 (16/09/2021)

• Initial Release

Version 0.0.2 (16/09/2021)

• Minor bugs fixed
• More words added

Version 0.0.3 (16/09/2021)

• Minor bugs fixed
• More words added
• phase decode method created

Version 0.0.4 (17/09/2021)

• More words added
• caribe corrector method created

Version 0.0.5 (17/09/2021)

• Minor Dependency issues resolved

Version 0.0.6 (17/09/2021)

• More Words and phrases added

Version 0.0.7 (21/09/2021)

• Major bug fixed where individual letters in words were translated randomly
• More words added to the corpus.

Version 0.0.8 (30/09/2021)

• caribe_pos tagging method introduced.
• pos_report method introduced.
• remove_signs method introduced.

Version 0.1.0 (14/10/2021)

• trinidad_encode method converts standard english sentence to a creolised form.
• Caribe introduces dialect file encoding on text, json and csv files. This has the ability to creolised nlp datasets.

Version 0.1.1 (20/10/2021)

• More words added to the corpus.

Version 0.1.2 (27/10/2021)

• caribe_pos members converted from string to tuple.
• More words added to the corpus.

Version 0.1.5 (13/11/2021)

• More words added to the corpus.

Version 0.1.8 (10/12/2021)

• Introducing a new trained NLP grammar correction model "T5-KES".
• Major Update in version 0.2.0 coming January.

Version 0.2.0 (06/02/2022)

• New Sentence Corrector introduced: t5_kes_corrector()

Version 0.2.1 (07/02/2022)

• More Words added to the corpus

Version 0.2.2 (13/02/2022)

• Removal of a dependency that causes slower functionality

Version 0.2.4 (27/02/2022)

• Introduced a new api function to the corrector: t5_kes_api_corrector(sentence) for faster performance

Version 0.2.9 (28/02/2022)

• More Words added -Fixed an issue where certain words were not being encoded on NLP datasets.