File: INSTALL.txt

package info (click to toggle)
python-numarray 1.5.2-4
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 8,668 kB
  • ctags: 11,384
  • sloc: ansic: 113,864; python: 22,422; makefile: 197; sh: 11
file content (213 lines) | stat: -rw-r--r-- 8,003 bytes parent folder | download | duplicates (2)
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.