This section will discuss the setup needed by users to use the installed Magics library and its applications.
Magics environment variables
The variable $MAGPLUS_HOME is the path where Magics will find all auxiliary data at run-time. If Magics is installed where the configure prefix option was set to, this variable does NOT need to be set. Otherwise the variable needs to be set for all users of Magics programs. If Magics reports problems at run-time about missing coastlines or fonts this variable might not be set correctly.
Magics provides feedback on the console. You can control the amount of messages plotted by setting any of the following environment variables:
$MAGPLUS_INFO - Information and hints to what Magics is doing
$MAGPLUS_QUIET - suppresses the Magics header, footer and info output – only errors and warnings will cause output
System environment variables
$LD_LIBRARY_PATH - To work with shared libraries the locations of these libraries need to be known at run-time. This environment variable contains a list of paths where at run-time the system loader will look for libraries. To use the shared library version of Magics the location of the library needs to be set in $LD_LIBRARY_PATH. If the variable is not set correctly the loader might pick up a version of Magics which was not intended.
If EmosLib is compiled with Pgf90, it binds in libpgc.so dynamically at run-time and so the path to this library needs to be in $LD_LIBRARY_PATH.
$PATH - Magics provides not only libraries, but also some executables. To use these, the $PATH needs to include the location of these programs. Usually this will be $MAGPLUS_HOME/bin.