I. Java version.
Click the "Download Java" option, save the PKQuest_Java.zip
file to you computer and unzip it. Double click the
pkquest.jar file to run PKQuest. See Tutorial.doc for detailed
instructions. Note: you must have a recent version of the Java
Runtime Environment (JRE) installed on your computer.
II. Maple version.
You first must install Maple before you can install this version
of PKQuest. See
http://webstore.maplesoft.com/ for details about
Download PKQuest from
Maple is an
intrinsically interactive program, and the setup is a bit messy
compared to the usual Windows programs you are familiar with. The
following detailed instructions are designed for users that do not
have a lot of familiarity with Maple. More experienced users may
want to modify this procedure.
1) Create the
In the following instructions it will be
assumed that you have created the following folders:
a) A main PKQuest folder: for example in
C:/Documents and Setting/Yourname/My
b) A library subfolder in pkquest, for example
C:/Documents and Setting/Yourname/My Documents/pkquest/library
In the rest of these instructions, it will be
assumed that the above specific file names are used. You should
change the names to whatever path you prefer.
2) Write and save the maple.ini file.
This file is called when Maple is first
opened. It is used to tell Maple where to look for Maple
libraries. Create a text (ascii) file (e.g. using Word and saving
as "Text only" format) containing the following on one line
(note, this is the name of library subfolder).
libname:="C:/Documents and Settings/Name/My
On windows systems: Save this with the
filename maple.ini in the folder C:\Program Files\Maple
On Mac systems: Save this with the filename
Maple 9.5 Init Preferences
in the folder Global Preferences
(I think ???).
3) Download the PKQuest routines (Maple worksheets) from
www.pkquest.com. There are two zip files on the Download
page: the Program zip file and Application zip file.
The program zip contains the following 8 worksheets:
1) pkquest.mws The Maple
procedure that actually runs PKQUEST when called
2) gensolve_date.mws A set of Maple
procedures that does most of the work.
3) numeric_routines_date.mws A set
of numeric routines called by gensolve.
4) deconvolve_date.mws A set of routine used for
5) help_date.mws The worksheet that contains all the
6) setup_date.doc A Word document
providing the setup instructions
7) Manual_PBPK.doc A Word document
manual for using PKQuest
8) Manual_deconvolution.doc A Word document manual for
Move pkquest.mws to the main PKQuest
Move help_date.mws, gensolve_date.mws,
numeric_routines_date.mws and deconvolve_date.mws to the library
subfolder …./pkquest/library .
The Application zip file contains a set
of specific solute worksheets:
i.e. solutename.mws (e.g. ethanol.mws,
Note: A few of these files may have not been
updated for compatibility with recent changes in the PKQuest
program. If you have any questions about their use, contact D.
4) Install PKQuest:
a) Start the Classic interface version
of Maple. A Maple worksheet (Untitled) will open. You should
see at the top of this worksheet the line:
libname := "C:…./pkquest/library",
"C:\Program Files\Maple 8/lib" where the first term in the " " is
determined by the line you inserted in maple.ini.
This indicates that there is a path to the
pkquest library file and that libname="C:…/pkquest/library".
b) Enter the command:
This creates a Maple "repository" in the folder
c) Open help_date.mws worksheet.
Place pointer over any red letter in this worksheet and "Press
enter". This compiles all the routines in this worksheet and saves
them to the Maple repository in libname.
( Note: you may get message: "During help
initialization - could not open any files" - Just click OK and
d) Repeat procedure (c) for gensolve_date.mws
e) Repeat procedure (c) for numeric_routines_date.mws
f) Repeat procedure (c) for
This completes the installation of the
Library Files. Close and exit Maple.
V) Run PKQUEST:
a) Start Maple and then open the
worksheets pkquest.mws and any solutename.mws (e.g. D20_shlorb.mws).
b) Place flashing pointer over red letter in solutename.mws
and enter (compile).
c) Insert the call to solutename.mws
into pkquest.mws (e.g. propranolol_iv_fagen()) or just uncomment
(remove # sign) the name if it is listed already.
d) Adjust the plot parameters in pkquest(). Initially, the
only parameter that you may need to change is the value of (ip,1) in
modelplot. Set (ip,1) = vein,artery or arm (=antecubital vein)
for most solutes, set (ip,1) = lung to plot end tidal concentration
for volatile solutes.
e) Place flashing pointer over any red
letter in pkquest.mws and enter (compile).
f) PKQuest is now compiled for these
specific conditions: entering "pkquest();" will run the program.
g) If you change anything in either pkquest.mws or solutename.mws, place pointer over red letter and
"enter" to recompile.