Skip to content

Latest commit

 

History

History
63 lines (36 loc) · 3.83 KB

README.md

File metadata and controls

63 lines (36 loc) · 3.83 KB
Raw

A metrical scansion system for fixed-metre Spanish poetry (analysis)

Version 3.1.1 - July 2017 Borja Navarro Colorado University of Alicante

Here is the code of the paper "A metrical scansion system for fixed-metre Spanish poetry" Digital Scholarship in the Humanities, 2017, doi: https://doi.org/10.1093/llc/fqx009.

Introduction - What's this?

An authomatic scansion system of Spanish poetry. The system takes a verse as input and returns its meter. Stressed syllables are represented with the symbol "+" and unstressed syllables with the symbol "-". For example:

​ En tanto que de rosa y azucena: -----+---+-

The system combines hand-made rules and frequency information. It has been trained with the Corpus of Spanish Golden-Age Sonnets (with metrical annotation). The code to train the system with your own corpus will be available soon.

For the moment it runs only for Spanish sonnets —it is ready to analyse hendecasyllables (eleven syllables). A new version for polyrhithmic poetry is nowadays under development. Stay tuned!

Instalation

The system is a set of python scripts. To run the system you must install Python 3.x (https://www.python.org/)

The system depends also on Freeling to analyze the Part of Speech of each word. It must be installed and running in you computer. How to install Freeling: please see http://nlp.lsi.upc.edu/freeling/node/8

To run the system, unzip it into a directory and run analizaMetrica.py

python3.x analizaMetrica.py

where x is the version of your python.

It has been tested in Linux and MacOS. Please, contact me if you find any problem.

Running the system

To analyze your own poems, follow these steps:

  1. Put all your sonnets (see input format below) in the "data_in" folder and create a "data_out" folder in the same directory.
  2. (Alternatively, you can create "data_in" and "data_out" folders in any place in your computer and edit the route to these folders in "dir_in" and "dir_out" in analizaMetrica.py).
  3. Run python3.x analizaMetrica.py
  4. At the end, all poems analyzed will be stored in the "data_out" folder.
  5. During the process, the system will be printing on the screen the steps that are being carried out. If you want to store this information in a file, run python3.x analizaMetrica.py > log.txt

Input and output format

As input, all poems must be plain text. A poem per a .txt file.

Output format is a XML-TEI file (.xml extension) with a standard TEI-Header and a tag @metto represent the metre. TEI-Header can be edited in "utilidades/txt2xml.py". For detaills about the output format, please see:

Borja Navarro Colorado, María Ribes Lafoz and Noelia Sánchez (2016) "Metrical annotation of a large corpus of Spanish sonnets: representation, scansion and evaluation", Proceedings of the 10th edition of the Language Resources and Evaluation Conference, 23-28 May 2016, Portorož (Slovenia) [PDF].

How to cite the system

If you use this tool for academic research purposes, please cite it with the following reference:

Navarro-Colorado, Borja (2017) "A metrical scansion system for fixed-metre Spanish poetry" Digital Scholarship in the Humanities, doi: https://doi.org/10.1093/llc/fqx009

https://academic.oup.com/dsh/article-abstract/doi/10.1093/llc/fqx009/3064339/A-metrical-scansion-system-for-fixed-metre-Spanish

Funding

ADSO project is supported by the BBVA Foundation: grants for research groups 2016, project ‘Distant Reading Approach to Golden-Age Spanish Sonnets’ [Ayudas fundación BBVA a equipos de investigación científica, proyecto "Análisis distante de base computacional del soneto castellano del Siglo de Oro"].