usdatasets – Examples

This page provides practical examples of using usdatasets for data analysis and exploration.

Basic Examples

Example 1: Loading and Exploring a Dataset

Learn how to load a dataset and perform basic exploration.

import usdatasets as usd

# Load the US Presidents dataset
presidents = usd.load_dataset("presidents")

# Display first few rows
print(presidents.head())

# Check dataset shape
print(f"\nDataset shape: {presidents.shape}")

# View column names
print(f"\nColumns: {list(presidents.columns)}")

# Get summary statistics
print("\nSummary statistics:")
print(presidents.describe())

# Check for missing values
print("\nMissing values:")
print(presidents.isnull().sum())


# Load crime data
crime_data = usd.load_dataset("crime_and_incarceration_by_state")

# Filter data for years after 2010
recent_data = crime_data[crime_data["year"] > 2010]
print(f"Records after 2010: {len(recent_data)}")

# Filter data for a specific jurisdiction
california_data = crime_data[
    crime_data["jurisdiction"] == "California"
]
print(f"California records: {len(california_data)}")

# Filter multiple conditions
ca_recent = crime_data[
    (crime_data["jurisdiction"] == "California") &
    (crime_data["year"] > 2010)
]
print(f"California after 2010: {len(ca_recent)}")

# Select specific columns
selected = crime_data[
    [
        "jurisdiction",
        "year",
        "violent_crime_total",
        "property_crime_total",
        "state_population"
    ]
]
print(selected.head())