Skip to content

Latest commit

 

History

History
116 lines (68 loc) · 6.5 KB

README.md

File metadata and controls

116 lines (68 loc) · 6.5 KB

azcorpus - The largest NLP corpus for Azerbaijani (1.9M documents, ~ 18M sentences)

In recent years, deep learning models have been widely used in NLP, yielding excellent results. However, most research works in NLP have focused on high-resource languages such as English. There is a significant gap in NLP research for low- resource languages, Azerbaijani being no exception. So, the availability of adequate corpora for most of the languages is still limited, especially for less-resourced languages such as Azerbaijani.

Therefore, this study aimed to contribute to the NLP research community by building the largest NLP corpus for Azerbaijani language.

Corpus Summary

“azcorpus” built for text generation purposes contains a total of 1.9 million documents, drawn from a variety of sources. The corpus is designed to provide a broad range of linguistic data for natural language processing and organized by genre and topic, with texts covering a range of subjects including politics, economics, science, culture, sport, history, society and etc.

Texts were selected from a variety of sources including newspapers, magazines, academic journals, wikipedia articles and books. The corpus includes both contemporary and historical texts, providing a rich linguistic and cultural context for natural language processing applications.


Corpus structure

Data fields

  • id: Document id
  • text - Newline-separated content
  • source - Document source
  • reliability - Subjective cleaning evaluation rate
  • license - Document license

Data Splits

This corpus has 3 sources(az_books, az_wiki, and az_news) and 1.876.492 cleaned documents.

Source name Number of Instances Size (GB)
az_books 1,540,732 19.5
az_wiki 98,882 0.9
az_news 236,878 3.8

Methodology

The first step in building "azcorpus" was to collect text data from various sources. The news websites were selected based on their popularity and the diversity of topics covered. Additionally, a collection of ebooks in Azerbaijani was obtained from various online sources. We have expanded our collection to encompass not only fictional literature, but also scholarly works, such as physics, chemistry, and etc. Source-specific cleaning techniques were applied separately to ensure consistency and accuracy in the corpus. Further information regarding the methodolgy at hand will be expounded upon in our forthcoming academic paper.

To ensure the ethical use of the corpus, we only collected publicly available data, and we did not collect any personal or sensitive information. We also ensured that the corpus was used for research purposes only and not for commercial gain. In accordance with legal considerations, it is not within our current plans to divulge sources at this time.


Corpus Usage

To obtain comprehensive guidance on how to use "azcorpus", please refer to the detailed usage instructions provided in this notebook.

corpus = AzCorpus(access_token = "your_token")

# To retrieve information pertaining to the authors of the corpus, utilize this particular section of code.
corpus.authors

# To obtain a corpus in the raw JSON format
corpus.generate_samples()

The application of specific parameters enables the customization of the corpus format to suit your preferences. AzCorpus currently supports a selection of parameters to support this functionality.

General Parameters

  • corpus_output_format - [default="json"]
    • This signifies the output formatting of the corpus. Can also be "dataframe";
  • corpus_source - [default="all"]
    • This denotes the origin of the texts that comprise the corpus, wherein you can choose az_books, az_wiki, or az_news. By default, it retrieves texts from all available sources.;
  • corpus_reliability_rate - [default="all"]
    • We have provided a subjective evaluation ranging from 0 to 5 by considering the quality of the resources utilized during the cleaning process of the corpus. You can choose 3, 4, or 5. By default, it retrieves all texts, regardless of rating.

Considerations for Using the Corpus

Social Impact

Our work has the potential to contribute to the community by providing a valuable resource for development of new text generation tools in Azerbaijani.

"azcorpus" demonstrates the importance of building large NLP corpora for under-resourced languages, and highlights the social impact of such resources. By making this corpus available to the wider community, we hope to stimulate further research and development in the field of Azerbaijani text generation, and contribute to the broader goal of promoting linguistic diversity and cultural heritage. Future studies could explore the potential community impact of our work.

Biases and Limitations

Addressing potential bias in machine learning corpuses is a common concern in research. In this study, we acknowledge that our dataset may be subject to bias and to mitigate this issue, we employed several techniques. However, we recognize that our approach may still have limitations. So, It is important to exercise caution with models trained on a "azcorpus" that has not been adequately filtered, as this may have an impact on the resulting models. In particular, it is crucial to be mindful of any biases that may be present in the "azcorpus_v0".

Future work could further investigate these issues and explore additional methods to address bias in the corpus.


Additional Information

Corpus authors

The corpus was put together by Huseyn Kishiyev, Jafar Isbarov, Kanan Suleymanli, Khazar Heydarli, Leyla Eminova and Nijat Zeynalov.

The authors' names have been arranged in alphabetical order. All authors have equal rights and contributed equally to this work.

The authors declare no conflict of interest. There are no founding sponsors and no other role in the design of the work other than the authors; in the collection, analysis, or interpretation of data; in the writing of the manuscript, and in the decision to publish the corpus.