Regina Calculation Engine
|
Provides global routines that return directories in which various components of Regina are installed on the system. More...
#include <file/nglobaldirs.h>
Static Public Member Functions | |
static std::string | home () |
Returns Regina's primary home directory on the system. More... | |
static std::string | pythonModule () |
Returns the directory in which Regina's python module is installed, or the empty string if the module is installed in python's standard site-packages directory. More... | |
static std::string | pythonLibs () |
Returns the directory in which optional "helper" Python libraries are installed. More... | |
static std::string | examples () |
Returns the directory in which example data files and census data files are installed. More... | |
static std::string | engineDocs () |
Returns the directory in which API documentation for Regina's calculation engine is installed. More... | |
static std::string | data () |
Returns the directory containing internal data files for Regina's calculation engine. More... | |
static void | setDirs (const std::string &homeDir, const std::string &pythonModuleDir) |
Tells Regina where data files are installed. More... | |
Provides global routines that return directories in which various components of Regina are installed on the system.
By default, these routines are only useful with a fixed filesystem installation of Regina (e.g., a typical Linux install). Specifically, they return the relevant directories as they were configured by cmake at build time.
If Regina may have been moved around on the filesystem (e.g., if you are running an app bundle on MacOS), you must call setDirs() when your application starts. Otherwise the directories that NGlobalDirs returns might be incorrect, and might not even exist.
At present this class does not support running Regina directly out of the source tree. This might be supported in future versions of Regina.
|
static |
Returns the directory containing internal data files for Regina's calculation engine.
|
static |
Returns the directory in which API documentation for Regina's calculation engine is installed.
|
static |
Returns the directory in which example data files and census data files are installed.
|
static |
Returns Regina's primary home directory on the system.
This directory should contains subdirectories icons/, examples/ and so on.
|
static |
Returns the directory in which optional "helper" Python libraries are installed.
These libraries are not a formal part of Regina, but can be made to load automatically as extra user libraries through Regina's python settings.
|
static |
Returns the directory in which Regina's python module is installed, or the empty string if the module is installed in python's standard site-packages directory.
|
static |
Tells Regina where data files are installed.
This is necessary if Regina is not installed in the location that was configured by cmake at build time (e.g., if you are running a MacOSX app bundle).
homeDir | Regina's primary home directory; this will be returned by homeDir(). |
pythonModuleDir | the directory containing Regina's python module, or the empty string if the module has been installed in python's standard site-packages directory; this will be returned by pythonModule(). |