-
Notifications
You must be signed in to change notification settings - Fork 26
/
Copy pathINSTALLATION.txt
77 lines (56 loc) · 3.03 KB
/
INSTALLATION.txt
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
To install:
1. Use 'make install' to install in the system library (or use
'make install-user' to install in user's library.) Python modules
numpy and gvar are installed automatically if not present.
N.B. Rather than using make and the makefile, one can instead use
standard python installation tools: run 'pip install .' to install
to the system library (or 'pip install . --user' to install to
the user's directory) from within the top directory.
N.B. If you have previously installed older versions of vegas,
consider removing the earlier modules to make sure that the new ones are
used by Python. This will not be a problem if the new modules overwrite
the older ones, but could cause trouble if the new modules are written
to a different place. Find out where the older modules are stored by
using 'pydoc vegas' before installing the new software
(pydoc lists the location of the module under "FILE").
N.B. vegas uses cython to convert .pyx files to .c files. The .c files
are included in the distribution so cython is not required to install
gvar. To force regeneration of the .c files set USE_CYTHON=True in
setup.py.
Install Python matplotlib if you want to make pictures of the
vegas grid. Install mpi4py (and MPI itself) for multi-processor
evaluation of integrands. Neither of these packages is installed
automatically.
pip is used for installing (and uninstalling) vegas. pip usually
comes with python.
The vegas code works for Python 3.3-3.9. It mostly works for
Python 2.7 as well but that version is no longer officially
supported.
2. (Optional) Run 'make tests' to test your installation of vegas.
The tests have been successful if the output ends with "OK".
Some tests involve random numbers and so may occasionally --- less than
1 in 100 runs --- fail due to rare multi-sigma fluctuations; rerun the
tests if they do fail. Contact [email protected] if there are
persistent, frequent failures.
N.B. The tests can also be run directly using Python's unittest module:
"python -m unittest discover".
4. (Optional) Change to subdirectory examples/ and look at some of the
sample .py files given there that use vegas. Run them one by one ---
"python simple.py" etc --- or all at once using "make run".
5. (Optional) Use 'make clean' to erase work files/directories.
To uninstall:
1. 'make uninstall' uninstalls what was installed. It uses pip uninstall.
Problems:
Contact Peter Lepage: [email protected]
# Created by G. Peter Lepage (Cornell University) in 12/2013.
# Copyright (c) 2013-23 G. Peter Lepage.
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# any later version (see <http://www.gnu.org/licenses/>).
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.