Divvy Rideshare Data

Overview

Access and work with Chicago rideshare data from Python.

All the information is derived from the official divvy bikes website: https://divvybikes.com/

Where the data sources were linked to: https://ride.divvybikes.com/system-data

which point to:

• Historical: https://divvy-tripdata.s3.amazonaws.com/index.html
• Live and stations: https://gbfs.divvybikes.com/gbfs/gbfs.json

Installation

Install from pip

$ pip install python-divvy

Usage

Reading Data

Reading from the various data sources can be done with the following functions.

import divvy

# Historical trips between a given date range
df_trips = divvy.read_historical_trips(
    start_date="2021-01-01", 
    end_date="2021-02-01"
)
# The trips from July 15th 2022 until latest
df_trips = divvy.read_historical_trips(start_date="2022-07-15")

# Available ebikes and scooters
df_available = divvy.read_available()

# Station information and bikes and scooters available there 
df_stations = divvy.read_stations()

With the install of geopandas, the pre-May 2022 pricing boundary for ebikes can be accessed with the read_fee_boundary function.

# Single row geopandas.GeoDataFrame
gdf_fees = divvy.read_fee_boundary()

Trip Pricing

This package allows provides access to the latest pricing for the different bikes as defined here. These prices can be apply to pandas.Series objects as follows:

df_trips = pd.DataFrame({
    "duration_in_mins": [10, 10, 10, 10], 
    "member": [True, True, False, False], 
    "electric_bike": [True, False, True, False], 
})

df_trips["price"] = divvy.apply_pricing(
    duration=df_trips["duration_in_mins"], 
    member=df_trips["member"], 
    electric_bike=df_trips["electric_bike"], 
)

Classic bike prices for casual users are ambiguous due to the daily rate or single trip rate. However, they can be accessed in the divvy.pricing module as so.

casual_non_electric_duration = [10, 20, 30]

divvy.pricing.single_ride_rate(casual_non_electric_duration)
divvy.pricing.visitor_pass_rate(casual_non_electric_duration)

New pricing can easily be defined from the divvy.pricing module as well. For instance, a reduced ebike rate can be created for casual users.

reduced_ebike_rate = (
    divvy.pricing.UnlockRate(amount=100) 
    + divvy.pricing.MinuteRate(amount=25, start=0)
)

casual_electric_duration = [10, 20, 30]

reduced_ebike_rate(casual_electric_duration)