mirror of
https://github.com/boostorg/python.git
synced 2026-01-19 04:22:16 +00:00
Update README and convert it to Markdown.
This commit is contained in:
@@ -1,3 +1,5 @@
|
||||
# Boost.NumPy
|
||||
|
||||
Boost.NumPy is an extension for Boost.Python that adds NumPy support.
|
||||
|
||||
It is intended as a replacement for the old numeric support in
|
||||
@@ -10,33 +12,34 @@ consider it a C++ NumPy API, with the intent of making the NumPy C-API
|
||||
available in a form that is safer and more convenient for C++ users
|
||||
(and particularly those using Boost.Python, of course).
|
||||
|
||||
THIS IS NOT AN OFFICIAL BOOST LIBRARY
|
||||
*THIS IS NOT AN OFFICIAL BOOST LIBRARY*
|
||||
|
||||
...we're just calling it Boost.NumPy right now because that clearly
|
||||
indicates that it's for Boost.Python and NumPy. We do intend to
|
||||
propose it for inclusion in Boost eventually.
|
||||
indicates that it's for Boost.Python and NumPy. We may
|
||||
propose it for inclusion in Boost eventually, but that's not high
|
||||
on the priority list for any of the original authors.
|
||||
|
||||
|
||||
INSTALLATION
|
||||
## INSTALLATION
|
||||
|
||||
We have provided three build systems: Boost.Build, SCons, and CMake
|
||||
build system. At the moment, we recommend using SCons or CMake on
|
||||
Linux and CMake on Windows.
|
||||
|
||||
Building with SCons should be as simple as running "scons" and "scons
|
||||
install", but you may need to use the "--with-boost*" options (see
|
||||
"scons --help") to specify where to find Boost. The Python that is
|
||||
Building with SCons should be as simple as running `scons` and `scons
|
||||
install`, but you may need to use the `--with-boost*` options (see
|
||||
`scons --help`) to specify where to find Boost. The Python that is
|
||||
used by SCons will be the one built against. Additionally, the
|
||||
SConsChecks submodule must be initialized by git before building
|
||||
by running
|
||||
|
||||
git submodule update --init
|
||||
|
||||
Please see libs/numpy/doc/cmakeBuild.rst for more information on
|
||||
Please see `libs/numpy/doc/cmakeBuild.rst` for more information on
|
||||
building with CMake.
|
||||
|
||||
|
||||
DOCUMENTATION
|
||||
## DOCUMENTATION
|
||||
|
||||
More documentation on how to use the library can be found in
|
||||
libs/numpy/doc, but it may be most useful to start with the
|
||||
@@ -44,36 +47,34 @@ examples in libs/numpy/examples. The headers files are also
|
||||
well documented and are intended to serve as a reference.
|
||||
|
||||
|
||||
ISSUES AND NEW FEATURES
|
||||
## ISSUES AND NEW FEATURES
|
||||
|
||||
Please create an issue on the GitHub site at:
|
||||
|
||||
https://github.com/ndarray/Boost.NumPy/issues
|
||||
|
||||
Patches and detailed debugging are greatly appreciated; the authors don't have much time to devote to this project on a regular basis, but we do try to fix critical bugs.
|
||||
|
||||
CONTACT
|
||||
|
||||
Please send email questions to:
|
||||
## CONTACT
|
||||
|
||||
ndarray-dev@googlegroups.com
|
||||
|
||||
...but I would prefer bug reports and feature requests to go to
|
||||
Please post questions, bug reports, and feature requests to
|
||||
the GitHub issues list (see above).
|
||||
|
||||
|
||||
MULTI-PLATFORM SUPPORT
|
||||
## MULTI-PLATFORM SUPPORT
|
||||
|
||||
The vast majority of development has happened on Linux/g++, and while
|
||||
we have taken some steps to support MacOS/clang, there hasn't been
|
||||
much testing. There has been no testing on Windows, though we have
|
||||
no reason to believe anything we've done won't work on Windows.
|
||||
much testing. There has been very little testing on Windows, though there
|
||||
has been some work contributed to get it working there.
|
||||
|
||||
In short, we'd really love to have some testing on additional platforms,
|
||||
especially from people who know their way around SCons, NumPy, or
|
||||
Boost.Python.
|
||||
|
||||
|
||||
HISTORY/AUTHORS
|
||||
## HISTORY/AUTHORS
|
||||
|
||||
Boost.NumPy was originally written by Jim Bosch as part of the
|
||||
"ndarray" C++ library, then reorganized into a standalone component,
|
||||
@@ -81,10 +82,10 @@ cleaned up, and documented as part of a Boost-sponsored
|
||||
Google Summer of Code by Ankit Daftery, mentored by Stefan Seefeld.
|
||||
Philip Miller contributed the CMake build system.
|
||||
|
||||
The project is hosted both on the Boost Sandbox:
|
||||
An older version of this project is hosted on the Boost Sandbox:
|
||||
|
||||
https://svn.boost.org/svn/boost/sandbox/numpy
|
||||
|
||||
and on GitHub:
|
||||
but the latest version is on GitHub:
|
||||
|
||||
https://github.com/ndarray/Boost.NumPy
|
||||
Reference in New Issue
Block a user