{"id":22299266,"url":"https://github.com/liamtoney/sonify","last_synced_at":"2025-07-29T02:30:56.998Z","repository":{"id":43685592,"uuid":"241002001","full_name":"liamtoney/sonify","owner":"liamtoney","description":"Sonification of seismic and infrasound signals","archived":false,"fork":false,"pushed_at":"2024-11-19T19:42:05.000Z","size":33240,"stargazers_count":32,"open_issues_count":3,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-19T20:32:08.451Z","etag":null,"topics":["infrasound","seismology","sonification"],"latest_commit_sha":null,"homepage":"https://sonify.rtfd.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liamtoney.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-17T02:16:38.000Z","updated_at":"2024-11-19T19:42:03.000Z","dependencies_parsed_at":"2024-11-19T20:25:23.946Z","dependency_job_id":"f418cd27-180c-49e5-9e7e-da57134b5b73","html_url":"https://github.com/liamtoney/sonify","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamtoney%2Fsonify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamtoney%2Fsonify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamtoney%2Fsonify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liamtoney%2Fsonify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liamtoney","download_url":"https://codeload.github.com/liamtoney/sonify/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227972012,"owners_count":17849421,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["infrasound","seismology","sonification"],"created_at":"2024-12-03T18:05:04.091Z","updated_at":"2025-07-29T02:30:56.982Z","avatar_url":"https://github.com/liamtoney.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"*sonify*\n========\n\n|docs_badge| |build_badge| |cov_badge| |black_badge| |isort_badge|\n\n*sonify* “squeezes” seismic or infrasound signals into audible frequencies and\ncreates animated spectrograms to accompany the audio. Data are pulled from any\nof the `FDSN data centers\n\u003chttps://service.iris.edu/irisws/fedcatalog/1/datacenters?format=html\u003e`__\navailable through the Incorporated Research Institutions for Seismology (IRIS)\nData Management Center (DMC) `fedcatalog\n\u003chttps://service.iris.edu/irisws/fedcatalog/docs/1/help/\u003e`__ web service.\n\n|screenshot|\n\n*sonify* `won an Honorable Mention\n\u003chttps://jhepc.github.io/2020/entry_11/index.html\u003e`__ in the 2020 SciPy `John\nHunter Excellence in Plotting Contest (JHEPC) \u003chttps://jhepc.github.io/\u003e`__.\n\nQuickstart\n----------\n\n1. Obtain\n\n   .. code-block:: xml\n\n     git clone https://github.com/liamtoney/sonify.git\n     cd sonify\n\n2. Create environment, install, and activate (`install conda\n   \u003chttps://conda.io/projects/conda/en/latest/user-guide/install/index.html\u003e`__\n   first, if necessary)\n\n   .. code-block:: xml\n\n     conda env create\n     conda activate sonify\n\n3. Run using the Python interpreter\n\n   .. code-block:: python\n\n     python\n     \u003e\u003e\u003e from sonify import sonify\n\n   or via the command-line interface\n\n   .. code-block:: xml\n\n     sonify --help\n\nExample\n-------\n\nTo make a movie of the seismic signal generated by a massive avalanche\noccurring in Alaska on 21 June 2019, sped up by a factor of 200:\n\n.. code-block:: python\n\n   from sonify import sonify\n   from obspy import UTCDateTime\n\n   sonify(\n       network='AV',\n       station='ILSW',\n       channel='BHZ',\n       starttime=UTCDateTime(2019, 6, 20, 23, 10),\n       endtime=UTCDateTime(2019, 6, 21, 0, 30),\n       freqmin=1,\n       freqmax=23,\n       speed_up_factor=200,\n       fps=1,  # Use fps=60 to ~recreate the JHEPC entry (slow to save!)\n       spec_win_dur=8,\n       db_lim=(-180, -130),\n   )\n\nOr (equivalently), via the command-line interface:\n\n.. ~BEGIN~\n.. code-block:: xml\n\n  sonify AV ILSW BHZ 2019-06-20T23:10 2019-06-21T00:30 --freqmin 1 --freqmax 23 --speed_up_factor 200 --fps 1 --spec_win_dur 8 --db_lim -180 -130\n.. ~END~\n\nThe result is a 4K 1fps video file named ``AV_ILSW_BHZ_200x.mp4``. A screenshot\nof the movie is shown at the top of this README.\n\nDocumentation\n-------------\n\nApplication programming interface (API) documentation for the module is available\n`here \u003chttps://sonify.readthedocs.io/en/latest/sonify.html\u003e`__. For command-line\nusage instructions, type ``sonify --help`` (the ``sonify`` conda environment must\nbe active).\n\n.. |docs_badge| image:: https://readthedocs.org/projects/sonify/badge/?version=latest\n   :alt: Documentation status\n   :target: https://sonify.rtfd.io/\n\n.. |build_badge| image:: https://github.com/liamtoney/sonify/actions/workflows/build.yml/badge.svg?\n   :alt: Build status\n   :target: https://github.com/liamtoney/sonify/actions/workflows/build.yml\n\n.. |cov_badge| image:: https://codecov.io/gh/liamtoney/sonify/branch/main/graph/badge.svg?token=3OIGM34OFL\n   :alt: Test coverage\n   :target: https://codecov.io/gh/liamtoney/sonify\n\n.. |black_badge| image:: https://img.shields.io/badge/code%20style-black-000000\n   :alt: Link to Black\n   :target: https://black.readthedocs.io/en/stable/\n\n.. |isort_badge| image:: https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat\u0026labelColor=ef8336\n   :alt: Link to isort\n   :target: https://pycqa.github.io/isort/\n\n.. |screenshot| image:: screenshot.png\n   :alt: Screenshot of example\n   :target: #example\n\nContributing\n------------\n\nTo install *sonify*'s development packages, with your conda environment activated run\n\n.. code-block:: xml\n\n   pip install --requirement requirements.txt\n\nIf you notice a bug with *sonify* (or if you'd like to request/propose a new\nfeature), please `create an issue on GitHub\n\u003chttps://github.com/liamtoney/sonify/issues/new\u003e`__ (preferred) or email me at\n|liam@liam.earth|_. You are also welcome to create a `pull request\n\u003chttps://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests\u003e`__.\nPlease don't allow `imposter syndrome\n\u003chttps://en.wikipedia.org/wiki/Impostor_syndrome\u003e`__ to obstruct you from\ncontributing your valuable ideas and skills to this project — **I'm happy to help\nyou contribute in any way I can.**\n\n.. |liam@liam.earth| replace:: ``liam@liam.earth``\n.. _liam@liam.earth: mailto:liam@liam.earth\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliamtoney%2Fsonify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliamtoney%2Fsonify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliamtoney%2Fsonify/lists"}