GNU Scientific Library (GSL): Difference between revisions
Jump to navigation
Jump to search
No edit summary |
(Redirected page to GSL) Tag: New redirect |
||
| (7 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
#REDIRECT[[GSL]] |
|||
{| width=600px class="wikitable" |
|||
|- |
|||
! Description !! Content |
|||
|- |
|||
| module load |
|||
| numlib/gsl |
|||
|- |
|||
| Availability |
|||
| [[bwUniCluster]] | [[BwForCluster_Chemistry]] |
|||
|- |
|||
| License |
|||
| |
|||
|- |
|||
|Citing |
|||
| |
|||
|- |
|||
| Links |
|||
| |
|||
|- |
|||
| Graphical Interface |
|||
| No |
|||
|- |
|||
|} |
|||
<br> |
|||
= Description = |
|||
The '''GNU Scientific Library''' (or '''GSL''') is a software library for numerical computations in applied mathematics and science. The GSL is written in the C programming language, but bindings exist for other languages as well. |
|||
<br> |
|||
<br> |
|||
= Versions and Availability = |
|||
A list of versions currently available on the bwForCluster Chemistry can be obtained from the |
|||
<br><big> |
|||
[https://cis-hpc.uni-konstanz.de/prod.cis/ Cluster Information System CIS] </big> |
|||
{{#widget:Iframe |
|||
|url=https://cis-hpc.uni-konstanz.de/prod.cis/bwUniCluster/numlib/gsl |
|||
|width=99% |
|||
|height=250 |
|||
|border=0 |
|||
}} |
|||
<br> |
|||
Show a list of available versions using 'module avail numlib/gsl' on any HPC-C5 cluster. |
|||
<pre> |
|||
: EXAMPLE bwUniCluster |
|||
$ module avail numlib/gsl |
|||
------------------------ /opt/bwhpc/common/modulefiles ------------------------- |
|||
numlib/gsl/1.16-gnu-4.4 numlib/gsl/1.16-intel-14.0 |
|||
numlib/gsl/1.16-intel-13.1(default) |
|||
</pre> |
|||
<br> |
|||
= Documentation = |
|||
=== Online === |
|||
[http://www.gnu.org/software/gsl/ Online-Documentation] |
|||
=== Local === |
|||
* info gsl |
|||
* man gsl |
|||
* man gsl-config |
|||
<br> |
|||
= Tips for compiling and linking = |
|||
== Loading the module == |
|||
You can load the default version of the GSL library with the command<br> |
|||
'module load numlib/gsl'. |
|||
<br> |
|||
The module will try to load modules it needs to function. |
|||
If loading the module fails, check if you have already loaded one of those modules with the command 'module list'. |
|||
<br> |
|||
If you wish to load a specific (older) version (if available), you can do so using e.g. |
|||
' module load numlib/gsl/'version' to load the version you desires. |
|||
<pre> |
|||
$ module avail numlib/gsl |
|||
------------------------ /opt/bwhpc/common/modulefiles ------------------------- |
|||
numlib/gsl/1.16-gnu-4.4 numlib/gsl/1.16-intel-14.0 |
|||
numlib/gsl/1.16-intel-13.1(default) |
|||
$ module load numlib/gsl/1.16-gnu-4.4 |
|||
$ module list |
|||
Currently Loaded Modulefiles: |
|||
1) numlib/gsl/1.16-gnu-4.4 |
|||
</pre> |
|||
<br> |
|||
= GSL-Specific Environments = |
|||
To see a list of all GSL environments set by the 'module load'-command use 'env | grep GSL'. |
|||
<br> |
|||
Or use the command 'module display numlib/gsl'. |
|||
<pre> |
|||
$ module show numlib/gsl------------------------------------------------------------------- |
|||
/opt/bwhpc/common/modulefiles/numlib/gsl/1.16-intel-13.1: |
|||
GSL_VERSION = 1.16 |
|||
GSL_HOME = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1 |
|||
GSL_BIN_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/bin |
|||
GSL_INC_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/include |
|||
GSL_LIB_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/lib |
|||
GSL_STA_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/lib |
|||
GSL_SHA_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/lib |
|||
GSL_MAN_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/share/man |
|||
GSL_INF_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/share/info |
|||
GSL_DOC_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/share/doc |
|||
GSL_EXA_DIR = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/share/doc/examples |
|||
GSL_WWW http://www.gnu.org/software/gsl/ |
|||
PATH = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/bin:$PATH |
|||
MANPATH = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/share/man:$MANPATH |
|||
INFOPATH = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/share/info:$INFOPATH |
|||
LD_LIBRARY_PATH = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/lib:$LD_LIBRARY_PATH |
|||
INCLUDE = /opt/bwhpc/common/numlib/gsl/1.16-intel-13.1/include:$INCLUDE |
|||
[...] |
|||
</pre> |
|||
<br> |
|||
= How To Use the Library = |
|||
== Includes == |
|||
Your source code should contain preprocessor include statements with a gsl/ prefix, such as |
|||
<pre> #include <gsl/gsl_math.h></pre> |
|||
== Compile == |
|||
A typical compilation command for a source file example.c with the |
|||
Intel C compiler icc is |
|||
<pre> $ icc -Wall -I$GSL_INC_DIR -c example.c </pre> |
|||
The [[#GSL-Specific Environments|$GSL_INC_DIR environment variable] points to location of |
|||
the include path for the gsl header files. |
|||
<br> |
|||
== Link == |
|||
The following command can be used to link the application with the gsl libraries. |
|||
<pre> $ icc -L$GSL_LIB_DIR -o example example.o -lgsl -lgslcblas -lm </pre> |
|||
The [[[#GSL-Specific Environments||$GSL_LIB_DIR environment] variable points to the location |
|||
of the gsl libraries. |
|||
<br> |
|||
Also make sure to have the GSL-module loaded before running applications build |
|||
with this library. |
|||
<br><br> |
|||
= Example C-Source Code = |
|||
== Create source code file 'intro.c' == |
|||
<source lang="c"> |
|||
#include <stdio.h> |
|||
#include <gsl/gsl_sf_bessel.h> |
|||
int main (void) |
|||
{ |
|||
double x = 5.0; |
|||
double y = gsl_sf_bessel_J0 (x); |
|||
printf ("J0(%g) = %.18e\n", x, y); |
|||
return 0; |
|||
} |
|||
</source> |
|||
== Compile and Link == |
|||
Load the gsl module for the Intel compiler, compile, link and run the program |
|||
<pre> |
|||
$ module load numlib/gsl/1.16-intel-13.1 |
|||
Loading module dependency 'compiler/intel/13.1'. |
|||
$ icc -Wall -I$GSL_INC_DIR -c intro.c |
|||
$ icc -L$GSL_LIB_DIR -o intro intro.o -lgsl -lgslcblas -lm |
|||
$ ./intro |
|||
J0(5) = -1.775967713143382642e-01 |
|||
</pre> |
|||
[[Category: Numerical libraries]][[Category:bwUniCluster]] |
|||
Latest revision as of 22:25, 4 February 2022
Redirect to: