From 58ff328e48073aa919e1d74354bfe6deeb8f7072 Mon Sep 17 00:00:00 2001 From: David Runge Date: Sat, 23 Apr 2016 14:01:42 +0200 Subject: README.rst: Moving README to restructuredtext, updating, removing TODO. --- README.rst | 67 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 README.rst (limited to 'README.rst') diff --git a/README.rst b/README.rst new file mode 100644 index 0000000..8ea0809 --- /dev/null +++ b/README.rst @@ -0,0 +1,67 @@ +thesoundofpeople +################ + +||supercollider classes for interacting with data sets from |opensnp| (parsing, retrieving metadata, rendering audio from, etc.). + + **Note:** *This is a prototype! It is developed on Linux using JACK, therefore the following features have only been tested there!* + +Features +________ +- Parse 23andme files, write them to a different - optimized for the work with **The Sound Of People** - format. +- Loading the contents of both types of files (parsed and read) into a SuperCollider Dictionary. This will require **a lot** of RAM. Get ready for ~5,7GB (*parsing*) and ~4,7GB (*reading*). The amount will increase during playback - you will most likely end up using ~6,0GB! +- Retrieve metadata (at the moment only resolvers for SNPs) for SNPs and the data sets +- Rendering sound from positions (or rather: bases/base pairs at a position on a chromosome) of up to 25 chromosomes at the same time. +- Possible audio setups are: **2**, **4**, **6**, **8** and **12** speakers +- A GUI showing the current speaker setup and currently playing SNP on chromosomes + +GUI +___ +The GUI is still pretty minimalistic and currently just - non-interactively - showing which SNP is playing on which chromsome (and thus also on which speaker). + +.. figure:: https://git.sleepmap.de/thesoundofpeople.git/plain/thesoundofpeople-gui.png + :alt: The Sound Of People GUI + + The Sound Of People GUI + +Audio +_____ +| For audio samples (only stereo - and please bear in mind that the main focus has been multi-channel use for this application!) visit |soundcloud| + +Installation +____________ +Clone this repository to somewhere sclang will pick it up on recompiling its class library: + + .. code:: bash + + cd ~/.local/share/SuperCollider/Extensions/local + git clone git://sleepmap.de/thesoundofpeople.git + +If the local folder doesn't exist, create it, otherwise you can also directly clone into the Extensions folder (the folder and all of its children will get picked up on recompile). +Symlinking is fine, too! + + .. code:: bash + + cd ~/some/other/directory + git clone git://sleepmap.de/thesoundofpeople.git + cd ./local/share/SuperCollider/Extensios/local/ + ln -s ~/some/other/directory/thesoundofpeople . + +Usage +_____ +Go to the cloned directory and open **thesoundofpeople.scd** in your favorite SuperCollider IDE. +All further steps are explained there. + + +.. |supercollider| raw:: html + + SuperCollider + +.. |opensnp| raw:: html + + SuperCollider + +.. |soundcloud| raw:: html + + Soundcloud + + -- cgit v1.2.3-54-g00ecf