blob: b4c4b4e8cd08573e084108e3e639e3fe4be34fcf (
plain)
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
|
__doc__ = """Defines a multi-dimensional array and useful procedures for Numerical computation.
Functions
- array - NumPy Array construction
- zeros - Return an array of all zeros
- empty - Return an unitialized array
- shape - Return shape of sequence or array
- rank - Return number of dimensions
- size - Return number of elements in entire array or a
certain dimension
- fromstring - Construct array from (byte) string
- take - Select sub-arrays using sequence of indices
- put - Set sub-arrays using sequence of 1-D indices
- putmask - Set portion of arrays using a mask
- reshape - Return array with new shape
- repeat - Repeat elements of array
- choose - Construct new array from indexed array tuple
- cross_correlate - Correlate two 1-d arrays
- searchsorted - Search for element in 1-d array
- sum - Total sum over a specified dimension
- average - Average, possibly weighted, over axis or array.
- cumsum - Cumulative sum over a specified dimension
- product - Total product over a specified dimension
- cumproduct - Cumulative product over a specified dimension
- alltrue - Logical and over an entire axis
- sometrue - Logical or over an entire axis
- allclose - Tests if sequences are essentially equal
More Functions:
- arrayrange (arange) - Return regularly spaced array
- asarray - Guarantee NumPy array
- sarray - Guarantee a NumPy array that keeps precision
- convolve - Convolve two 1-d arrays
- swapaxes - Exchange axes
- concatenate - Join arrays together
- transpose - Permute axes
- sort - Sort elements of array
- argsort - Indices of sorted array
- argmax - Index of largest value
- argmin - Index of smallest value
- innerproduct - Innerproduct of two arrays
- dot - Dot product (matrix multiplication)
- outerproduct - Outerproduct of two arrays
- resize - Return array with arbitrary new shape
- indices - Tuple of indices
- fromfunction - Construct array from universal function
- diagonal - Return diagonal array
- trace - Trace of array
- dump - Dump array to file object (pickle)
- dumps - Return pickled string representing data
- load - Return array stored in file object
- loads - Return array from pickled string
- ravel - Return array as 1-D
- nonzero - Indices of nonzero elements for 1-D array
- shape - Shape of array
- where - Construct array from binary result
- compress - Elements of array where condition is true
- clip - Clip array between two values
- ones - Array of all ones
- identity - 2-D identity array (matrix)
(Universal) Math Functions
add logical_or exp
subtract logical_xor log
multiply logical_not log10
divide maximum sin
divide_safe minimum sinh
conjugate bitwise_and sqrt
power bitwise_or tan
absolute bitwise_xor tanh
negative invert ceil
greater left_shift fabs
greater_equal right_shift floor
less arccos arctan2
less_equal arcsin fmod
equal arctan hypot
not_equal cos around
logical_and cosh sign
arccosh arcsinh arctanh
"""
__doc__ += \
""" Basic functions used by several sub-packages and useful to have in the
main name-space
Type handling
==============
iscomplexobj -- Test for complex object, scalar result
isrealobj -- Test for real object, scalar result
iscomplex -- Test for complex elements, array result
isreal -- Test for real elements, array result
imag -- Imaginary part
real -- Real part
real_if_close -- Turns complex number with tiny imaginary part to real
isneginf -- Tests for negative infinity ---|
isposinf -- Tests for positive infinity |
isnan -- Tests for nans |---- array results
isinf -- Tests for infinity |
isfinite -- Tests for finite numbers ---|
isscalar -- True if argument is a scalar
nan_to_num -- Replaces NaN's with 0 and infinities with large numbers
cast -- Dictionary of functions to force cast to each type
common_type -- Determine the 'minimum common type code' for a group
of arrays
mintypecode -- Return minimal allowed common typecode.
Index tricks
==================
mgrid -- Method which allows easy construction of N-d 'mesh-grids'
r_ -- Append and construct arrays: turns slice objects into
ranges and concatenates them, for 2d arrays appends
rows.
index_exp -- Konrad Hinsen's index_expression class instance which
can be useful for building complicated slicing syntax.
Useful functions
==================
select -- Extension of where to multiple conditions and choices
extract -- Extract 1d array from flattened array according to mask
insert -- Insert 1d array of values into Nd array according to mask
linspace -- Evenly spaced samples in linear space
logspace -- Evenly spaced samples in logarithmic space
fix -- Round x to nearest integer towards zero
mod -- Modulo mod(x,y) = x % y except keeps sign of y
amax -- Array maximum along axis
amin -- Array minimum along axis
ptp -- Array max-min along axis
cumsum -- Cumulative sum along axis
prod -- Product of elements along axis
cumprod -- Cumluative product along axis
diff -- Discrete differences along axis
angle -- Returns angle of complex argument
unwrap -- Unwrap phase along given axis (1-d algorithm)
sort_complex -- Sort a complex-array (based on real, then imaginary)
trim_zeros -- trim the leading and trailing zeros from 1D array.
vectorize -- a class that wraps a Python function taking scalar
arguments into a generalized function which
can handle arrays of arguments using the broadcast
rules of numerix Python.
alter_numeric -- enhance numeric array behavior
restore_numeric -- restore alterations done by alter_numeric
Shape manipulation
===================
squeeze -- Return a with length-one dimensions removed.
atleast_1d -- Force arrays to be > 1D
atleast_2d -- Force arrays to be > 2D
atleast_3d -- Force arrays to be > 3D
vstack -- Stack arrays vertically (row on row)
hstack -- Stack arrays horizontally (column on column)
column_stack -- Stack 1D arrays as columns into 2D array
dstack -- Stack arrays depthwise (along third dimension)
split -- Divide array into a list of sub-arrays
hsplit -- Split into columns
vsplit -- Split into rows
dsplit -- Split along third dimension
Matrix (2d array) manipluations
===============================
fliplr -- 2D array with columns flipped
flipud -- 2D array with rows flipped
rot90 -- Rotate a 2D array a multiple of 90 degrees
eye -- Return a 2D array with ones down a given diagonal
diag -- Construct a 2D array from a vector, or return a given
diagonal from a 2D array.
mat -- Construct a Matrix
bmat -- Build a Matrix from blocks
Polynomials
============
poly1d -- A one-dimensional polynomial class
poly -- Return polynomial coefficients from roots
roots -- Find roots of polynomial given coefficients
polyint -- Integrate polynomial
polyder -- Differentiate polynomial
polyadd -- Add polynomials
polysub -- Substract polynomials
polymul -- Multiply polynomials
polydiv -- Divide polynomials
polyval -- Evaluate polynomial at given argument
Import tricks
=============
ppimport -- Postpone module import until trying to use it
ppimport_attr -- Postpone module import until trying to use its
attribute
ppresolve -- Import postponed module and return it.
Machine arithmetics
===================
machar_single -- MachAr instance storing the parameters of system
single precision floating point arithmetics
machar_double -- MachAr instance storing the parameters of system
double precision floating point arithmetics
Threading tricks
================
ParallelExec -- Execute commands in parallel thread.
"""
depends = ['testing']
global_symbols = ['*']
|
