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.

1.1.2                                              2024-04-01                                       Aghermann(1)