pandas-dev

pandas

pandas is the most popular Python data analysis and manipulation library, providing labeled data structures (Series and DataFrame) similar to R's data.frame, covering cleaning, alignment, group-by aggregation, and time series for everyday data work.

v3.1.0
Published at
6d ago
50,247
Stars
12,591
Download
Synced at
5d ago

Latest release

v3.1.0Oct 22, 2026, 01:20 PM
Downloads slow? Switch the source anytime above

README

Project Overview

pandas is the foundational library of Python data analysis, offering fast, flexible, and expressive data structures — the one-dimensional Series and two-dimensional DataFrame — that make working with labeled relational data easy and intuitive. It is built for real-world data analysis: missing value handling, data alignment, group-by aggregation, and time series operations work out of the box, and rich I/O for CSV, Excel, databases, and HDF5 completes the workflow from data import to analysis.

Item Value
Language Python
Platform Any environment with Python
Core structures Series (1D), DataFrame (2D)
License BSD-3-Clause

The de facto standard for data analysis in Python, and the byword for DataFrames.

Key Features

  • Missing data handling: unified, easy handling of NaN, NA, and NaT in both floating and non-floating point data
  • Mutable structure: columns can be inserted into and deleted from a DataFrame at any time
  • Automatic and explicit alignment: data aligns on labels during computation, or you can align explicitly
  • Group-by aggregation: powerful group by supports split-apply-combine for both aggregating and transforming
  • Smart slicing and indexing: label-based slicing, fancy indexing, and subsetting of large datasets
  • Merging and joining: intuitive merge and join operations to combine datasets
  • Reshaping and pivoting: flexible data reshaping and pivot table generation
  • Hierarchical indexing: axes support multiple labels per tick for higher-dimensional data
  • Rich I/O: read and write CSV, Excel, databases, the ultrafast HDF5 format, and more
  • Time series: date range generation, frequency conversion, moving window statistics, date shifting and lagging

Target Audience

  • Data analysts and data scientists
  • Engineers working with tabular data
  • Finance and statistics professionals
  • Data cleaning before machine learning

Quick Start

  1. Install: pip install pandas or conda install -c conda-forge pandas
  2. Load data and start analyzing:
import pandas as pd

df = pd.read_csv('data.csv')
print(df.describe())
print(df.groupby('category')['sales'].sum())
  1. Common operations: df.head() to preview, df.dropna() to clean, df.merge() to combine, df.pivot_table() to pivot

Core Advantages

  • Ecosystem core: the scientific Python stack — NumPy, matplotlib, scikit-learn — is built around it with seamless interop
  • Expressive: complex operations like filtering, aggregation, and pivoting in a single line
  • Comprehensive I/O: from CSV to Parquet to SQL databases, every data channel is covered

System Requirements

Item Requirement
Language Python
OS Linux, macOS, Windows
Dependencies NumPy

Notes

  • In-memory model: a DataFrame resides fully in memory; datasets beyond RAM need chunked processing or an out-of-core engine
  • Version changes: major releases may adjust APIs; check the official whatsnew notes before upgrading

Release history

Sort