Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Introduction

Welcome to the practical side of probability! This book relies heavily on using Python and specific libraries within the Jupyter Notebook environment to explore concepts, run simulations, and visualize results. This appendix provides a detailed guide to setting up this environment on your computer.

Our goal is to ensure you can:

  1. Install Python.

  2. Run Jupyter Notebooks.

  3. Install and verify the core scientific libraries: NumPy, SciPy, Matplotlib, and Seaborn.

  4. Access the book’s code examples.

Even if you have some experience with Python, we recommend skimming through to ensure you have the specific setup used throughout the book.

1. Python Installation: The Anaconda Distribution

The easiest way to get Python and the essential scientific libraries installed together is by using the Anaconda Distribution. Anaconda bundles Python, Jupyter, many core libraries (like NumPy, SciPy, Matplotlib, Pandas), and a package manager (conda) that simplifies installation and management of environments.

Steps:

  1. Download: Go to the Anaconda Distribution website: https://www.anaconda.com/products/distribution

  2. Select Installer: Download the installer appropriate for your operating system (Windows, macOS, Linux). Choose the latest Python 3.x version.

  3. Run Installer: Execute the downloaded installer. Follow the on-screen instructions.

    • Recommendation: Unless you have a specific reason not to, accept the default settings. This usually includes adding Anaconda to your system’s PATH environment variable (though the installer might advise against it for advanced users, for beginners it’s often simpler).

    • You do not need administrator privileges to install Anaconda for your user only, which is often sufficient.

Verification:

Once installation is complete, open your system’s terminal or command prompt:

In the terminal, type the following command and press Enter:

python --version

You should see output similar to Python 3.x.y (e.g., Python 3.10.9), indicating Python is installed and accessible. If you get an error like “command not found”, the installation might not have completed correctly, or Anaconda wasn’t added to your PATH (you might need to reinstall or manually add it, consult Anaconda’s documentation).

2. Jupyter Notebooks

Jupyter Notebooks provide an interactive, browser-based environment where you can write and execute Python code, add explanatory text (like this!), include mathematical equations, and display visualizations, all in one document. Anaconda comes with Jupyter pre-installed.

Launching JupyterLab (Recommended Interface):

  1. Open the Anaconda Prompt (Windows) or Terminal (macOS/Linux).

  2. Navigate to the directory where you want to store your notebooks (or where you downloaded the book’s code). You can use the cd (change directory) command. For example:

    # Example for Windows - navigate to a 'ProbBook' folder on the C drive
cd C:\Users\YourUsername\Documents\ProbBook 

# Example for macOS/Linux - navigate to a 'ProbBook' folder in your home directory
cd ~/Documents/ProbBook

  3. Type the following command and press Enter:

    jupyter lab

  4. This should automatically open a new tab in your default web browser displaying the JupyterLab interface. The terminal window must remain open while you are using JupyterLab.

Alternatively, Launching Classic Jupyter Notebook:

If you prefer the classic interface, use this command instead:

jupyter notebook

Basic Jupyter Usage:

3. Core Libraries Installation/Verification

Anaconda typically installs the most crucial libraries for this book automatically. These include:

Seaborn, a visualization library based on Matplotlib that provides a high-level interface for drawing attractive statistical graphics (sns), might sometimes need to be installed separately.

Checking and Installing Libraries:

  1. Using Conda (Recommended with Anaconda): Open Anaconda Prompt or Terminal and use conda install:

    conda install numpy scipy matplotlib pandas seaborn

    Conda will check if the packages are installed and update them or install them if missing.

  2. Using Pip (Alternative): If you are not using Anaconda or prefer pip:

    pip install numpy scipy matplotlib pandas seaborn

    Note: It’s generally recommended to stick to one package manager (conda or pip) within a single environment to avoid potential conflicts.

Verification:

The best way to verify is to create a new Jupyter Notebook and run the following code cell. If it executes without any ImportError messages, your core libraries are ready.

# Verification Cell: Import Core Libraries

import math
import platform # Moved import to the top
import numpy as np
import pandas as pd
import scipy
import scipy.stats as stats
import scipy.special
import scipy.integrate
import matplotlib
import matplotlib.pyplot as plt
import seaborn as sns

# Check versions (optional, but good for debugging)
print(f"Python version: {platform.python_version()}") 
print(f"NumPy version: {np.__version__}")
print(f"Pandas version: {pd.__version__}")
print(f"SciPy version: {scipy.__version__}")
print(f"Matplotlib version: {matplotlib.__version__}")
print(f"Seaborn version: {sns.__version__}")

# Basic functionality test
try:
    arr = np.array([1, 2, 3])
    mean_val = np.mean(arr)
    binom_prob = stats.binom.pmf(k=1, n=2, p=0.5)
    plt.figure()
    sns.histplot([1, 2, 2, 3, 3, 3])
    plt.close() # Prevents plot from displaying here
    print("\nCore libraries imported and basic functions tested successfully!")
except Exception as e:
    print(f"\nAn error occurred during testing: {e}")
    print("Please check your installations.")
Python version: 3.11.14
NumPy version: 2.4.0
Pandas version: 2.3.3
SciPy version: 1.16.3
Matplotlib version: 3.10.8
Seaborn version: 0.13.2


Core libraries imported and basic functions tested successfully!

4. Getting the Book’s Code

All the Jupyter Notebooks containing the code examples and exercises for this book are available online, typically in a GitHub repository.

How to Download:

  1. Download ZIP: The simplest way is often to navigate to the main page of the GitHub repository in your web browser and look for a green “Code” button. Clicking it usually reveals a “Download ZIP” option. Download the file and unzip it into a convenient location on your computer (e.g., the ProbBook folder you might have created earlier).

  2. Using Git (More Advanced): If you are familiar with Git, you can clone the repository. Open your terminal or Anaconda Prompt, navigate to where you want to store the code, and run:

    git clone https://github.com/snowch/learn_probability.git

    This method makes it easier to get updates later using git pull.

Once downloaded, you can launch JupyterLab or Jupyter Notebook from the directory containing the code, and you should see the .ipynb files ready to be opened.

5. Basic Troubleshooting

If you encounter issues, here are a few common problems and suggestions:

6. Next Steps

With your environment set up and verified, you are ready to dive into the world of probability with Python! You can now proceed to Chapter 1: Introduction to Probability and Python Setup to begin your hands-on journey.

Make sure you can open and run the first few code cells in the Chapter 1 notebook provided with the book’s materials. Happy coding and exploring!

Lab
Chapter 5: Bayes’ Theorem and Independence
Appendices
Appendix B: Essential Library Reference