![]() |
![]() |
![]() |
hum2fin inputfile [outputfile] [-p]
As of April 2000, hum2fin supports the following Humdrum data:
1. **kern representation hum2fin supports most **kern signifiers, including:
0, 1, 2, 4, ... 128, '.', note duration -, # accdientals a-g, A-g, r pitches ' z ^ ; ~ , ` : W M S u v q articulations and ornaments J, L beaming [ ] - tie ( ) slur { } phrase /, \\ stemming * Supported kern signifiers
2. **dynam representation hum2fin supports the following **dynam signifiers: < > ( ) [ ] X x r hum2fin assumes that a **dynam spine is always specific to ONE **kern spine and it is always specific to the closest **kern spine to its right. Also, only ONE **dynam spine can be related to a **kern spine. The **dynam spine closest to the **kern spine gets the connection. For example, in the humdrum file below,
**kern | **dynam | **dynam | **silbe | **kern | **kern |
4r | f | p | I | 4d | 4f# |
4r | . | . | am | 4e | 4g |
the **dynam spine with the piano marking is linked with the second **kern spine (fifth spine from the left). The **dynam spine containing the forte marking is ignored. Meanwhile, the **dynam spine (third spine from the left) is specific to the fifth spine from the left, but not the first spine nor the last one.
3. **silbe representation hum2fin can process the **silbe representation. Similar to the **dynam representation, hum2fin assumes that a **silbe spine is always specific to ONE **kern spine and it is always specific to the closest **kern spine to its right. Also, only ONE **silbe spine can be related to a kern spine. hum2fin assumes that the humdrum file adopts a through-composed humdrum format, so hum2fin does not recognize the *strophe tandem interpretation.
4. Reference record hum2fin reads the reference record !!!OTL and puts the text as the title of the music in the enigma file.
5. Humdrum's barline scheme hum2fin recognizes and translates the following barline signifiers: ==|!, ==:!|, ==:|!, ==, =!, =", =-, =', = and = with measure number.
6. Spine paths hum2fin only recognizes the exchange spine signifier *x.
7. Tandem interpretations hum2fin supports the following tandem interpretations: clefs, key signature, key, time signature, and instrument.
Please note that hum2fin depends heavily on the **kern representation, which provides it with most of the essential musical data Finale needs. Because Finale is unable to display notations such as slurs or dynamics alone without the actual notes themselves, there MUST be **kern spines in the Humdrum input file. All the non-kern spines should also be specific to particular **kern spines respectively. The linkage maybe suggested through the use of the tandem representaion *staff. For example, should hum2fin support the **harm representation in the future, the humdrum file
**kern | **harm | **kern |
*staff1 | *staff1 | * |
4d | . | 4c |
4f | IV | 4a |
indicates that the **harm spine is related to the **kern spine to its left, but not the one to its right.
If no relationship is suggested, hum2fin assumes a relationship between the non- kern spine and its closest kern spine to the right, as can be seen in the treatment of the **silbe and **dynam spines.
Recall that Humdrum representation are organized aas though the notated score has been rotated clockwise 90 degrees. This means that the upper-most part is typically represented by the right-most spine. hum2fin interprets the inputs according to this arrangement.
hum2fin has the option of processing the non-supported spines as **silbe spines. This would enable users to view some spine's data as lyrics in Finale even if hum2fin has yet to support the spine's particular representation. To enable this option, append to the command line"-p".
Please be very aware of the way hum2fin process these non-supported spines when enabling this option. hum2fin will process the non-supported spine the same way as it processes the silbe spines. hum2fin will assume the non-supported spine to be related to some specific kern spine. Please read the "*silbe representation" part in the Description section for more details.
fin2hum (4),
ms (4)
Natural Sign hum2fin recognizes the need of accidentals through the kern signifiers "-", "#", and "n". In the **kern representation, it is possible to have a note requiring an accidental but does not have the above signifiers. For example, in the key of F major, if the note is b natural, in Finale a natural sign is needed, but in **kern, only a "b" is needed to show that it is a b natural. In such a case, hum2fin will fail to recognize the "b" as a b-natural but treat it as a b-flat.
Measure 1 Label hum2fin assumes the first measure in score is measure one and labels it as measure one (even if it is a pickup).
There are also limitations in how hum2fin process the **dynam and **silbe representations. Please refer to the corresponding parts in the Description section in this document.
hum2fin has error messages when there are errors with reading input and output files. hum2fin also requires the files "barline.txt", "artic.txt", "dynam.txt" and "etfBegin.txt" for outputting the enigma file and if there are problems reading these files, error messages would be issued.
If the program unexpectedly aborts, without any warnings or error messages, please check to see if the humdrum input file complies with the format or restrictions specified in the descriptions section of this document.