QPP Developer Manual

This page provides instructions for QPP developers needing to build QPP from source. It assumes reasonable familiarity with Java and Linux software development.

Developer Outline

  1. Examine the QPP release notes to determine which version of QPP you wish to install. Most of time, it will be the latest release.
  2. The release notes will tell you which release of JSim is necessary to support your QPP release. Install this version, if it is not already installed, by visiting the JSim downloads page.
  3. Install a recent version the Sun Java 5 SDK, if you don't already have one installed. Some problems have been encountered with the Sun Java 6 SDK, so don't use that one.
  4. Download an appropriate QPP source distribution zip file from the J4 Downloads page.
  5. Set the environment for qpp users to include the following variables:
    • JSIMHOME: the home directory for your JSim installation;
    • JSIMSDK: the directory holding your Java SDK;
    • J4SRC: the directory holding the QPP source;
    • PATH: should include $J4SRC/build;
  6. Unzip your QPP source distribution zip file in $J4SRC.
  7. Compile the J4 source with the j4comp command.
  8. The source distribution version of the QPP application is launched via the qpp.db script in $J4SRC/build. See the QPP Administrator Manual for further set up details.
  9. Examine to other scripts in $J4SRC/build for further developer functionality, not yet documented. The j4run.db script is very useful for running test harnesses.

Running the source QPP distribution in place of the binary version

To run a source build of QPP in place of the binary version, first familiarize yourself with the binary distribution administrator manual. Then modify the QPP user environment as follows:

  • set J4SRC, JSIMHOME and JSIMSDK as described above;
  • set J4HOME to $J4SRC/home;
  • alias qpp to $J4SRC/build/qpp.db.

Model development and archiving support at https://www.imagwiki.nibib.nih.gov/physiome provided by the following grants: NIH U01HL122199 Analyzing the Cardiac Power Grid, 09/15/2015 - 05/31/2020, NIH/NIBIB BE08407 Software Integration, JSim and SBW 6/1/09-5/31/13; NIH/NHLBI T15 HL88516-01 Modeling for Heart, Lung and Blood: From Cell to Organ, 4/1/07-3/31/11; NSF BES-0506477 Adaptive Multi-Scale Model Simulation, 8/15/05-7/31/08; NIH/NHLBI R01 HL073598 Core 3: 3D Imaging and Computer Modeling of the Respiratory Tract, 9/1/04-8/31/09; as well as prior support from NIH/NCRR P41 RR01243 Simulation Resource in Circulatory Mass Transport and Exchange, 12/1/1980-11/30/01 and NIH/NIBIB R01 EB001973 JSim: A Simulation Analysis Platform, 3/1/02-2/28/07.