erie-web
v0.3.7
Published
A declarative grammar for data sonification for web
Downloads
213
Readme
Erie: a declarative grammar for data sonification (for web)
Introduction
Erie is a declarative grammar for data sonification, and this JavaScript library is built for web environments using Web Audio API and Web Speech API.
How to Use
Prerequisits
Libraries
On browser (Vanilla JS)
<script src="https://cdn.jsdelivr.net/npm/arquero@latest"></script>
<script src="https://cdn.jsdelivr.net/npm/d3@7"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.4/moment.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/vega@5/build-es5/vega.min.js"></script>
<!-- For development -->
<script src="{path}/erie-web.js"></script>
<!-- For production -->
<!-- <script src="{path}/erie-web.min.js"></script> -->
(Working on CDN)
On Node
import * as Erie from "erie-web";
// ex) Erie.compileAuidoGraph
To use audio sample files for musical instruments
On Browser
Erie.setSampleBaseUrl(...);
Documentation
Making a contribution
Erie is an open-source project, and waiting for your feedback!
Build
npm i
npm run build
And
- Open for pull/merge requests!
- Leave an issue for suggestions or bugs!
- Get on the board (let's work together)!
License
MIT
Cite
Software
@misc{erie
title = {Erie},
author = {Kim, Hyeok},
year = {2023},
note = {\url{https://github.com/see-mike-out/erie-web}}
}
Paper (will be updated)
@inproceedings{kim:2024erie
title = {Erie: a Declarative Grammar for Data Sonification},
author = {Kim, Hyeok and Kim, Yea-Seul and Hullman, Jessica},
year = {2024},
booktitle = {To apper in ACM CHI 2024},
note = {\url{https://doi.org/10.1145/3613904.3642442}}
}