Installation with pip
Install Sonic Screwdriver with pip:
pip3 install Sonic-Screwdriver
Install additional dependencies:
pip3 install typing_extensions==4.12.2
Note: Ignore the error regarding dependency conflicts.
Setup
Tkinter
Sonic Screwdriver uses Tkinter as the source of the program interface. Tkinter will need to be installed:
-
Debian systems:
sudo apt-get install python3-tk -
Fedora systems:
sudo dnf install python3-tkinter
Dalek
Sonic Screwdriver is built upon Dalek, an emulator for Tardis an open-source Monte Carlo radiative-transfer spectral synthesis code. Sonic Screwdriver makes use of the Dalek created neural networks to generate type Ia supernova spectra from given inputs.
Download the Dalek neural networks from Dalek data. Lastly unzip the downloaded file.
Configuration file
Create a configuration file:
- Create file called {my_config}.py
- Setup the following variables:
dalek_dir = {dalek_data_dir}where{dalek_data_dir}is the path to the directory containing the Dalek data downloaded in the previous setup step.instruments_dir = {instruments_dir}where{instruments_dir}is the path to the directory where the instrument sound files will be downloaded to and stored.output_dir = {output_dir}where{output_dir}is the directory for which the output files of Sonic Screwdriver will be stored. (Only two files are stored at any given time.)
An example configuration file is provided here
Running Sonic Screwdriver
Sonic Screwdriver is run directly from the command line:
cd directory_containing_{my_config.py}
python3 -m sonicscrewdriver.sonic_screwdriver -i {my_config}
Using Sonic Screwdriver
Using Sonic Screwdriver is simple!
Simply change the supernova option sliders, select an instrument, select a musical scale, and then hit "Simulate". Sonic Screwdriver will then use Dalek to produce a supernova spectrum from the options you chose, which will be displayed on the right. Sonic Screwdriver will also sonify the spectrum using Strauss. To play the spectrum sonifcation hit the "play" button and to stop the audio hit the "stop" button.
Have fun producing and sonifying supernova spectra!
Metadata
Release files for Sonic-Screwdriver 1.3.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| sonic_screwdriver-1.3.6.tar.gz | 24.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| Sonic_Screwdriver-1.3.6-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 49.7 kB
Release files / sonic_screwdriver-1.3.6.tar.gz
| Download URL | sonic_screwdriver-1.3.6.tar.gz |
|---|---|
| Size | 24.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
01069d879d097e39897521b61285b22d12def08a2f37f9ac7f0b7819eda45a2c
|
|
BLAKE2b-256 checksum How to use checksums |
46b9382ad0e517a1e29199f58c394dc9e986d21d70fc6a5d6919600d935630db
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.10.12
|
Release files / Sonic_Screwdriver-1.3.6-py3-none-any.whl
| Download URL | Sonic_Screwdriver-1.3.6-py3-none-any.whl |
|---|---|
| Size | 25.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4b019ded6b337f3c08e097136c19a43640f9f76e919dacd89fd65e75d0fdd736
|
|
BLAKE2b-256 checksum How to use checksums |
6480aa59ef3ce9238409399e6c787d2990b1d1728e16f81015fe3e6837cc2c00
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.10.12
|