Chapter 3: Overview of used data files

The following files are used (WIP meaning: work in progress, i.e., I'll provide details in due time):

/var/lib/psycho: this is the assumed base directory for the following files. Alternative locations are simply realized by changing the base directory's name. The information in this directory is accessible only to the system's psycho user (or whatever username is associated with our system), and partially accessible to the system's web-server.
etc/psychologists: the names, e-mail addresses, identification codes of the involved psychologists;
etc/clients: the details submitted by the psychologists about the clients. To the received details a unique randomly selected client ID is assigned which ID is then used in the client's section of the data/ratings file (see below). The IDs are randomly generated, to prevent time-based association of invitation e-mails and received data.
etc/input.gp: the gnuplot configuration file
data/ratings: received ratings from clients and assessors, sorted by IDs;
data/weights: weights used for computing factor scores;
data/letters/: directory containing variants of letters (WIP) sent to clients and assessors;
data/items/: directory containing items (WIP) presented to clients and assessors;
bin/mailhandler: script handling incoming e-mail from the psychologists;
bin/results: program processing completed data and sending the results to the involved psychologist;
bin/login: program verifying clients/assessors login details;
www/: directory containing the system's web-pages (WIP).

3.1: data matrix organization

Rating data are collected in the file data/ratings. This file holds comma-separated data of N clients by k date elements. The first line contains the column labels, and is also comma-separated. The matrix is sorted by the values in the first column (the ID-field). The labels are:

ID: the randomly assigned client-ID. Association between ID and client is stored in the file etc/clients.
s1..sx: self-ratings on items 1 through x;
m1..mx: meta-ratings on items 1 through x;
a1..ax: client ratings on items 1 through x provided by assessor a;
b1..bx: client ratings on items 1 through x provided by assessor b;
c1..cx: client ratings on items 1 through x provided by assessor c.

3.2: the complete `changelog' file

psycho (0.00.01)    (WIP)

  * Starting writing the https://www.icce.rug.nl/psycho documentation.

  * The documentation now shows the current version.

  * oosix defines the mail address psycho@icce.rug.nl, and the /var/lib/psycho
    account. Incoming mail is properly received.

  * Web-pages are now at /var/lib/psycho/www, using symlinks from
    /var/www/ssl_icce.rug. 

  * Completed an initial demo version of a web-client registration form. It
    does not yet perform actions.

 -- Frank B. Brokken <f.b.brokken@rug.nl>  Tue, 13 Mar 2018 17:31:24 +0100

psycho (0.00.00)

  * Initial installation of 'psycho': gnuplot/ containing gnuplot demo and
    configuration, setup/ containing the libreoffice-impress setup.odp
    document. 

 -- Frank B. Brokken <f.b.brokken@rug.nl>  Mon, 12 Mar 2018 09:25:15 +0100