Skip to main content

First-ever Python library implementing 'Chandassu', metrical poetry in Telugu Language

Project description

plot

Python library implementing "Chandassu", metrical poetry in Telugu Language (తెలుగు చంధస్సు).
arXiv Preprint: Read Here

Benchmarks

Performance evaluation across prosodic classes plot

Performance evaluation across padyam types plot

Our algorithm achieves 91.73% accuracy on the proposed Chandassu Score.

Usage

Install package using

pip install chandassu

Check padyam

from chandassu.laghuvu_guruvu import LaghuvuGuruvu
from chandassu.padya_bhedam import check_padyam

data= """తొండము నేక దంతమును తోరపు బొజ్జయు వామ హస్తమున్
మెండుగ మ్రోయు గజ్జెలును మెల్లని చూపులు మందహాసమున్
కొండొక గుజ్జు రూపమున కోరిన విద్యలకెల్ల నొజ్జవై
యుండెడి పార్వతీ తనయ యోయి గణాధిప నీకు మ్రొక్కెదన్"""

# Generate LaghuvuGuruvu Sequence
lg_data= LaghuvuGuruvu(data= data).generate()

score= check_padyam( 
                        lg_data= lg_data ,
                        type= "vutpalamaala",
                        return_micro_score= True, 
                        verbose= False
                    )

print(scores)

Computational Architecture

plot

  • nidhi.py: Telugu alphabet classification with phonological categorizations
  • panimuttu.py: Vowel-consonant operations utility functions
  • laghuvu_guruvu.py: Prosodic analysis engine with tokenizer and syllabic weight classifier
  • ganam.py: Pattern repository mapping LaghuvuGuruvu sequences to metrical units
  • padyam_config.py: Configuration database for padyam type constraints and rules
  • check_lakshanam.py: Validation module for yati (caesura) and prasa (alliteration)
  • padya_bhedam.py: Main integration module for metrical assessment and evaluation

Notebooks:

  1. web_scrapping.ipynb: Scraper scripts to collect data from andhrabharati.com
  2. Data_Analysis.ipynb: Analyzes data using different visualizations
  3. Chandassu_Generation.ipynb: Generates chandassu for the scraped data
  4. Score_Generation.ipynb: Computes scores by after chandassu generation
  5. Accuracy_Evaluation.ipynb: Benchmarking and accuracy (Chandassu Score) evaluation

Eager to Contribute?

Any data, features, refactoring or your innovative thought, please check here.

Acknowledgements

Special thanks to Sesha Sai Vadapalli and Kalepu Nagabhushana Rao, maintainers of andhrabharati.com.
Appana Mohan Naga Phani Kumar for proofreading our article.
Sincere gratitude to our parents and family members for their continuous support throughout this work.
This work was undertaken with the grace of Sri Ramalinga Chowdeswari Devi.

Citation

@misc{pavan2025computationalsociallinguisticstelugu,
title={Computational Social Linguistics for Telugu Cultural Preservation: Novel Algorithms for Chandassu Metrical Pattern Recognition},
author={Boddu Sri Pavan and Boddu Swathi Sree},
year={2025},
eprint={2510.01233},
archivePrefix={arXiv},
primaryClass={cs.CL},
url={https://arxiv.org/abs/2510.01233},
}

Thank You !

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

chandassu-1.0.1.tar.gz (33.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chandassu-1.0.1-py3-none-any.whl (36.8 kB view details)

Uploaded Python 3

File details

Details for the file chandassu-1.0.1.tar.gz.

File metadata

  • Download URL: chandassu-1.0.1.tar.gz
  • Upload date:
  • Size: 33.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.11.3 Windows/10

File hashes

Hashes for chandassu-1.0.1.tar.gz
Algorithm Hash digest
SHA256 cfdae2b3d7703c52a16125ab4b282d7e95f73889b14a631df57e3b47bdee82dc
MD5 94ccaef9b171c6ff4501f7f0717a47f2
BLAKE2b-256 63f8622103a037661d7cbf60b80ce3bd54239951236b4e5a116402ba1011c351

See more details on using hashes here.

File details

Details for the file chandassu-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: chandassu-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 36.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.1.2 CPython/3.11.3 Windows/10

File hashes

Hashes for chandassu-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 e2f92a34e24fa2a1139e057cad59dda22bd5f9b312e107966822a6dffbe9dd35
MD5 14644267975867cebb7841d8228e84e3
BLAKE2b-256 5f005a1075554b412f87c551b72af367fbd2bf1e40264f10ad515a31ecd644ed

See more details on using hashes here.

Supported by

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