Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ajhenry/searchable-car-database

This is a searchable car dataset with 40,000+ entries from 1987-2021. All data from fueleconomy.gov
https://github.com/ajhenry/searchable-car-database

car-database dataset hacktoberfest pouchdb react

Last synced: about 2 months ago
JSON representation

This is a searchable car dataset with 40,000+ entries from 1987-2021. All data from fueleconomy.gov

Awesome Lists containing this project

README 

        
# Searchable Car Database



This is a searchable car database with 40,000+ entries from 1987-2021 (updated 9/14/2020). Includes data items like make, model, year, transmission type, fuel economy data, etc. There are two different formats you can download the dataset in, JSON and CSV. There is also a link to a react app that utilizes the data along with [PouchDb](https://pouchdb.com/) to create a browser based database with indexing.



__Note:__ The dataset that is used to populate the database for the search webapp takes awhile to load into browser memory and create indexes on



All data is from [fueleconomy.gov](https://fueleconomy.gov) and you may download this dataset from their [website](https://www.fueleconomy.gov/feg/download.shtml) too.



## Getting Started



`parser.py` is used to transform the data from CSV to JSON format. Use `parser.py --help` to see a list of required inputs



```sh

pip install pipenv

pipenv shell

pipenv install

python parser.py [args]

```



The react app and accompanying database is under `vehicle-search/`



### Installing



To get the react app up and running, follow the README found under `vehicle-search/`



## Built With



* [PouchDb](https://pouchdb.com/) - The database that houses the 40,000+ entries in browser



## License



This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details



# Information



This is the list of descriptions for the csv headers



    atvtype - type of alternative fuel or advanced technology vehicle

    barrels08 - annual petroleum consumption in barrels for fuelType1 (1)

    barrelsA08 - annual petroleum consumption in barrels for fuelType2 (1)

    charge120 - time to charge an electric vehicle in hours at 120 V

    charge240 - time to charge an electric vehicle in hours at 240 V

    city08 - city MPG for fuelType1 (2), (11)

    city08U - unrounded city MPG for fuelType1 (2), (3)

    cityA08 - city MPG for fuelType2 (2)

    cityA08U - unrounded city MPG for fuelType2 (2), (3)

    cityCD - city gasoline consumption (gallons/100 miles) in charge depleting mode (4)

    cityE - city electricity consumption in kw-hrs/100 miles

    cityUF - EPA city utility factor (share of electricity) for PHEV

    co2 - tailpipe CO2 in grams/mile for fuelType1 (5)

    co2A - tailpipe CO2 in grams/mile for fuelType2 (5)

    co2TailpipeAGpm - tailpipe CO2 in grams/mile for fuelType2 (5)

    co2TailpipeGpm- tailpipe CO2 in grams/mile for fuelType1 (5)

    comb08 - combined MPG for fuelType1 (2), (11)

    comb08U - unrounded combined MPG for fuelType1 (2), (3)

    combA08 - combined MPG for fuelType2 (2)

    combA08U - unrounded combined MPG for fuelType2 (2), (3)

    combE - combined electricity consumption in kw-hrs/100 miles

    combinedCD - combined gasoline consumption (gallons/100 miles) in charge depleting mode (4)

    combinedUF - EPA combined utility factor (share of electricity) for PHEV

    cylinders - engine cylinders

    displ - engine displacement in liters

    drive - drive axle type

    emissionsList

    engId - EPA model type index

    eng_dscr - engine descriptor; see http://www.fueleconomy.gov/feg/findacarhelp.shtml#engine

    evMotor - electric motor (kw-hrs)

    feScore - EPA Fuel Economy Score (-1 = Not available)

    fuelCost08 - annual fuel cost for fuelType1 ($) (7)

    fuelCostA08 - annual fuel cost for fuelType2 ($) (7)

    fuelType - fuel type with fuelType1 and fuelType2 (if applicable)

    fuelType1 - fuel type 1. For single fuel vehicles, this will be the only fuel. For dual fuel vehicles, this will be the conventional fuel.

    fuelType2 - fuel type 2. For dual fuel vehicles, this will be the alternative fuel (e.g. E85, Electricity, CNG, LPG). For single fuel vehicles, this field is not used

    ghgScore - EPA GHG score (-1 = Not available)

    ghgScoreA - EPA GHG score for dual fuel vehicle running on the alternative fuel (-1 = Not available)

    guzzler- if G or T, this vehicle is subject to the gas guzzler tax

    highway08 - highway MPG for fuelType1 (2), (11)

    highway08U - unrounded highway MPG for fuelType1 (2), (3)

    highwayA08 - highway MPG for fuelType2 (2)

    highwayA08U - unrounded highway MPG for fuelType2 (2),(3)

    highwayCD - highway gasoline consumption (gallons/100miles) in charge depleting mode (4)

    highwayE - highway electricity consumption in kw-hrs/100 miles

    highwayUF - EPA highway utility factor (share of electricity) for PHEV

    hlv - hatchback luggage volume (cubic feet) (8)

    hpv - hatchback passenger volume (cubic feet) (8)

    id - vehicle record id

    lv2 - 2 door luggage volume (cubic feet) (8)

    lv4 - 4 door luggage volume (cubic feet) (8)

    make - manufacturer (division)

    mfrCode - 3-character manufacturer code

    model - model name (carline)

    mpgData - has My MPG data; see yourMpgVehicle and yourMpgDriverVehicle

    phevBlended - if true, this vehicle operates on a blend of gasoline and electricity in charge depleting mode

    pv2 - 2-door passenger volume (cubic feet) (8)

    pv4 - 4-door passenger volume (cubic feet) (8)

    rangeA - EPA range for fuelType2

    rangeCityA - EPA city range for fuelType2

    rangeHwyA - EPA highway range for fuelType2

    trans_dscr - transmission descriptor; see http://www.fueleconomy.gov/feg/findacarhelp.shtml#trany

    trany - transmission

    UCity - unadjusted city MPG for fuelType1; see the description of the EPA test procedures

    UCityA - unadjusted city MPG for fuelType2; see the description of the EPA test procedures

    UHighway - unadjusted highway MPG for fuelType1; see the description of the EPA test procedures

    UHighwayA - unadjusted highway MPG for fuelType2; see the description of the EPA test procedures

    VClass - EPA vehicle size class

    year - model year

    youSaveSpend - you save/spend over 5 years compared to an average car ($). Savings are positive; a greater amount spent yields a negative number. For dual fuel vehicles, this is the cost savings for gasoline

    sCharger - if S, this vehicle is supercharged

    tCharger - if T, this vehicle is turbocharged

    c240Dscr - electric vehicle charger description

    charge240b - time to charge an electric vehicle in hours at 240 V using the alternate charger

    c240bDscr - electric vehicle alternate charger description

    createdOn - date the vehicle record was created (ISO 8601 format)

    modifiedOn - date the vehicle record was last modified (ISO 8601 format)

    startStop - vehicle has start-stop technology (Y, N, or blank for older vehicles)

    phevCity - EPA composite gasoline-electricity city MPGe for plug-in hybrid vehicles

    phevHwy - EPA composite gasoline-electricity highway MPGe for plug-in hybrid vehicles

    phevComb - EPA composite gasoline-electricity combined city-highway MPGe for plug-in hybrid vehicles