summaryrefslogtreecommitdiff
path: root/doc/source/about.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/source/about.rst')
-rw-r--r--doc/source/about.rst66
1 files changed, 66 insertions, 0 deletions
diff --git a/doc/source/about.rst b/doc/source/about.rst
new file mode 100644
index 000000000..6bbb2d186
--- /dev/null
+++ b/doc/source/about.rst
@@ -0,0 +1,66 @@
+About NumPy
+===========
+
+`NumPy <http://www.scipy.org/NumpPy/>`__ is the fundamental package
+needed for scientific computing with Python. This package contains:
+
+- a powerful N-dimensional :ref:`array object <arrays>`
+- sophisticated :ref:`(broadcasting) functions <ufuncs>`
+- basic :ref:`linear algebra functions <routines.linalg>`
+- basic :ref:`Fourier transforms <routines.fft>`
+- sophisticated :ref:`random number capabilities <routines.random>`
+- tools for integrating Fortran code
+- tools for integrating C/C++ code
+
+Besides its obvious scientific uses, *NumPy* can also be used as an
+efficient multi-dimensional container of generic data. Arbitrary
+data-types can be defined. This allows *NumPy* to seamlessly and
+speedily integrate with a wide-variety of databases.
+
+NumPy is a successor for two earlier scientific Python libraries:
+NumPy derives from the old *Numeric* code base and can be used
+as a replacement for *Numeric*. It also adds the features introduced
+by *Numarray* and can also be used to replace *Numarray*.
+
+NumPy community
+---------------
+
+Numpy is a distributed, volunteer open-source project. *You* can help
+us make it better; if you believe something should be improved either
+in functionality or in documentation, don't hesitate to contact us --- or
+even better, contact us and participate in fixing the problem.
+
+Our main means of communication are:
+
+- `scipy.org website <http://scipy.org/>`__
+
+- `Mailing lists <http://scipy.org/Mailing_Lists>`__
+
+- `Numpy Trac <http://projects.scipy.org/scipy/numpy>`__ (bug "tickets" go here)
+
+More information about the development of Numpy can be found at
+http://scipy.org/Developer_Zone
+
+If you want to fix issues in this documentation, the easiest way
+is to participate in `our ongoing documentation marathon
+<http://scipy.org/Developer_Zone/DocMarathon2008>`__.
+
+
+About this documentation
+========================
+
+Conventions
+-----------
+
+Names of classes, objects, constants, etc. are given in **boldface** font.
+Often they are also links to a more detailed documentation of the
+referred object.
+
+This manual contains many examples of use, usually prefixed with the
+Python prompt ``>>>`` (which is not a part of the example code). The
+examples assume that you have first entered::
+
+>>> import numpy as np
+
+before running the examples.
+