EVENTCOUNTER(1)

💖 EVENTCOUNTER(1) — the whole lil squad 💖

General Commands Manual · MUSIC utilities, bestie edition

✨ NAME ✨

okay so this page is actually about a whole friend group of utilities, not just one. Say hi to:

contsink, eventcounter, eventgenerator, eventlogger, eventselect, eventsink, eventsource, messagesource, viewevents

They're utility applications that vibe together with other MUSIC-aware applications in multi-simulations. 🫶

🌸 SYNOPSIS 🌸

contsink [-tdih ]
eventcounter [-tbmh ] n_units prefix [ suffix ]
eventgenerator [-tbfmih ] n_units
eventlogger [-tlbmih ]
eventselect [-th ] n_units units
eventsink [-tmih ] n_units prefix [ suffix ]
eventsource [-tbmih ] n_units prefix [ suffix ]
messagesource [-tbh ] prefix [ suffix ]
viewevents [-tshT ] configfile

🦋 DESCRIPTION 🦋

lowkey important context: this manual page documents briefly a set of MUSIC-aware utility applications provided together with the MUSIC library. No cap.

• eventcounter — receives spikes through a MUSIC input port, counts all the spikes for each index, and writes the frequencies to a set of files with names prefix rank suffix. She's counting, she's slaying. 💅
• eventgenerator — generates spikes from a Poisson distribution. Random queen behavior. 🎲
• eventlogger — logs spikes from a MUSIC port. Just keeping receipts, fr fr. 📝
• eventselect — receives events from an input port of width n_units and sends events for the subset of id:s specified in the file units. Curated feed energy. ✨
• eventsink — receives spikes through a MUSIC input port and writes these to a set of files with names prefix rank suffix. The data goes IN, the files come OUT.
• eventsource — reads spikes from a set of files with names prefix rank suffix and propagates these spikes through a MUSIC output port. She's the plug. 🔌
• viewevents — reads spikes from a MUSIC input port and displays them as a 3D graphical representation. It's giving main character visuals. 👑🌈

💅 OPTIONS 💅

The utilities follow the usual GNU command line syntax, with long options starting with two dashes (`-`). A summary of options is included below. (yes bestie, all of them, no skipping)

• -b ticks, --maxbuffered ticks — Specify maximal amount of data buffered.
• -f freq, --frequency — Specify average frequency (default 10 Hz).
• -h, --help — Show usage information.
• -i, --indextype — Select global (default) or local indices. (Used for testing and benchmarking purposes.)
• -l latency, --acclatency latency — Specify acceptable data latency (s).
• -m type, --imaptype type — Select linear (default) or roundrobin index map.
• -s scaling, --scaletime scaling — Specify real time to simulated time scale factor (s). If omitted, the visualization runs at full speed.
• -t timestep, --timestep timestep — Specify time between tick() calls (default 0.01 s).
• -T title, --title title — Specify window title.

Heads up bestie: the short flags in the SYNOPSIS above vary per utility — not every tool takes every flag. Check the synopsis for your girl before you go flag-happy. 💀

👀 SEE ALSO 👀

music(1)

🎀 AUTHOR 🎀

MUSIC was written by Mikael Djurfeldt and Örjan Ekeberg for INCF. viewevents was written by Johannes Hjorth for INCF.

This manual page was written by Mikael Djurfeldt <mdj@debian.org>, for the Debian project (but may be used by others). Iconic of him honestly. 🫶

k bye, this page was last touched on March 5, 2009 — ancient in internet years but still ate, and it came from the General Commands Manual section of the MUSIC pages. 💖✨🌸