Python Snippets for PHSMA Hazmat Incident Report Data

The goal of this repository is to help you gain familiarity with the PHMSA Hazmat Incident Report data collected by the Data Liberation Project, with an eye toward understanding the data structure and data quality.

The code in this repository is written in Python and assumes you have some familarity with that programming language.

Getting started

If you just want to read the code and review the outputs, you can view this repository's main notebook directly.

If you want to run the code yourself, follow these steps:

Ensure that you have Python 3 installed
Use git clone to copy this repository onto your computer
cd into the repository's main directory
Run git submodule update --init --remote --recursive to pull the latest data into the phmsa-hazmat-incident-reports/ subdirectory
Run make venv to create a Python virtual environment with the necessary requirements
Run source venv/bin/activate to activate the virtual environment
Run jupyter lab to launch Jupyter
Within Jupyter, navigate to the notebooks/snippets.ipynb notebook

Many thanks to the Data Liberation Project volunteers who have contributed to this repository:

This repository's code is available under the MIT License terms.

File an issue in this repository or email Jeremy Singer-Vine at jsvine@gmail.com.