SimThyr Files

SimThyr notes

SimThyr is a continuous simulator for pituitary-thyroid homeostasis. Pre-compiled Software is available for macOS / Mac OS X, Mac OS Classic and Windows. SimThyr was developed with Lazarus / Free Pascal (macOS, Linux and Windows) or THINK Pascal (Mac OS Classic), respectively. Source code is provided for all supported platforms and may also be used in order to compile SimThyr for additional platforms.


Installation

The recommended way to install SimThyr on Windows-based computers is to use the provided installer. For special requirements, e.g. for installation on computers without administrative rights, also a portable application is provided. In order to install the portable version simply drag the application file from the archive to the desired location on your file system. You may even start SimThyr portable directly from a web server (depending from the settings of your browser). This may have advantages e.g. for CBT labs and other computer resource centers.

In order to install SimThyr on macOS, simply double click the DMG file and drag the application file from its window to the desired location on your file system. SimThyr for Mac doesn't come with and doesn't require an installer. It may also be used as a portable application that is started from USB sticks, CDs, server volumes or other media.

On Linux, please download the source code and compile it for your processor and operating system with Lazarus / Free Pascal.


Source Code

Sources are available for SimThyr 2.0 and all newer versions. For compiling SimThyr 3.0 or newer you will need Lazarus / Free Pascal, for SimThyr 2.0 THINK Pascal 4 or newer is required.

In order to compile SimThyr 3.0 or newer from source please download (or check-out) the source code archive and decompress the folder at a location of your choice. This is your working environment.

With the working environment in place you are ready to compile SimThyr as follows:

1. Start Lazarus.
2. Close any existing project by selecting the menu entry "Project" > "Close Project".
3. Subsequently the Project Wizard will pop up.
   - Here please click the "Open Project" button.
   - Navigate to the folder of your working environemt.
   - Select file "SimThyr.lpi" and "Open".
   - Subsequently the project will be loaded and is ready for being compiled.
4. For a quick test run of the project select the menu entry "Run" > "Run", press F9
   (Windows or Linux) or Command + R (Mac OS X).
   In the "Messages" window the last line should read "Project SimThyr successfully built" (or an appropriate translation).
5. SimThyr should run.

On certain platforms the steps 1. to 3. may be replaced by simply double-clicking the file "SimThyr.lpi".

For compiling SimThyr 2.0 please download the BinHex archive for SimThyr 2 and decompress the folder at a location of your choice. This is your working environment. After double-clicking the project file THINK Pascal will launch and load the project. Run the program by choosing "Go" from the "Run" menu or by typing Command + R.

You can now modify the code as required and re-compile the project.


Compatibility

SimThyr 4.x for Mac supports macOS 10.12 or newer with the Cocoa API on systems with Intel 64-bit processors or Mac OS X 10.6 or newer with the Carbon API on systems with 32-bit processors. Release versions of SimThyr are code-signed for newer versions of macOS.

SimThyr 3.x for Mac supports Mac OS X 10.4 or newer with the Carbon API on systems with either Intel or PPC 32-bit processors. Release versions of SimThyr are code-signed for newer versions of macOS.

SimThyr 3.x and 4.x for Windows has been developed for Windows XP and was successfully tested on various Windows versions including Windows 2000, Windows 7 and Windows 10.

Mac OS Classic is supported by the legacy version SimThyr 2.0 only.

In order to use SimThyr on Linux please download the source code and compile it for your processor and operating system with Lazarus / Free Pascal. The recommended versions are Lazarus 2.0 or newer and Free Pascal 3.0 or newer.


Scenario files

Simulation scenarios, e.g. containing a set of structure parameters in certain thyroid disorders, may be stored as XML files and reused, e.g. for talks, presentations or educational purposes (SimThyr 3.0 or newer only).


Handbook

Manuals and introductory information are available from http://simthyr.sourceforge.net/manual.html.


Version history

A complete and regularly updated list of all SimThyr revisions is available from http://sourceforge.net/p/simthyr/wiki/Version_History/.


J. W. Dietrich