It should be possible to run gmkin on most laptop or desktop computers running Linux, Mac OS X, Windows XP or Windows 7. It is frequently checked under Linux and Windows 7.
To view the complete set of widgets in the browser window without resizing anything, it needs a screen space of 1366x740 pixels.
Please refer to CRAN for installation instructions and binary packages. If you are on Windows, please consult the FAQ for Windows, especially the entries “How do I install R for Windows?”, “How do I run it?”.
If you would like to upgrade your R installation, please refer to the respective FAQ entry.
Windows and Linux users running R 3.1.0 or later can make use of my drat package repository on github. Before installing gmkin, you should update your R packages already installed, e.g. by starting R, and pasting the command
or similar, depending on your R installation.
For installing gmkin or upgrading to the latest released version, please install the drat package
add my repository
and install as usual
Without further preparation, you can start the GUI by starting R and pasting the following commands into the R terminal (R console on Windows):
You may also want to adapt the browser that R starts (using e.g.
options(browser="/usr/bin/firefox") on linux, or setting the default browser on Windows).
In case you would like to see the documentation of the underlying mkin package, please refer to its documentation website.
Users of the
devtools package can also install gWidgetsWWW2 and gmkin directly from the respective github repositories:
Installing gWidgetsWWW2 in this way yields a lot of warnings concerning overly long path names (see Notes on gWidgetsWWW2 above). Using
quick = TRUE skips docs, multiple-architecture builds, demos, and vignettes, to make installation as fast and painless as possible.
You can put the commands
into an R script (e.g. under
C:\Users\<your username>\AppData\Roaming\gmkin_start.R), and create a Windows shortcut, e.g. on the Desktop, with the target
"C:\Program Files\R\R-3.x.y\bin\R.exe" --slave -f c:\Users\<your username>\AppData\Roaming\gmkin_start.R, where R.x.y is the version of R that you would like to use with gmkin. This will start a non-interactive R console that runs the gmkin GUI. In the properties dialogue of the shortcut, you can also set the working directory in which it starts gmkin. Thanks to Jonas Klein of the Umweltbundesamt for the trick with using Sys.sleep in a while loop and for suggesting the AppData directory for the start script.
Financial support, feedback and suggestions by the German Federal Environmental Agency (Umweltbundesamt) in two projects in 2014 and 2015 was crucial for reaching version 0.6.3 in November 2015 and is gratefully acknowledged. In particular, Stefan Meinecke contributed with a lot of user feedback and suggestions for improvement in that time.