In this tutorial, I’ll explain how to use the Numpy absolute value function, which is also known as np.abs or np.absolute.

Ultimately, you’ll learn how to compute absolute values with Numpy.

We’ll start with a brief overview of the function, and then work with some examples.

I recommend that you read the whole tutorial, but if you’re looking for something specific, you can click on any of the following links to navigate to a specific section.

Table of Contents:

Let’s start with a quick overview of what Numpy absolute value does.

A Quick Introduction to Numpy Absolute Value

Numpy absolute value calculates absolute values in Python.

It can do this with single values, but it can also operate on Numpy arrays.

Let’s quickly review what Numpy arrays are, just for context.

A Quick Review of Numpy

A Numpy array is a data structure in Python that contains numeric data.

These arrays can be 1 dimensional, like this:

An image of a 1D Numpy array.

Or they can be two dimensional:

An example of a 2d Numpy array

Numpy arrays can also be multi-dimensional.

We can create Numpy arrays using a variety of techniques, like numpy zeros, Numpy empty, Numpy randint, numpy arange, and other techniques.

We often use Numpy arrays for anything involving computations involving strictly numeric data, like scientific computing and some forms of machine learning.

(For a more complete explanation, see our tutorial on Numpy arrays.)

The np.abs function calculates absolute values

So what does Numpy absolute value do?

Put simply, Numpy absolute value calculates the absolute value of the values in a Numpy array.

So let’s say we have some numbers in an array, some negative and some positive.

If we apply Numpy absolute value, it will calculate the absolute value of every value in the array. The output of the function will be a new array with the absolute values.

A simple example of Numpy Absolute Value, operating on a 1D Numpy array.

It’s actually a very simple function, much like the other mathematical functions in Numpy like Numpy power, Numpy exponential, and Numpy log.

The syntax of Numpy Absolute Value

So now that you’ve learned about what Numpy absolute value does, let’s take a look at the syntax.

The syntax is actually very simple, but before we get into the syntax, there’s an important thing that I need to point out.

A quick note

Whenever we use Numpy, we need to import the module.

How we import the module will have an impact on the syntax, so I need to specify how we will import it.

The common way of importing Numpy is with the following code:

import numpy as np

When we import Numpy with the alias np, we can use this prefix when we call our Numpy functions like Numpy absolute value.

This is by far the most common way to import Numpy, and it’s the syntactical convention that we’ll be using going forward.

np.abs syntax

The syntax of Numpy absolute value is extremely simple. It’s possibly one of the most simple Numpy functions.

We can call the function as np.abs(). As noted above, this assumes that we’ve imported Numpy as np.

A visual explanation of the syntax of np.abs (AKA, Numpy absolute value).

Alternatively, we can call the function as np.absolute(). The functions np.absolute() and np.abs() are essentially the same. The np.abs() function is essentially a shorthand version np.absolute(). You can choose which ever one you like.

Inside of the function, we need to provide an input on which to operate.

Let’s quickly talk about that.

The parameters of np.abs

The numpy.abs function really only has one commonly used argument, the x argument.

x (required)

The x argument enables us to specify the input array.

The argument that we provide here can be a Numpy array, but also an array-like object, such as a Python list.

Keep in mind that you are required to provide something here. You need to provide some type of input.

Also note that you do not use x this explicitly as a parameter.

What I mean is that you do not explicitly include x in your syntax; the code np.abs(x = myarray) will produce an error. It is implied that any input you provide to the function will serve as an argument to the x parameter.

Other parameters of np.absolute

The np.absolute function does have some other parameters, including:

  • out
  • where

These parameters are somewhat uncommonly used, so we will not discuss them in this tutorial.

Examples of how to use Numpy Absolute Value

Okay. Now that we’ve looked at the syntax, let’s take a look at some examples.

Examples:

Run this code first

Before you run any of the examples below, you’ll need to import Numpy properly.

You can use the following code to import Numpy:

import numpy as np

This will enable us to use the alias “np” in our code for the Numpy module.

EXAMPLE 1: Calculate absolute values for a single value

Ok, let’s start with a very simple example.

Here, we’re going to compute the absolute value of a single number.

np.abs(-5)

OUT:

5
Explanation:

This is extremely simple.

Here, the input to the Numpy absolute value function is a negative number, -5. When we provide this value as the argument to the function, np.abs() simply computes the absolute value, which is 5.

To be clear, you could also run this code as np.absolute(-5). It’s effectively the same as np.abs(-5).

Example 2: Calculate absolute values for a 1D array

Next, we’ll do a slightly more complicated example.

Here, we’ll compute the absolute values of an array of values.

To do this, we first need to create an array, and then we can use np.abs() on that array.

Create 1D array

First, we’ll create a 1-dimensional array that contains the values from -2 to 2.

To do this, we’ll use the Numpy arange function.

array_1D = np.arange(start = -2, stop = 3)

And we can print it out to see the values.

print(array_1D)

OUT:

[-2 -1  0  1  2]

Obviously, this array contains two negative values.

Apply np.abs

Next, we’ll apply the np.abs() function to compute the absolute values.

np.abs(array_1D)

OUT:

array([2, 1, 0, 1, 2])

When we use np.abs() on the array array_1D, it computes the absolute value of every value in the array.

The output is a new array that contains those absolute values.

EXAMPLE 3: Use Numpy Absolute value on a 2D array

Finally, let’s use Numpy absolute value on a 2-dimensional array.

This is very similar to example 2, where we operated on a 1D array.

Create 2D array

First, we’ll create a 2-dimensional array with the Numpy arrange function, and the Numpy reshape method:

array_2D = np.arange(start = -4, stop = 5).reshape((3,3))

And let’s print it out:

print(array_2D)

OUT:

[[-4 -3 -2]
 [-1  0  1]
 [ 2  3  4]]

This is a simple 2D array that contains the values from -4 to 4, arranged in a 3 by 3 shape.

Apply np.abs

Next, we can apply np.abs to the 2D array.

np.abs(array_2D)

OUT:

array([[4, 3, 2],
       [1, 0, 1],
       [2, 3, 4]])
Explanation

This is really simple.

The numpy absolute value function simply operates on every element of the 2D array, element wise.

The output is a new Numpy array that has the same shape. The values of the new Numpy are the absolute values of the values of the input array.

Frequently asked questions about np absolute value

Now that we’ve looked at a few examples, let me answer a common question about np absolute value.

Frequently asked questions:

Should I use np.abs or np.absolute

The most common question about Numpy absolute value is whether you should use np.abs() or np.absolute().

The short answer is: it doesn’t matter.

np.abs() is a shorthand version of np.absolute(). They are effectively the same function, and work the same way.

Pick one version, and move on.

Leave your other questions in the comments below

Do you have other questions about Numpy absolute value?

Leave your questions in the comments section at the bottom of the page.

Join our course to learn more about Numpy

The examples you’ve seen in this tutorial should be enough to get you started, but if you’re serious about learning Numpy, you should enroll in our premium course called Numpy Mastery.

There’s a lot more to learn about Numpy, and Numpy Mastery will teach you everything, including:

  • How to create Numpy arrays
  • How to use the Numpy random functions
  • What the “Numpy random seed” function does
  • How to reshape, split, and combine your Numpy arrays
  • How to perform mathematical operations on Numpy arrays
  • and more …

Moreover, it will help you completely master the syntax within a few weeks. You’ll discover how to become “fluent” in writing Numpy code.

Find out more here:

Learn More About Numpy Mastery