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 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213
|
The following are brief installation instructions (from source code) for
Numarray.
Since Numarray uses Python's distutils, this should be a fairly automatic
process.
We are not yet supplying windows binaries so having VC++ available
is a requirement.
We currently use Tim Peters' doctest for regression testing.
==============================================================
1. UNIX: We have tested on several UNIX platforms including:
* Linux-x86 (RedHat 8.0/ gcc-3.2 / Python-2.2.2)
* Solaris-UltraSparc (Solaris 8 / Sun C / Python-2.2.2)
* Tru64-Alpha (OSF1 / v5.1 / DEC C / Python-2.2.2)
Installation ok, works fine.
Issues with over- and underflow in test-suite.
==========================================================================
2. UNIX: Unpack the distribution tarball into a directory:
% gunzip -c numarray-xxx.tar.gz | tar xf -
% cd numarray-xxx
==========================================================================
3. UNIX: Build Numarray using the distutils:
Do a default installation if you can:
% python setup.py config install --gencode
This will try to install numarray in python's site-packages directory.
Since site-packages is already on PYTHONPATH you're ready to selftest.
----- OR ------
For more flexibility (if you need to do a "user" level install):
% python setup.py install --gencode --install-lib=<dir> --install-headers=<dir>/numarray
which will install everything under <dir>/numarray, with the exception of the
file 'numarray.pth' which is stored in <dir>. Since you picked <dir>, you need
to:
setenv PYTHONPATH "<dir>/numarray:$PYTHONPATH"
or:
export PYTHONPATH="<dir>/numarray:$PYTHONPATH"
or:
cp numarray/Doc/sitecustomize.py <dir>
setenv PYTHONPATH <dir>
The latter solution lets you set up <dir> as a user-level site-packages.
See the comments in site-customize.py for more explanation. In short, you
only have to add <dir> to PYTHONPATH to support *multiple* packages located
within <dir>.
----- OR ------
For even more installation pleasure:
% python setup.py config install --gencode --prefix=<desired installation directory>
for Windows and Unix (on Unix the installation will go into:
<installation dir>/lib/python2.x/site-packages/numarray)
----- OR ------
Starting with version 0.41, numarray also supports two step installation:
python setup.py config build --gencode
python setup.py install (--gencode should be omitted!)
----- OR ------
For Unix this form will probably be more convenient:
% python setup.py config install --gencode --home=<personal module directory>
(ends up in the lib/python directory)
Lastly, if you need a hammer, add --force to force setup to install
the files even if it thinks they're already up to date.
Another frequently usefuly technique is to completely delete your *old*
numarray installation prior to installing the *new* one.
To see more distutils options:
% python setup.py --help
For the latest distutils documentation from the Python crew look at:
http://python.sourceforge.net/devel-docs/inst/inst.html
==============================================================
5. UNIX: Self-test Numarray:
[jmiller@halloween ~/numarray-0.6]$ python
Python 2.3 (#3, Jul 30 2003, 13:30:29)
[GCC 3.2 20020903 (Red Hat Linux 8.0 3.2-7)] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import numarray.testall as testall
>>> testall.test()
numarray: ((0, 1123), (0, 1123))
numarray.records: (0, 48)
numarray.strings: (0, 166)
numarray.memmap: (0, 75)
numarray.objects: (0, 72)
numarray.examples.convolve: ((0, 20), (0, 20), (0, 20), (0, 20))
numarray.convolve: (0, 42)
numarray.fft: (0, 75)
numarray.linear_algebra: (0, 46)
numarray.image: (0, 2)
numarray.image.combine: (0, 15)
numarray.random_array: (0, 53)
numarray.ma: (0, 671)
The numbers (tuples) in the results represent the number of errors and
number of tests executed for each numarray module, e.g.. there were zero
errors detected in 1123 tests of numarray. The number of test cases is
likely to change in the future, so don't be alarmed if your counts
don't match exactly. Tuples of tuples indicate multiple passes of the
same basic test, for various reasons.
==============================================================
Win-32: (Installation from source)
==============================================================
0. Win-32: To install numarray, you need to be in the Administrator
account. As a general rule, always remove (or hide) any old version
of numarray before installing the next version.
1. Win-32: We have tested Numarrray on several Win-32 platforms including:
Windows-XP-Pro-x86 ( MSVC-6.0)
Windows-XP-Home-x86 ( MSVC-6.0)
Windows-NT-x86 ( MSVC-6.0)
Windows-98-x86 ( MSVC-6.0)
2. Win-32: First, unpack the distribution:
(NOTE: You may have to download an "unzipping" utility)
C:\> unzip numarray.zip
C:\> cd numarray
3. Win-32: Build it using the distutils defaults:
C:\numarray> python setup.py install --gencode
This installs numarray in C:\pythonXX where XX is the version number of
your python installation, e.g. 20, 21, etc.
4. Win-32: Once you have installed numarray, test it with:
C:\numarray> python
Python 2.3 (#3, Jul 30 2003, 13:30:29) [MSC 32 bit (Intel)] on win32
Type "copyright", "credits" or "license" for more information.
>>> import numarray.testall as testall
>>> testall.test()
numarray: ((0, 1123), (0, 1123))
records: (0, 48)
strings: (0, 166)
memmap: (0, 75)
objects: (0, 72)
numarray.examples.convolve: ((0, 20), (0, 20), (0, 20), (0, 20))
numarray.convolve: (0, 42)
numarray.fft: (0, 75)
numarray.linear_algebra: (0, 46)
numarray.image: (0, 2)
numarray.image.combine: (0, 15)
numarray.random_array: (0, 53)
numarray.ma: (0, 671)
The numbers (tuples) in the results represent the number of errors and
number of tests executed for each numarray module, e.g.. there were zero
errors detected in 1123 tests of numarray. The number of test cases is
likely to change in the future, so don't be alarmed if your counts
don't match exactly. Tuples of tuples indicate multiple passes of the
same basic test, for various reasons.
==============================================================
Win-32: (Installation from self-installing executable)
==============================================================
0. Win-32: To install numarray, you need to be in the Administrator
account. As a general rule, always remove (or hide) any old version
of numarray before installing the next version.
1. Click on the executable's icon to run the installer.
2. Click "next" several times. I have not experimented with
customizing the installation directory and don't recommend changing
any of the installation defaults. If you do and have problems, let me
(jmiller@stsci.edu) know.
3. Assuming everything else goes smoothly, click "finish".
4. Test numarray as above in Win-32: (Installation from Source)
==============================================================
Special Notes:
==============================================================
1. i386 linux -- if compiling against GNU libc on i386 and enabling
SSE processor functions (with something like "-march=athlon-xp" or
using other libraries that utilize SSE such as atlas or Intel IPP)
then libc version 2.3.3 or above will be needed.
|