Skip to main content

np = numpy++: numpy with added convenience functionality

Project description

np – create numpy arrays as np[1,3,5], and more

np = numpy + handy tools

For the numerical Python package numpy itself, see http://www.numpy.org/.

The idea of np is to provide a way of creating numpy arrays with a compact syntax and without an explicit function call. Making the module name np subscriptable, while still keeping it essentially an alias for numpy, does this in a clean way.

Any feedback or suggestions are very welcome: koos.zevenhoven@aalto.fi.

Getting Started

Requirements

  • Python 3+ (Probably works with older versions too)

  • numpy

Installation

np can be installed with pip:

$ pip install np

or directly from the source code:

$ git clone https://github.com/k7hoven/np.git
$ cd np
$ python setup.py install

Basic Usage

A popular style of using numpy has been to import it as np:

>>> import numpy as np
>>> my_array = np.array([[1, 2], [3, 4]])
>>> column_vector = np.array([[1, 2, 3]]).T

The most important feature of np is to make the creation of arrays less verbose, while everything else works as before. The above code becomes:

>>> import np
>>> my_array = np[[1, 2], [3, 4]]
>>> column_vector = np[[1, 2, 3]].T

As you can see from the above example, you can create numpy arrays by subscripting the np module. Since most people would have numpy imported as np anyway, this requires no additional names to clutter the namespace. Also, the syntax np[1,2,3] resembles the syntax for bytes literals, b"asd".

The np package also provides a convenient way of ensuring something is a numpy array, that is, a shortcut to numpy.asanyarray():

>>> import np
>>> mylist = [1, 3, 5]
>>> mylist + [7, 9, 11]
[1, 3, 5, 7, 9, 11]
>>> np(mylist) + [7, 9, 11]
array([8, 12, 16])

Changelog

0.1.4 (2016-01-26)

  • Bug fix

0.1.2 (2015-06-17)

  • Improved experimental dtype shortcuts: np.f[1,2], np.i32[1,2], etc.

0.1.1 (2015-06-17)

  • PyPI-friendly readme

0.1.0 (2015-06-17)

  • First distributable version

  • Easy arrays such as np[[1,2],[3,4]]

  • Shortcut for np.asanyarray(obj): np(obj)

  • Experimental dtype shortcuts: np.f64[[1,2],[3,4]]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

np-0.1.4.tar.gz (4.0 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page