Lovely Rita is set of tools for reading, cleaning, and saving parking parking citation datasets. The project is a part of Oakland's Code for America brigade OpenOakland. You can read more about the project in this presentation.
With Lovely Rita, you can load historical parking citation data, clean the data (addresses and dates), geocode (turn addresses into geospatial coordinates), and save cleaned data to shapefiles for GIS analyses.
It is good practice to use a virtual environment.
git clone https://github.com/r-b-g-b/lovely-rita.git
cd lovely-rita
pip install -r requirements.txt
pip install . --user
Raw data should be provided in a .csv with the column names (in any order):
- ticket_number
- ticket_issue_date
- ticket_issue_time
- street_name
- street_name
- street_no
- street_suffix
- violation_external_code
- violation_desc_long
- state
- city
- badge__
- fine_amount
Several useful workflows can be run from the command line. Learn about the available workflows using lovelyrita --help
. Learn about a specific workflow using lovelyrita <workflow> --help
.
There is also a python inferface if you want to dive deeper into the data.
from lovelyrita.data import read_data
citations = read_data(data_path)
from lovelyrita.data import read_data
citations = read_data(data_path)
citations = clean(citations)
- Number of citations per zip code
- Time-series, number of citations
- Type of violation by zip code
There will be tests.
Please read [CONTRIBUTING.md](https://gist.github.com/PurpleBooth/b24679402957c63ec426) for details on our code of conduct, and the process for submitting pull requests to us.
See our list of contributors to learn about the many wonderful people who helped design and build Lovely Rita.
This project is licensed under the MIT License - see the license file for details.
We would like to acknowledge the help of Danielle Dai and the Oakland Department of Transportation for providing the data and invaluable guidance for this project.