Scroll to navigation

Aghermann(1) Aghermann Aghermann(1)

NAME

Aghermann -- a sleep research experiment manager and Achermann et al (1993) model simulator

SYNOPSIS

aghermann [-l LOG_FILE] [-n] [EXP_ROOT_DIR]

DESCRIPTION

Aghermann is a GTK+ program designed to run Process S simulations on Slow-Wave Activity profiles from EEG recordings as outlined in Achermann et al (1993). In this capacity, Aghermann produces a set of sleep homeostat parameters which can be used to describe and differentiate individual sleepers, such as short vs long sleepers, early vs late, etc.

Also provided are general-purpose facilities for displaying EEG and accompanying recordings, such as EOG and EMG, saved in EDF (European Data Format) files (plain EDF as well as EDF+C are supported). These recordings can then be conveniently scored; scores can be imported/exported in plain ASCII. Scoring can be outsourced to external scripts written in lua.

COMMAND-LINE OPTIONS

If run without arguments, your last session will be restored; an experiment located in EXP_ROOT_DIR will be selected otherwise.

With option -n (and an EXP_ROOT_DIR, which is non-optional in this case), the experiment session in that directory will be initialised and immediately closed, upon which Aghermann will exit. No windows will be open and no GTK+ code run; this option was implemented with the idea of running the core structural part of Aghermann under valgrind.

With option -l LOG_FILE, aghermann will write a log of its inner workings to LOG_FILE; if the latter is "-", stdout is used. By default, (almost all) logging is suppressed.

NOTE ON EDF FILE METADATA

For Aghermann to be able to manage an EDF file, all relevant fields in its header must be filled out correctly, as follows:

  • patient_id uniquely identifies the subject;
  • recording_id identifies the recording session (out of several other such sessions, each containing the same series of episodes) and the individual episode. These two items must appear in one of the following combinations:
  • "Session/Episode"
  • "Session : Episode"
  • "Episode (Session)"
recording_date and recording_time must not overlap with other episodes in the same session and not be too far removed from each other (more than 7 days).

FILES

~/.config/aghermann/sessionrc, contains a list of paths to recent experiment trees.
./.agherman.conf and ./.expdesign.conf, saved settings of the experiment located in
this tree.

SEE ALSO

edfhed-gtk(1), edfhed(1), edfcat(1).

The project’s git repository is kept on sf.net and also on github.com; more details on the Achermann model as well as on usage and project background can be found at http://johnhommer.com/academic/code/aghermann.

AUTHOR

Aghermann is written by Andrei Zavada <johnhommer@gmail.com>. Parts of the code have been borrowed from http://exstrom.com (in src/libexstrom); some bare algorithms in libsigfile/mc.* are those found in C# files zipped and posted at code.google.com/p/neuroloopgain.

2022-09-18 1.1.2