File: 135_module_spider.rst

package info (click to toggle)
lmod 8.7.60-1
  • links: PTS, VCS
  • area: main
  • in suites: sid, trixie
  • size: 63,000 kB
  • sloc: sh: 6,266; makefile: 2,837; ansic: 1,513; tcl: 1,382; python: 1,050; csh: 112
file content (171 lines) | stat: -rw-r--r-- 5,926 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
.. _module_spider_cmd-label:

Using the module spider command
===============================

The module spider command reports all the modules that can be
loaded on a system.  In a flat module layout system, the *module
avail* and *module spider* return similar information.  In a
hierarchical system, *module spider* returns all the modules that are
possible where as *module avail* only reports modules that can be
loaded directly.

There are three modes to module spider

#. module spider: Report all modules, known as level 0.
#. module spider <name> : Report all the versions for the modules that
   match <name>.  This is known as level 1
#. module spider <name/version>: Report detailed information on a
   particular module version. This is known as level 2


Level 0: module spider
~~~~~~~~~~~~~~~~~~~~~~

The *module spider* command by itself lists all the modules that can be found.
If your site is running a flat layout, then the information displayed
will be similar to what *module avail* reports.  A typical output
looks like::

    $ module spider
    --------------------------------------------------------------
    The following is a list of the modules currently available:
    --------------------------------------------------------------
      autotools: autotools/1.2
        Autoconf, automake, libtool

      boost: boost/1.54.0, boost/1.55.0, boost/1.56.0, boost/1.61.0, boost/1.62.0
        Boost provides free peer-reviewed portable C++ source libraries.

      fftw2: fftw2/2.1.5
        Numerical library, contains discrete Fourier transformation

      gcc: gcc/4.7.3, gcc/4.8.1, gcc/5.3.1, gcc/6.2.0
        The Gnu Compiler Collection

      hdf5: hdf5/1.8.12, hdf5/1.8.13, hdf5/1.8.14
        General purpose library and file format for storing scientific data (Serial Version)

      lmod: lmod/7.5.9
        Lmod: An Environment Module System

      mpich: mpich/3.0.4-dbg, mpich/3.0.4, mpich/3.1.1-dbg, mpich/3.1.1, mpich/3.1.2-dbg, ...
        High-Performance Portable MPI

      openmpi: openmpi/1.8.2, openmpi/1.10.3, openmpi/2.0.1
        Openmpi Version of the Message Passing Interface Library

      phdf5: phdf5/1.8.12, phdf5/1.8.13, phdf5/1.8.14
        General purpose library and file format for storing scientific data (parallel I/O version)



This output shows the name of the module followed by a list of the
fullnames of the modules.  If there are more modules then can fit on
one line, the the list is truncated.  Below is the description.  Lmod
looks for a particular whatis command in the modulefile.  For example,
the autotools module has a whatis function call that looks like the
following in a lua modulefile::

    whatis("Description: Autoconf, automake, libtool")

In a TCL modulefile it would look like::

    module-whatis "Description: Autoconf, automake, libtool"

If your output of *module spider* doesn't have a description, please
ask your site to consider adding an appropriate whatis line in
your modulefiles.

Level 1: module spider name1 name2 ...
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

You can get more details about particular modules by adding one or more
names to the command to get a level 1 command.  For example::

   $ module spider hdf5

   ----------------------------------------------------------------------------
     hdf5:
   ----------------------------------------------------------------------------
       Description:
         General purpose library and file format for storing scientific data
         (Serial Version)

        Versions:
           hdf5/1.8.12
           hdf5/1.8.13
           hdf5/1.8.14
        Other possible modules matches:
           phdf5

Since the name "hdf5" matches a module name, Lmod only reports on the
hdf5 module and not the phdf5 module.  It does report that other
matches are possible (such as phdf5).  The reason for this is some
sites name the  R stat package as R.  This rule is to prevent getting
every module that has an 'r' in it.  Note that the searching for
modules is case insensitive.  So *module spider openmpi* would match a
module named *OpenMPI*.

If you search a name that only partially matches a module name then
Lmod reports all matches::

   $ module spider df5 

   ----------------------------------------------------------------------------
     hdf5:
   ----------------------------------------------------------------------------
       Description:
         General purpose library and file format for storing scientific data
         (Serial Version)

        Versions:
           hdf5/1.8.12
           hdf5/1.8.13
           hdf5/1.8.14

   ----------------------------------------------------------------------------
     phdf5:
   ----------------------------------------------------------------------------
       Description:
         General purpose library and file format for storing scientific data
         (parallel I/O version)

        Versions:
           phdf5/1.8.12
           phdf5/1.8.13
           phdf5/1.8.14


Finally, you can perform regular expression matches with::

  $ module -r spider '.*hdf5.*'



Level 2: module spider name/version
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The level 2 output provides a detailed report on a module::

   $ module  spider phdf5/1.8.14         

   ----------------------------------------------------------------------------
     phdf5: phdf5/1.8.14
   ----------------------------------------------------------------------------
       Description:
         General purpose library and file format for storing scientific
         data (parallel I/O version)

       You will need to load all module(s) on any one of the lines below
       before the "phdf5/1.8.14" module is available to load.

         gcc/4.8.1  mpich/3.1.1
         gcc/4.8.1  mpich/3.1.2
         gcc/4.8.1  openmpi/1.8.2


       Help:
          The HDF5 module defines the following environment variables:
          ...