NumPy Reference

NumPy Reference

Release 1.13.0

Written by the NumPy community

June 10, 2017

CONTENTS

1

2

3

Array objects

1.1 The N-dimensional array (ndarray)

1.2 Scalars . . . . . . . . . . . . . . . .

1.3 Data type objects (dtype) . . . . . .

1.4 Indexing . . . . . . . . . . . . . . .

1.5 Iterating Over Arrays . . . . . . . . .

1.6 Standard array subclasses . . . . . .

1.7 Masked arrays . . . . . . . . . . . .

1.8 The Array Interface . . . . . . . . .

1.9 Datetimes and Timedeltas . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

3

.

3

. 47

. 62

. 76

. 84

. 96

. 222

. 370

. 374

Universal functions (ufunc)

2.1 Broadcasting . . . . . . . .

2.2 Output type determination .

2.3 Use of internal buffers . . .

2.4 Error handling . . . . . . .

2.5 Casting Rules . . . . . . . .

2.6 Overriding Ufunc behavior .

2.7 ufunc . . . . . . . . . . .

2.8 Available ufuncs . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

383

383

384

384

384

387

389

389

399

Routines

3.1 Array creation routines . . . . . . . . . . . . . . . . . . . . . . .

3.2 Array manipulation routines . . . . . . . . . . . . . . . . . . . .

3.3 Binary operations . . . . . . . . . . . . . . . . . . . . . . . . . .

3.4 String operations . . . . . . . . . . . . . . . . . . . . . . . . . .

3.5 C-Types Foreign Function Interface (numpy.ctypeslib) . . .

3.6 Datetime Support Functions . . . . . . . . . . . . . . . . . . . .

3.7 Data type routines . . . . . . . . . . . . . . . . . . . . . . . . .

3.8 Optionally Scipy-accelerated routines (numpy.dual) . . . . . .

3.9 Mathematical functions with automatic domain (numpy.emath)

3.10 Floating point error handling . . . . . . . . . . . . . . . . . . . .

3.11 Discrete Fourier Transform (numpy.fft) . . . . . . . . . . . .

3.12 Financial functions . . . . . . . . . . . . . . . . . . . . . . . . .

3.13 Functional programming . . . . . . . . . . . . . . . . . . . . . .

3.14 NumPy-specific help functions . . . . . . . . . . . . . . . . . . .

3.15 Indexing routines . . . . . . . . . . . . . . . . . . . . . . . . . .

3.16 Input and output . . . . . . . . . . . . . . . . . . . . . . . . . .

3.17 Linear algebra (numpy.linalg) . . . . . . . . . . . . . . . .

3.18 Logic functions . . . . . . . . . . . . . . . . . . . . . . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

405

405

443

485

494

543

545

551

565

566

567

571

595

605

612

614

649

670

710

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

i

3.19

3.20

3.21

3.22

3.23

3.24

3.25

3.26

3.27

3.28

3.29

Mathematical functions . . . . . . . .

Matrix library (numpy.matlib) . . .

Miscellaneous routines . . . . . . . . .

Padding Arrays . . . . . . . . . . . . .

Polynomials . . . . . . . . . . . . . .

Random sampling (numpy.random)

Set routines . . . . . . . . . . . . . . .

Sorting, searching, and counting . . . .

Statistics . . . . . . . . . . . . . . . .

Test Support (numpy.testing) . . .

Window functions . . . . . . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

732

823

829

833

836

1018

1124

1129

1144

1180

1194

4

Packaging (numpy.distutils)

1203

4.1 Modules in numpy.distutils . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1203

4.2 Building Installable C libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1214

4.3 Conversion of .src files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1215

5

NumPy C-API

5.1 Python Types and C-Structures . .

5.2 System configuration . . . . . . . .

5.3 Data Type API . . . . . . . . . . .

5.4 Array API . . . . . . . . . . . . .

5.5 Array Iterator API . . . . . . . . .

5.6 UFunc API . . . . . . . . . . . . .

5.7 Generalized Universal Function API

5.8 NumPy core libraries . . . . . . . .

5.9 C API Deprecations . . . . . . . .

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

.

1217

1217

1231

1233

1238

1278

1295

1300

1303

1308

6

NumPy internals

1311

6.1 NumPy C Code Explanations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1311

6.2 Internal organization of numpy arrays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1318

6.3 Multidimensional Array Indexing Order Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1318

7

NumPy and SWIG

1321

7.1 Testing the numpy.i Typemaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1336

8

Acknowledgements

1341

Bibliography

1343

Index

1353

ii

NumPy Reference, Release 1.13.0

Release

1.13

Date

June 10, 2017

This reference manual details functions, modules, and objects included in NumPy, describing what they are and what

they do. For learning how to use NumPy, see also user.

CONTENTS

1

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download