Skip to main content

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)

Source distribution for Sonic-Screwdriver 1.3.6
File Size Uploaded
sonic_screwdriver-1.3.6.tar.gz 24.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for Sonic-Screwdriver 1.3.6
File Interpreter ABI Platform
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

Release history Release notifications | RSS feed

This release

1.3.6 This release

2 release files

1.3.5

2 release files

1.3.4

2 release files

1.3.3

2 release files

1.3.2

2 release files

1.3.1

2 release files

1.3.0

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.13

2 release files

1.1.12

2 release files

1.1.10

2 release files

1.0.17

2 release files

1.0.16

2 release files

1.0.15

2 release files

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page