LongQt is a user interface for heart cell models. It allows users to create and run simulations of the electrical activity in single heart cells or in tissue. The aim of LongQt is both to have a program which is useful for teaching new students trying to understand the functions of heart cells as well as in the lab to easily run simulations and experiments. To this end there are four components of LongQt.
Hundlab Website: hundlab.org
Github: github.com/hundlab/LongQt
Documentation: longqt.readthedocs.io
The latest executables can be downloaded and installed from our website). The executables will install LongQt and make it available to run.
LongQt is built using cmake, and can be imported into QtCreator or any other IDE that supports the cmake build system.
- Qt version 5.15: https://www.qt.io/
- windows: install the MSVC compiled version
- c++17 or greater compliant compiler
- linux: gcc
- windows: MSVC 2019
- OS X: clang
- cmake
- optional:
- QtCreator
To start both the LongQt project and LongQt-model project need to be cloned from github into the following directory structure
<parent_dir>/LongQt-model
<parent_dir>/LongQt
LongQt needs to be built with different build systems depending on the platform, for windows use MSVC 2019, for linux use gcc (or clang), and for mac use clang. On windows MSCV 2019 can be installed as a standalone package or as a part of the visual studio IDE. Qt 5.12 should be used, although other versions of Qt will likely work as well.
To build LongQt, cmake needs to be told to look for LongQt-model as a subdirectory, this is why
the directory structure needs to follow the description above. When running cmake, specify
LongQt_subdir:BOOL=TRUE
. If using QtCreator this can be done through the projects tab, if using
the command line, it can be specified as an argument to cmake -DLongQt_subdir:BOOL=TRUE
.
When LongQt is built, it will also produce executables for LongQt-Grapher and LQ-GridEditor.
These can be run from the build directory, or by hitting run in QtCreator. To run
LongQt-Grapher or LQ-GridEditor, change the run options in the projects tab.
The primary reason to install LongQt is to
build the LongQt Installer executable. If you are not currently trying to build the installer,
you can stop reading the directions now. These steps can be followed at a later time
when you are interested in building the installer. This is not needed for development,
only for deployment (which is currently handled using github actions). Set the install directory
manually, by setting CMAKE_INSTALL_PREFIX to <LongQt-Installer root dir>/install/LongQt/
(this folder will not exist until it is created for the install). Then add the install
directive to the build process. Then follow the remaining steps on the LongQt-Installer's README
github.com/hundlab/LongQt-Installer.