Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
_These are mostly GNU/Linux [BASH Shell](https://www.gnu.org/software/bash/), AWK, [Perl](https://www.perl.org/), Sed & [MS-PowerShell](https://learn.microsoft.com/en-gb/powershell/) calculator scripts for cognitive tests, psychiatric rating scales, cardiovascular calculators. Some calculators are platform independent (Perl, [REXX](https://www.rexxla.org/), [FreeBASIC](https://www.freebasic.net/), and other Batch files for [FreeDOS](https://www.freedos.org/)_. _Some scripts are designed for GNU/Linux and other POSIX compatible OS, others are geared to MS-PowerShell, and some others eg platform independent eg Perl._

# Rationale
Medical calculators help provide numerical values which makes quantification, and tracking of progress easier. Medicine is not a pure scientific endeavour, hence, some medical calculators esp. measuring depression severity etc. attempt to put a numerical value to a subjective experience. At present, there are available calculators online however, they do not cover every thing. They tend to require GUI, online connection, and modern web-browser. The aim of these calculators and algorithms is to provide a simple minimalist effecient command-line interface (CLI) scripts which could work in a shell, or terminal. These tests do not require GUI or online connection (*apart from downloading them*). The current scripts aim to cover multiple platforms eg \*nix (Unix, BSD, GNU/Linux), \*nix/BSD derivatives eg MacOS, platforms that have POSIX compliance layer eg [Haiku](https://www.haiku-os.org/), as well as other operating systems eg FreeDOS & MS-Windows, as well as other platform independent calculators and algorithms. Also, users have access to the source code, so they are welcome to study, improve, and copy the design for other tests under GNU/GPL-3 license.
Medical calculators help provide numerical values which makes quantification, and tracking of progress easier. Medicine is not a pure scientific endeavour, hence, some medical calculators esp. measuring depression severity etc. attempt to put a numerical value to a subjective experience. The aim of these calculators and algorithms is to provide a simple minimalist effecient command-line interface (CLI) scripts which could work in a shell, or terminal. These tests do not require online connection (*apart from downloading them*). The current scripts aim to cover multiple platforms eg \*nix (Unix, BSD, GNU/Linux), \*nix/BSD derivatives eg MacOS, platforms that have POSIX compliance layer eg [Haiku](https://www.haiku-os.org/), as well as other operating systems eg FreeDOS & MS-Windows (_via CMD.exe &/or PowerShell_), as well as other platform independent calculators and algorithms. Also, users have access to the source code, so they are welcome to study, improve, and copy the design for other tests under GNU/GPL-3 license.

# Coding Principles
The general guiding concept is that these codes offer more than just a calculator. They print a report that could be copied from a terminal, or could be saved to a file. They calculate subscores, and they have data validation for each parameter with loops to guard against accidental typos. Also, in case of subscores, there are `if` statements to make sure that the score entered is logical eg. in ACE-III if someone scores 4/5 in orientation in time. The test will ask about score for Mini-ACE which is out of 4. Logically, the result could be only 4 or 3. If the ACE-III orientation in time score is 1, the Mini-ACE would only be 1 or 0. The code makes sure that the results are coherent in that sense. The same principle guides registration & recall; one cannot recall, what one did not register. `while` loops ensure that values entered are within the accepted range only to minimise the GIGO effect.
Expand Down