How NumPy Read CSV Files in Python

Data science and analysis use CSV files to store and exchange tabular data. Data manipulation languages like Python offer libraries and tools for working with NumPy read CSV files. NumPy is one of the most potent libraries in this field. This article will explore the world of reading and writing CSV files using NumPy, exploring its features, options, and practical examples.

Introduction to CSV Files

CSV files are an excellent choice for sharing structured data between applications, databases, and platforms. CSV files are lightweight and widely used. Lines represent records, and commas separate values. Delimitation can also done with tabs, semicolons, or anything else.

Despite their simplicity, numpy read csv files have challenges. Handling delimiters and headers and managing different data types is essential when reading and writing CSV files. It is here that NumPy comes in.

NumPy for Data Science

NumPy is a big deal for numerical and scientific computing in the Python ecosystem. These data structures are arrays, matrices, and mathematical functions. Data scientists and analysts need NumPy arrays to handle large amounts of data because they are more efficient than Python lists.

NumPy’s capabilities extend beyond numerical computations. It also offers functions to handle structured data, making it a natural fit for working with CSV files.

Reading CSV Files with NumPy

The numpy.loadtxt() function is versatile for reading data from text files, including CSV files. This function provides numerous parameters to customize how the data load. Let us explore some of the critical parameters:

  • delimiter: Specifies the character that separates values. By default, it assumes the delimiter is a space.
  • dtype: Specifies the data type of the resulting array. If not specified, NumPy will attempt to infer the data type.
  • skiprows: Allows skipping a specific number of rows at the beginning of the file.
  • comments: Specifies the character(s) that indicate comments in the file. Lines starting with this character ignore.
  • skip_header: Skips the first row, assuming it contains the header.
  • usecols: Specifies the columns to be loaded from the file.
  • converters: A dictionary of functions to apply to specific columns for custom data conversion.
  • encoding: Specifies the file’s character encoding.

An example using numpy.loadtxt():

import numpy as np

data = np.loadtxt('data.csv', delimiter=',', skiprows=1, dtype=int)

This example shows that the data is loaded from a CSV file named ‘data.csv’, the first row (which contains headers) skip, and the values are specified as integers.

Writing CSV Files with NumPy

NumPy also provides a way to write NumPy arrays into CSV files using the numpy.savetxt() function. This function controls various parameters, such as the delimiter, header, and formatting options.

Here are some essential parameters for the numpy.savetxt() function:

  • fname: Specifies the file name to write the data to.
  • delimiter: Specifies the character to be used as the delimiter.
  • header: A string that written at the beginning of the file as a header.
  • fmt: A format string determining how the data will be formatted in the output file.

Let us see an example of writing a NumPy array to a CSV file:

import numpy as np

data = np.array([[1, 2, 3],
                 [4, 5, 6],
                 [7, 8, 9]])

header = "Column 1,Column 2,Column 3"
np.savetxt('output.csv', data, delimiter=',', header=header, fmt='%d', comments='')

An array is created in NumPy and saved to ‘output.csv’ with a specified header and formatting.

Practical Examples

Example 1: Reading and Manipulating CSV Data

Consider a scenario with a CSV file named ‘sales.csv’ containing sales data for different products. Each row has the product name, units sold, and revenue. We want to read this data and perform some analysis:

import numpy as np

# Reading CSV file
data = np.loadtxt('sales.csv', delimiter=',', skiprows=1, dtype={'names': ('product', 'units', 'revenue'),
                                                                'formats': ('U20', int, float)})

# Calculating total revenue
total_revenue = np.sum(data['revenue'])
print("Total Revenue:", total_revenue)

# Finding the product with the highest sales
max_units_index = np.argmax(data['units'])
max_selling_product = data['product'][max_units_index]
print("Best Selling Product:", max_selling_product)

Example 2: Writing Processed Data to CSV

Hence Continuing from the previous example, suppose we want to write the processed data (including the total revenue and best-selling product) to a new CSV file ‘analysis_results.csv’:

import numpy as np

# Processed data
total_revenue = 123456
best_selling_product = "Product XYZ"

# Creating an array
analysis_data = np.array([[total_revenue, best_selling_product]])

# Writing to CSV
header = "Total Revenue,Best Selling Product"
np.savetxt('analysis_results.csv', analysis_data, delimiter=',', header=header, fmt='%s', comments='')

Real-World Application: Stock Market Analysis

To showcase the practicality of NumPy’s CSV handling capabilities, let us dive into a real-world application: stock market analysis. Suppose we have a CSV file containing historical stock price data for a particular company. We want to calculate the average closing price over a specific period and identify days when the stock price experienced significant fluctuations.

Here is how we can achieve this using NumPy:

import numpy as np

# Reading stock price data from CSV
data = np.loadtxt('stock_data.csv', delimiter=',', skiprows=1, dtype={'names': ('date', 'open', 'high', 'low', 'close'),
                                                                     'formats': ('U20', float, float, float, float)})

# Extracting closing prices
closing_prices = data['close']

# Calculating the average closing price
average_closing_price = np.mean(closing_prices)
print("Average Closing Price:", average_closing_price)

# Finding days with significant price fluctuations
price_fluctuations = data['high'] - data['low']
volatile_days = data['date'][price_fluctuations > average_closing_price * 0.1]
print("Volatile Days:", volatile_days)

Table 1: Key Parameters for numpy.loadtxt()

delimiterCharacter used to separate values
dtypeA character used to separate values
skip rowsNumber of rows to skip at the beginning
commentsCharacters indicating comments
skip_headerSkip the first row (header)
use colsColumns to be loaded from the file
convertersDictionary of functions for custom data conversion
encodingCharacter encoding of the file

Table 2: Key Parameters for numpy.savetxt()

fnameFile name to write the data to
delimiterCharacter used as the delimiter
headerA character used as the delimiter
fmtFormat string determining data formatting
commentsCharacters indicating comments

These tables provide an overview of the various parameters available for the numpy.loadtxt() and numpy.savetxt() functions, allowing you to efficiently read and write CSV files using NumPy in Python while customizing the behaviour according to your needs.


NumPy’s ability to read csv files offers a powerful toolset for data scientists and analysts working with structured data. Whether you are loading data for analysis or saving results for further use, NumPy’s functions provide the flexibility and customization required for various scenarios. By understanding the parameters and techniques demonstrated in this article, you can efficiently manipulate CSV data using NumPy, contributing to more effective data-driven decisions in your projects.

So, the next time you encounter a CSV file in your data journey, remember the NumPy library and its capabilities to simplify your data manipulation tasks. From analyzing sales data to performing stock market analysis, NumPy empowers you to unlock insights and make informed decisions from your CSV data. Embrace the power of NumPy and elevate your data analysis skills today!

For more Related Topics

Stay in the Loop

Receive the daily email from Techlitistic and transform your knowledge and experience into an enjoyable one. To remain well-informed, we recommend subscribing to our mailing list, which is free of charge.

Latest stories

You might also like...