lilyinput {tuneR}R Documentation

Providing LilyPond compatible input

Description

A function (in development!) that writes a file to be processed by LilyPond by extracting the relevant information (e.g. pitch, length, ...) from columns of a data frame. The music notation software LilyPond can “transcribe” such an input file into sheet music.

Usage

lilyinput(X, file = "Rsong.ly", Dur = TRUE, grundton = "c", 
    schlusselart = 1, takt = "4/4", endbar = TRUE, midi = TRUE, 
    tempo = "2 = 60", textheight = 220, linewidth = 150, indent = 0)

Arguments

X A data frame containing 4 named components (columns):
  • noten: Integer - the notes' pitch in halftones from diapason (a), i.e. 0 for diapason a, 3 for c', ...
  • laenge: Integer - denominator of lengths of the notes, e.g. 8 for a quaver.
  • punkt: Logical - whether to punctate a note.
  • bindung: Logical - TRUE indicates to start a slur, or to end it. That means that the first, third, ... occurences of TRUE start slurps, while the second, fourth, ... occurences end slurps. Note that it is only possible to draw one slur at a time.
file The file to be written for LilyPond's input.
Dur Logical indicating major key (if TRUE) or minor key.
grundton Keynote, necessary to set sharps/flats.
schlusselart Integer indicating the kind of clef. The following four kinds are supported: 1 for g-/treble-clef, 2 for f-/bass-clef, 3 for c-/alto-clef, and 4 for c-/tenor-clef.
takt Character indicating which meter to use, examples are: "3/4", "4/4".
endbar Logical indicating whether to set an ending bar at the end of the sheet music.
midi Logical indicating whether Midi output (by LilyPond) is desirable.
tempo Character specifying the tempo to be used for the Midi file if midi = TRUE. The default, "2 = 60" indicates: 60 half notes per minute, whereas "4 = 90" indicates 90 quarters per minute.
textheight Textheight of the sheet music te be written by LilyPond.
linewidth Linewidth of the sheet music te be written by LilyPond.
indent Indentation of the sheet music te be written by LilyPond.

Details

Details will be given when development has reached a stable stage ...

Value

Nothing is returned, but a file is written.

Note

This function is in development! Everything, in particular its user interface (and german names of arguments) is subject to change!

Author(s)

Andrea Preusser and Uwe Ligges, ligges@statistik.uni-dortmund.de

References

Nienhuys, H.-W., Nieuwenhuizen, J. et al. (2004): GNU LilyPond - The Music Typesetter. Free Software Foundation, http://www.lilypond.org/, Version 2.0.3.

Preusser, A., Ligges, U. und Weihs, C. (2002): Ein R Exportfilter für das Notations- und Midi-Programm LilyPond. Arbeitsbericht 35. Fachbereich Statistik, Universität Dortmund. (german)

See Also

Functions to be referenced are not yet documented ...

Examples

# Not yet available ...

[Package Contents]