getGAUSSHome

Purpose

Returns the full path to the GAUSS home directory.

Format

g_home = getGAUSSHome()
Parameters:

relative_path (string) – Optional input containing extra path information, you would like to add to the end of the GAUSS Home path.

Returns:

g_home (string) – full path to GAUSS home directory.

Examples

Locate the GAUSS home directory

If you installed GAUSS in the directory, C:\gauss:

g_home = getGAUSSHome();
print g_home;
C:\gauss

Loading a file from the GAUSS examples directory

GAUSS 23 and newer versions allow you to pass in the relative path to the file you wish to load as shown below.

// Create full path to dataset
f_name = getGAUSSHome("examples/fueleconomy.dat");

// Load the dataset
fuel_economy = loadd(f_name);

Previous versions did not accept the path as an input and required the use of the string combine operator $+ to create the full path.

// Create full path to dataset
f_name = getGAUSSHome() $+ "examples/fueleconomy.dat";

// Load the dataset
fuel_economy = loadd(f_name);

Remarks

getGAUSSHome() can be used to load and save files in directories that are relative to the GAUSS installation directory without knowing its exact location ahead of time. This can help to make programs that will run on multiple computers, using different paths without any changes to the code.

See also

Functions __FILE_DIR