Skip to main content

Back translation for Natural Language Processing (NLP) using Google Translate

Project description

BackTranslation

version Downloads license

BackTranslation is a python library that implemented to back translate the words among any two languages. This utilizes googletrans library and Baidu Translation API to translate the words.

Since there is an error in current verison of googletrans, you have to create only one instance to do back-translation for your work. Otherwise, it is easy to cause a bug from multi-requests. We will keep implementing this library with other translator libraries soon.

If you face any bug, you can open a issue in Github.

Installation

You can install it from PyPI:

$ pip install BackTranslation

Usage

Backtranslation with googletrans

Translate the original text to other language and translate back to augment the diversity of data in NLP research.

Parameters:

  • url: option. provide a list of services urls for translation if need. Default url is translate.google.com.
  • proxies: Optional. Proxies configuration. Dictionary mapping protocol or protocol and host to the URL of the proxy. i.e. proxies = {'http': '127.0.0.1:1234', 'http://host.name': '127.0.0.1:4012'}
  • text: required. Original text that need to do back translation.
  • src: option. Source language code of original text. If this parameter is None, the method will detect the language of text automatically. (Default: None)
  • tmp: option. Middle language code. If this parameter is None, the method will pick one of two languages which is different from src.
  • sleeping: option. It is a timer to limite the speed of back-translation to avoid the limitation of Google. (Default: 0)

Return parameter: object Translated.

Attributes:

  • source_text: original sentence.
  • src: the language of original sentence
  • tmp: the target language as middle man
  • trans_text: intermediate result
  • back_text: back-tranlsated result
from BackTranslation import BackTranslation
trans = BackTranslation(url=[
      'translate.google.com',
      'translate.google.co.kr',
    ])
result = trans.translate('hello', src='en', tmp = 'zh-cn')
print(result.result_text)
# 'Hello there'

Note: You just need to create one instance of BackTranslation in order to avoid the issue in current version of googletrans.

Search the language code

You may find out your language code with full language name by using this method.

Parameters:

  • language: required. A language name in english.
from BackTranslation import BackTranslation
trans = BackTranslation()
trans.searchLanguage('Chinese')
# {'chinese (simplified)': 'zh-cn', 'chinese (traditional)': 'zh-tw'}

Backtranslation_Baidu with Baidu Translation API

To use this stable translation, you are required to register in Baidu Translation API for getting your own appID. It supports 2 million chacters per day for free. Note: Currently, they only support Chinese phone number to register the accout.

from BackTranslation import BackTranslation_Baidu
trans = BackTranslation_Baidu(appid='YOUR APPID', secretKey='YOUR SECRETKEY')
result = trans.translate('hello', src='auto', tmp='zh')
print(result.result_text)
# 'hello'
trans.closeHTTP()

Seach language code

Since Baidu provides the different language code, it will be updated soon.

Version Information

Version 0.2.2: fix the services url for Google Translator.

Version 0.2.1: fix the small bug. From this version, the library googletrans version is 4.0.0rc1.

Version 0.2.0: support back-translation with Baidu API, and fix bugs

Version 0.1.0: support back-translation with googletrans library

reference

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

BackTranslation-0.3.0.tar.gz (6.5 kB view details)

Uploaded Source

Built Distribution

BackTranslation-0.3.0-py3-none-any.whl (8.8 kB view details)

Uploaded Python 3

File details

Details for the file BackTranslation-0.3.0.tar.gz.

File metadata

  • Download URL: BackTranslation-0.3.0.tar.gz
  • Upload date:
  • Size: 6.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.20.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.7.0

File hashes

Hashes for BackTranslation-0.3.0.tar.gz
Algorithm Hash digest
SHA256 4acac24f2ce1118b0d818d391ceb8d631326e7e57b04399e11e988b9a40708e2
MD5 febf6601b835b5abdc4086655912f366
BLAKE2b-256 8fa121df559ea05ce2a082971a24250e0847ab5b363ddc7cdbc957ab964cffa2

See more details on using hashes here.

File details

Details for the file BackTranslation-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: BackTranslation-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 8.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.1 requests/2.20.0 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.49.0 CPython/3.7.0

File hashes

Hashes for BackTranslation-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 471e0f5c5acc632f87f3e96763f1a60f3a6783f2936cebab1ce4ea68bac06b69
MD5 a3be49387ba950f9e96ead2607932f17
BLAKE2b-256 8447df1973efb7b3f2ffe2950f7342c1433425e39f515f6bd5a391e011cf6352

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page