Package: hmsm
HMSM-ToolsThis python package contains tool for the digitization and analysis ofHistoricalMusicalStorageMedia.
This python package is the software implementation for the digitization part of theBMBFfunded research projectDISKOSat theResearch Center Digital Organologyat Leipzig University.InstallationTo install from PyPI use:pip install hmsmTo install the development version directly from Github you can use pip like so:pip install git+https://github.com/digital-organology/hmsm.gitFor additional installation information seeINSTALL.md.UsagePiano Roll DigitizationWe support digitization for a number of formats of piano rolls out of the box, for an overview seeFORMATS.md.
If you miss support for a format of interest for you, we provide tooling to help you create configuration information for that format.
For additional information on this, seeCONFIG.md.The program generally expects roll scans to be taken against a black or white background.
If not specified using the--backgroundparameter the color will be extrapolated from the provided image.
The roll scan is also expected to be somewhat straight, with a slight curvature beeing compensated for automatically.To process a roll, use the providedroll2midiutility, like so:roll2midi -c animatic -t 60 hupfeld_animatic_roll.tif out.midThis will:-c animaticuse theanimaticprofile bundled with the application. You may also pass the path to a json file containing a custom configuration or even a raw json string here.-t 60set the roll speed to 60. The unit is feet-per-minute times 10, which is the unit annotated on (most) rolls. This means the roll will effectively be processed as if it were played back at 6 feet per minute.hupfeld_animatic_roll.tifread the roll scan from this fileout.midwrite the generated midi file hereFor more inforamtion on the command line interface for roll digitization pass the-hor--helpparameter:roll2midi --helpCardboard Disc DigitizationWe currently support Image-to-Midi transformation for Ariston brand cardboard discs with 24 tracks. We expect our process to work for all types of discs that encode information in the same general way.We use images that are overexposed and have the start position of the disc aligned to 0 degrees likethis one.
You may need to preproces your image using you favorite image processing software.
Be sure to pass the rotation of the start position of the disc using the--offsetparameter.To digitize the example image included in this repository call the included command line utility, like so:disc2midi -c ariston -m cluster assets/5070081_22.JPG out.midMidi to Disc TransformationIncluded in this package is functionality to create images of cardboard discs from midi files.
We currently include a profile for the Ariston 24 type of disc, though it should be relatively trivial to add support other types of discs.
You can test this with any midi file of your choosing, any notes that are not contained in the given format will be dropped automatically.midi2disc -t ariston_24 -s 4000 -n "Title can have<br>multiple lines" input.mid output.pngThough this is not a core feature of our application we used midis generated from original discs to verify that the results are close to the original media.Disc to Roll Image TransformerWe also include a utility to transform circular media into a rectangular representation (similar to piano rolls).
This can be useful if you prefer to use an existing digitization solution for piano rolls for the image to midi transformation process.
It should generally work with all circular media types as long as there is sufficient contrast between background and medium for the algorithm to detect the edge of the medium correctly.
To transform the included color photography of the same disc as used above run:disc2roll --offset 92 assets/5070081_11.JPG roll.JPGLicenseWe provide this software under the GNU-GPL (Version 3-or-later, at your discretion).The photographs included in this repository (located unterassets/) are taken from our research platformMusiXploraand are generally provided under a CC BY-SA 4.0 License unless otherwise specified.