CCARH Humdrum Portal

---

Primary Documentation:

• Printable Humdrum User's Guide by David Huron (1998): scanned version (417 pages, 25MB) (HTML detailed table of contents )
  
  PDFs of individual chapters (HTML links are most up-to-date):

  Ch. 1: Humdrum: A Brief Tour (HTML) Ch. 2: Representing Music Using **kern (I) (HTML) Ch. 3: Some Initial Processing (HTML) Ch. 4: Basic Data Translations (HTML) Ch. 5: The Humdurm Syntax (HTML) Ch. 6: Representing Music Using **kern (II) (HTML) Ch. 7: MIDI Output Tools (HTML) Ch. 8: The Shell (I) (HTML) Ch. 9: Searching with Regular Expressions (HTML) Ch. 10: Musical Uses of Regular Expressions (HTML) Ch. 11: Melodic Intervals (HTML) Ch. 12: Selecting Musical Parts and Passages (HTML) Ch. 13: Assembling Scores (HTML) Ch. 14: Stream Editing (HTML) Ch. 15: Harmonic Intervals (HTML) Ch. 16: The Shell (II) (HTML) Ch. 17: Creating Inventories (HTML) Ch. 18: Fingers, Footsteps, and Frets (HTML) Ch. 19: Musical Contexts (HTML) Ch. 20: Strophes, Verses and Repeats (HTML) Ch. 21: Searching for Patterns (HTML) Ch. 22: Classifying (HTML)

  Ch. 23: Rhythm (HTML) Ch. 24: The Shell (III) (HTML) Ch. 25: Similarity (HTML) Ch. 26: Moving Signifiers Between Spines (HTML) Ch. 27: Text and Lyrics (HTML) Ch. 28: Dynamics (HTML) Ch. 29: Differences and Commonalities (HTML) Ch. 30: MIDI Input Tools (HTML) Ch. 31: Repertories and Links (HTML) Ch. 32: The Shell (IV) (HTML) Ch. 33: Word Sounds (HTML) Ch. 34: Serial Processing (HTML) Ch. 35: Layers (HTML) Ch. 36: Sound and Spectra (HTML) Ch. 37: Electronic Editing (HTML) Ch. 38: Systematic Musicology (HTML) Ch. 39: Trouble-Shooting (HTML) Ch. 40: Conclusion (HTML) Appendix I: Reference Records (HTML) Appendix II: Instrumentation Codes (HTML) Table of Contents (HTML, detailed); Index of Problems (HTML); Index of Names, Works and Genres (HTML); General Index (HTML); Bibliography (HTML)

• Printable Humdrum Reference Manual by David Huron (1995): scanned version (565 pages, 43MB, ISBN 0-936943-10-6)
  PDFs of individual sections (HTML links are most up-to-date):

  Section 1: Humdrum General Introduction Section 2: Humdrum Representation Reference (HTML) Section 3: Tandem Interpretation Reference (HTML) Section 4: Humdrum Command Reference (HTML)

  Section 5: Regular Expression Reference Section 6: Humdrum Special Files Section 7: Development Reference (HTML) Front Matter, Bibliography (HTML) , Index (HTML)

• Standard Humdrum Toolkit commands (useful ones to learn first highlighted) see also the Supplementary Humdrum Commands:

  assemble, census, cents, cleave, context, correl, deg, degree, diss, ditto, encode, extract, fields, freq, hint, humdrum, humsed, humver, infot, iv, kern, key, melac, metpos, midi, midreset, mint, nf, num, patt, pattern, pc, pcset, perform, pf, pitch, proof, recode, record, regexp, reihe, rend, rid, scramble, semits, simil, solfa, solfg, strophe, synco, tacet, thru, timebase, tonh, trans, urrhythm, veritas, vox, xdelta, yank, ydelta.

• Humdrum Extra commands (useful ones to learn first highlighted):

  barnum, beat, chorck, extractx, gettime, harm2kern, hgrep, hum2abc, hum2gmn, hum2mid, hum2xml, humcat, kern2cmn, kern2dm, kern2melisma, kern2skini, keycor, lofcog, mid2hum, minrhy, mkeyscape, mvspine, ottava, pae2kern, pitchmix, prange, proll, rcheck, sample, scaletype, scordur, sonority, spinetrace, swing, tindex, thememakerx, themax, thrux, tiefix, time2matlab, time2tempo, transpose, tsroot, xml2hum, zscores.

• Humdrum Pre-Defined Representations:
  **barks, barlines, **bhatk, **cbr, **cents, **choco, *clef, **correl, **date, **dB, **deg, **degree, **diss, **dur, **dyn, **dynam, **embel, **freq, **fret, **harm, **hildegard, **hint, **IPA, **iv, **kern (also), **koto, **melac, **metpos, **MIDI, **mint, **ordo, **pc, **pcset, **pitch, **recip, **semits, **silbe, **simil, **solfa, **solfg, **specC, **spect, **synco, **takt, **text, **time, **Tonh, **URrhythm, **vox#, **Zeit.

Other Documentation:

• **HUG: Humdrum User Group: news, announcements and a place to ask questions about the Humdrum Toolkit for Music Research.
• Humdrum FAQ
• Music 824: Computer Applications in Music Research at Ohio State University
  • Exercises and assignments
• Sample research projects
• Converting **kern data into MIDI (Stanford University: Music 253: Introduction to Musical Information)
• Humdrum Newsletter: No. 1 (1994), No. 2 (1995), No. 3 (1996).
• The Humdrum Toolkit: Unix-based Tools for Music Research, presentation by David Huron.
• Japanese Koto music representation in Humdrum.
• Demonstrations of the hum2abc program for converting Humdrum **kern into musical notation via abcm2ps.
• Temperament and microtonal examples for use with the hum2mid.
• 12 Musical Excerpt Examples of Humdrum **kern Encoding.
• Humdrum : description (français) par Benoit Mathieu, IRCAM.

Primary Software:

• Unofficial Download Site for the Humdrum Toolkit (Version 2.3)
• Pedro Kröger's Humdrum Github repository
• Official Download Site for the Humdrum Toolkit (Version 2.2), Humdrum installation, Manual installation, Humdrum Quick-Start Tutorial.

Other Software:

• Humdrum Extras: Additional Humdrum-file processing programs in C++ created by Craig Sapp
  • command documentation
  • example usages
  • Humdrum programming in C++ tutorial (PowerPoint)
• Museinfo: Symbolic music processing programs in C++ created by Craig Sapp (includes "extras" set plus some less useful ones).
  • full Humdrum program list
  • Program Source Code, Library Source Code, Library Header Files
• Humdrum file syntax highlighting for the VI editor
• Humdrum mode file for emacs being developed by Pedro Kröger

Humdrum-Based Web Applications:

• Online Humdrum Editor with a few Humdrum commands available (designed for FireFox web browser).
• Themefinder: Online musical incipit search database.

Data:

• KernScores: Musical data in the Humdrum **kern representation.
  • Essen Folksong Collection collected by Helmut Schafrath (8,473 songs)
  • 1000 Folksongs (primarily from Luxembourg) encoded by Daimen Sagrillo
  • Frances Densmore Native American songs collections: Ojibway, Pawnee, Sioux.
  • Helen Creighton: Songs and Ballads form Nova Scotia
  • Encodings by David Huron: Bach: Two-part inventions. Well-Tempered Clavier fugues (Book 1) (Book 2)
  • Classical music encoded by Craig Sapp: Bach: 371 chorales. Beethoven: piano sonatas, string quartets. Chopin: mazurkas, preludes. Haydn: piano sonatas. Scarlatti: harpsichord sonatas.
  • Classical music encoded at CCARH: Bach: Well-Tempered Clavier preludes (Book 1) (Book 2), Brandenburg concertos. 185 chorales (from the Cantatas). Haydn: string quartets, 6 London Symphonies. Vivaldi: Solo Violin Concertos, Op. 8. Mozart: string quartets. Corelli: sonatas, opp. 1-6.
  • Other collections: Temperaments, Musical intervals, Tonerows, Jazz chords.
• MuseData: Online database of musical information in the MuseData format, with automatic translations into Humdrum **kern data available.
• Humdrum Databases at Ohio State University: (classical music), (folksongs), Palestrina masses.
• Mozart Musical Dice Game in Humdurm (Stanford University: Music 253: Introduction to Musical Information)

Online Papers Related to Humdrum:

• Chordia, Parag. "A system for the anlaysis and representation of bandishes and gats using Humdrum syntax". In Proc. of the 2007 Frontiers of Research in Speech and Music Conference.
• Knopke, Ian. "PerlHumdrum and PerlLilypond Toolkits for Symbolic Music Information Retrieval", ISMIR 2008: Philadelphia, Pennsylvania. pp. 147-152.
• Sapp, Craig. "Online Database of Scores in the Humdrum File Format". ISMIR 2005: London, England. pp. 664-665.
• Wild, Jonathan. " Review of the Humdrum Toolkit: UNIX Tools for Musical Research, created by David Huron". Music Theory Online, volume 2.7 (1996).

Humdrum-related Courses:

• Music 824: Computer Applications in Music Research, Ohio State University
• Music 253: Musical Information: An Introduction, Stanford University
• I545: Music Representation, Searching and Retrieval, Indiana University
• ISE575: Engineering Approaches to Music Perception and Cognition, University of Southern California
• CS281r: Topics in AI: Representation and Learning of Music, Harvard University

Other Humdrum Portals/Resources:

• Main Humdrum Website: humdrum.org/Humdrum, maintained by David Huron
• University of Virginia Library (Digital Media Center), maintained by Perry Roland
  • Everything you need to know about The Humdrum "**kern" Representation (also on the Humdrum main website)

Unix Learning Resources:

Linux Training by Paul Cobbaut. (particularly chapter 4-6).

List of Unix command-line utilities on Wikipedia.org: cd, grep, mkdir, mv, pwd, rm, sed, tail, uniq, wc.

Other Wikipedia pages related to Unix command-lines: shell scripts, pipelines.