From 701346aa30ba72f312fb1813fb27c90ce5611cdf Mon Sep 17 00:00:00 2001 From: Johannes Ranke Date: Sat, 23 Jan 2016 10:57:17 +0100 Subject: Add three howtos to the manual serving as GUI test cases --- vignettes/gmkin_manual.Rmd | 79 ++++++++++++++++++++++++++++++++++++++++ vignettes/gmkin_manual.html | 88 +++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 165 insertions(+), 2 deletions(-) (limited to 'vignettes') diff --git a/vignettes/gmkin_manual.Rmd b/vignettes/gmkin_manual.Rmd index 6d9e94f..3a0f3f0 100644 --- a/vignettes/gmkin_manual.Rmd +++ b/vignettes/gmkin_manual.Rmd @@ -405,4 +405,83 @@ confidence intervals are graphically displayed as bars as shown below. ![confidence](img/confidence.png) +## Howtos + +The following sections show step by step descriptions of how to perform certain +tasks using gmkin. In principle, this should be necessary as the GUI was +designed to be largely self-explanatory. Nevertheless may help a beginner to +understand how to use gmkin. At the same time, the gmkin author uses them as +test cases to make sure that the most important functionality is not broken +before releasing a new version. + +### 1. Use a model and a dataset from a built-in workspace + +- Start gmkin +- In the project explorer, select the project 'FOCUS_2006' +- In the dataset explorer, select 'FOCUS example dataset C' +- In the model explorer, select 'SFO' +- In the configuration display, press 'Configure fit' +- In the configuration editor in the center, press 'Run fit' +- In the pop-up window that appears, press 'Yes' +- In the result viewer in the center, press 'Keep fit' +- Switch to the Project editor in the center +- In the project explorer, enter the project name 'Howto test 1' +- Press 'Save project to project file' + +### 2. Enter a simple dataset and evaluate it using a model from the gallery + +- Start gmkin +- In the project explorer, enter the project name 'Howto test 2' +- Press 'Save project to project file' +- Select the dataset editor in the center +- Enter dataset title 'Data howto 2' +- Enter sampling times '0, 1, 3, 7, 14' +- Enter replicates '1' +- Enter observed variable 'parent, A1' +- Press 'Generate grid for entering kinetic data' +- In the value column of the dataset editor, enter values '100', '30', '10', + '5', '3', '' (nothing), '3', '8', '7', '5' +- Press 'Keep changes' +- Select the 'Model gallery' to the right +- From the model gallery, press 'FOMC, one met' below the corresponding model scheme +- In the dataset explorer, select 'Test dataset howto 2' +- In the model explorer, select 'FOMC, one met' +- In the configuration display, press 'Configure fit' +- In the configuration editor in the center, press 'Run fit' +- In the pop-up window that appears, press 'Yes' +- In the result viewer in the center, press 'Keep fit' +- Switch to the Project editor in the center +- Press 'Save project to project file' + +### 3. Load a tab separated input file in wide format and evaluate using a newly created model + +- Start gmkin +- In the project explorer, enter the project name 'Howto test 3' +- Press 'Save project to project file' +- Select the dataset editor in the center +- In the data upload widget, press 'Browse' +- Select the file 'testdata/d_synth_DFOP_lin_c.txt' from gmkin installation +- Press 'Upload' +- Press 'Import using options specified below' +- Enter dataset title 'DFOP lin c' +- Press 'Keep changes' +- Select the model editor in the center +- Press 'New model' +- Enter 'DFOP lin' as the model name +- Select 'max' in the dropbox 'Use of formation fractions' +- Press 'Add observed variable' three times +- In the line where 'parent' is selected, in the dropbox after the word 'to', select 'M1' +- Click outside the dropbox +- In the line where 'M1' is selected, in the dropbox after the word 'to', select 'M2' +- Click outside the dropbox +- Press 'Keep changes' +- In the dataset explorer, select 'DFOP lin c' +- In the model explorer, select 'DFOP lin' +- In the configuration display, press 'Configure fit' +- In the configuration editor in the center, press 'Run fit' +- In the pop-up window that appears, press 'Yes' +- In the result viewer in the center, press 'Keep fit' +- Switch to the Project editor in the center +- Press 'Save project to project file' + diff --git a/vignettes/gmkin_manual.html b/vignettes/gmkin_manual.html index 1a9de0b..594346f 100644 --- a/vignettes/gmkin_manual.html +++ b/vignettes/gmkin_manual.html @@ -10,7 +10,7 @@ - + Manual for gmkin @@ -65,7 +65,7 @@ img {
@@ -88,6 +88,11 @@ img {
  • Results and summary
  • +
  • Howtos
  • @@ -243,6 +248,85 @@ Optimisation by method Port successfully terminated.

    Whenever a new fit has been configured or a run of a fit has been completed, the plotting area is updated with the abovementioned plot of the data and the current model solution.

    In addition, a confidence interval plot is shown below this conventional plot. In case a fit has been run and confidence intervals were successfully calculated for the fit (i.e. if the model was not overparameterised and no other problems occurred), the confidence intervals are graphically displayed as bars as shown below.

    confidence

    + + +
    +

    Howtos

    +

    The following sections show step by step descriptions of how to perform certain tasks using gmkin. In principle, this should be necessary as the GUI was designed to be largely self-explanatory. Nevertheless may help a beginner to understand how to use gmkin. At the same time, the gmkin author uses them as test cases to make sure that the most important functionality is not broken before releasing a new version.

    +
    +

    1. Use a model and a dataset from a built-in workspace

    +
      +
    • Start gmkin
    • +
    • In the project explorer, select the project ‘FOCUS_2006’
    • +
    • In the dataset explorer, select ‘FOCUS example dataset C’
    • +
    • In the model explorer, select ‘SFO’
    • +
    • In the configuration display, press ‘Configure fit’
    • +
    • In the configuration editor in the center, press ‘Run fit’
    • +
    • In the pop-up window that appears, press ‘Yes’
    • +
    • In the result viewer in the center, press ‘Keep fit’
    • +
    • Switch to the Project editor in the center
    • +
    • In the project explorer, enter the project name ‘Howto test 1’
    • +
    • Press ‘Save project to project file’
    • +
    +
    + +
    +

    3. Load a tab separated input file in wide format and evaluate using a newly created model

    +
      +
    • Start gmkin
    • +
    • In the project explorer, enter the project name ‘Howto test 3’
    • +
    • Press ‘Save project to project file’
    • +
    • Select the dataset editor in the center
    • +
    • In the data upload widget, press ‘Browse’
    • +
    • Select the file ‘testdata/d_synth_DFOP_lin_c.txt’ from gmkin installation
    • +
    • Press ‘Upload’
    • +
    • Press ‘Import using options specified below’
    • +
    • Enter dataset title ‘DFOP lin c’
    • +
    • Press ‘Keep changes’
    • +
    • Select the model editor in the center
    • +
    • Press ‘New model’
    • +
    • Enter ‘DFOP lin’ as the model name
    • +
    • Select ‘max’ in the dropbox ‘Use of formation fractions’
    • +
    • Press ‘Add observed variable’ three times
    • +
    • In the line where ‘parent’ is selected, in the dropbox after the word ‘to’, select ‘M1’
    • +
    • Click outside the dropbox
    • +
    • In the line where ‘M1’ is selected, in the dropbox after the word ‘to’, select ‘M2’
    • +
    • Click outside the dropbox
    • +
    • Press ‘Keep changes’
    • +
    • In the dataset explorer, select ‘DFOP lin c’
    • +
    • In the model explorer, select ‘DFOP lin’
    • +
    • In the configuration display, press ‘Configure fit’
    • +
    • In the configuration editor in the center, press ‘Run fit’
    • +
    • In the pop-up window that appears, press ‘Yes’
    • +
    • In the result viewer in the center, press ‘Keep fit’
    • +
    • Switch to the Project editor in the center
    • +
    • Press ‘Save project to project file’
    • +
    -- cgit v1.2.1