| Name | mercedestrenz JSON |
| Version |
1.0.0
JSON |
| download |
| home_page | |
| Summary | A package to inspect and analyze used Mercedes Benz car prices. |
| upload_time | 2023-02-01 18:03:11 |
| maintainer | |
| docs_url | None |
| author | Ty Andrews |
| requires_python | >=3.9,<4.0 |
| license | MIT |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# mercedestrenz
[](https://github.com/UBC-MDS/mercedestrenz/actions/workflows/ci-cd.yml)
[](https://mercedestrenz.readthedocs.io/en/latest/?badge=latest)
[](https://codecov.io/gh/UBC-MDS/mercedestrenz)
This python package is for inspecting and analyzing used Mercedes Benz car prices. The package helps users to get simple answers on how to choose the used Mercedes Benz car in the market. The package also includes useful visualization tool and trained model to serve buyers and sellers.
The full documentation of mercedestrenz package can be viewed [here](https://mercedestrenz.readthedocs.io/en/latest/index.html).
## Collaborators
Kelly Wu, Morris Zhao, Spencer Gerlach, Ty Andrews
## Python ecosystem
Our package is unique, it provides an easy way to investigate used Mercedes Benz car prices. It provide people a big picture about the market. The package relies on a real market data set to plot, filter and predict. It also gives advice to buyers and sellers when they try to make a decision.
## Functions
The package contains the following functions:
1. `load_sample_mercedes_listings`: Retrieves a data frame that contains sample data of used Mercedez Benz vehicles.
2. `plot_mercedes_price`: Plot a density plot of a Mercedes-Benz model to see where the current vehicle's price falls for that same model in the market.
3. `listing_search`: Retrieves the top listings that are within the budget range specified by the user.
4. `predict_mercedes_price`: Predicts the price in USD of a Mercedes-Benz given the year, model, odometer reading, condition and paint color.
## Package dataset
The package contains a static dataset for Craiglist used-car listings that were previously web scraped. Several key attributes about the used-car are available in the dataset, such as vehicle prices, models, car conditions, odometer readings, VINs, regions and transmission. The package's dataset was adapted from verison 10 of the raw dataset created by [AustinReese](https://github.com/AustinReese/UsedVehicleSearch).
## Installation
```bash
$ pip install mercedestrenz
```
## Usage
Below is a basic example of how to use each of the four functions included in this package.
```
# Load all required package functions
from mercedestrenz.data import load_sample_mercedes_listings, listing_search
from mercedestrenz.modelling import train_mercedes_price_prediction_model
from mercedestrenz.modelling import predict_mercedes_price
# Load the sample mercedes listings data into a dataframe
data = load_sample_mercedes_listings()
# Return the top listings that are within a budget range specified by the user. Returns a pandas dataframe of results.
listing_search(data, budget=[2000, 20000], model = "any", sort_feature = "odometer_mi", ascending = True)
# Plot a price distribution of specific mercedes models, and see where an input price falls in the distribution.
plot_mercedes_price(model='s-class', price=80000, market_df=data))
# Predict the price (in USD) of a Mercedes-Benz given the year, model, condition, paint color, and odometer reading.
predict_mercedes_price("e-class", 2015, 55_000, "fair", "silver")
```
## Contributing
Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.
## License
`mercedestrenz` was created by Kelly Wu, Morris Zhao, Spencer Gerlach, Ty Andrews. It is licensed under the terms of the MIT license.
## Credits
`mercedestrenz` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).
Raw data
{
"_id": null,
"home_page": "",
"name": "mercedestrenz",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9,<4.0",
"maintainer_email": "",
"keywords": "",
"author": "Ty Andrews",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/91/4f/0bd620b4636cb4000acfdd141a80327b3142df8786f14284f2b3c1e3ff1e/mercedestrenz-1.0.0.tar.gz",
"platform": null,
"description": "# mercedestrenz\n[](https://github.com/UBC-MDS/mercedestrenz/actions/workflows/ci-cd.yml)\n[](https://mercedestrenz.readthedocs.io/en/latest/?badge=latest)\n[](https://codecov.io/gh/UBC-MDS/mercedestrenz)\n\nThis python package is for inspecting and analyzing used Mercedes Benz car prices. The package helps users to get simple answers on how to choose the used Mercedes Benz car in the market. The package also includes useful visualization tool and trained model to serve buyers and sellers.\n\nThe full documentation of mercedestrenz package can be viewed [here](https://mercedestrenz.readthedocs.io/en/latest/index.html).\n\n## Collaborators\n\nKelly Wu, Morris Zhao, Spencer Gerlach, Ty Andrews\n\n## Python ecosystem \n\nOur package is unique, it provides an easy way to investigate used Mercedes Benz car prices. It provide people a big picture about the market. The package relies on a real market data set to plot, filter and predict. It also gives advice to buyers and sellers when they try to make a decision.\n\n## Functions\n\nThe package contains the following functions:\n1. `load_sample_mercedes_listings`: Retrieves a data frame that contains sample data of used Mercedez Benz vehicles.\n2. `plot_mercedes_price`: Plot a density plot of a Mercedes-Benz model to see where the current vehicle's price falls for that same model in the market.\n3. `listing_search`: Retrieves the top listings that are within the budget range specified by the user.\n4. `predict_mercedes_price`: Predicts the price in USD of a Mercedes-Benz given the year, model, odometer reading, condition and paint color.\n\n## Package dataset\n\nThe package contains a static dataset for Craiglist used-car listings that were previously web scraped. Several key attributes about the used-car are available in the dataset, such as vehicle prices, models, car conditions, odometer readings, VINs, regions and transmission. The package's dataset was adapted from verison 10 of the raw dataset created by [AustinReese](https://github.com/AustinReese/UsedVehicleSearch).\n\n## Installation\n\n```bash\n$ pip install mercedestrenz\n```\n\n## Usage\n\nBelow is a basic example of how to use each of the four functions included in this package.\n\n```\n# Load all required package functions\nfrom mercedestrenz.data import load_sample_mercedes_listings, listing_search\nfrom mercedestrenz.modelling import train_mercedes_price_prediction_model\nfrom mercedestrenz.modelling import predict_mercedes_price\n\n# Load the sample mercedes listings data into a dataframe\ndata = load_sample_mercedes_listings()\n\n# Return the top listings that are within a budget range specified by the user. Returns a pandas dataframe of results.\nlisting_search(data, budget=[2000, 20000], model = \"any\", sort_feature = \"odometer_mi\", ascending = True)\n\n# Plot a price distribution of specific mercedes models, and see where an input price falls in the distribution.\nplot_mercedes_price(model='s-class', price=80000, market_df=data))\n\n# Predict the price (in USD) of a Mercedes-Benz given the year, model, condition, paint color, and odometer reading.\npredict_mercedes_price(\"e-class\", 2015, 55_000, \"fair\", \"silver\")\n```\n\n## Contributing\n\nInterested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.\n\n## License\n\n`mercedestrenz` was created by Kelly Wu, Morris Zhao, Spencer Gerlach, Ty Andrews. It is licensed under the terms of the MIT license.\n\n## Credits\n\n`mercedestrenz` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A package to inspect and analyze used Mercedes Benz car prices.",
"version": "1.0.0",
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0b34f2fbe3b39fe307b00e491fbad858625d76dc0d0fe1a35b911ca6f12d4018",
"md5": "79afd15f28c4b340023c22e1ed563909",
"sha256": "27b81e62c23fc33103e26c1e9e541ed67b44773a3e9d0864b3683d7490f030e5"
},
"downloads": -1,
"filename": "mercedestrenz-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "79afd15f28c4b340023c22e1ed563909",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9,<4.0",
"size": 6022000,
"upload_time": "2023-02-01T18:03:09",
"upload_time_iso_8601": "2023-02-01T18:03:09.775466Z",
"url": "https://files.pythonhosted.org/packages/0b/34/f2fbe3b39fe307b00e491fbad858625d76dc0d0fe1a35b911ca6f12d4018/mercedestrenz-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "914f0bd620b4636cb4000acfdd141a80327b3142df8786f14284f2b3c1e3ff1e",
"md5": "26a69ad5ee1cc4ba8ac41196fc570927",
"sha256": "4039dd1a72f4be0501bb95c8b1ea43ec71a009f20953f201db61c3a7caebeb17"
},
"downloads": -1,
"filename": "mercedestrenz-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "26a69ad5ee1cc4ba8ac41196fc570927",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9,<4.0",
"size": 5982113,
"upload_time": "2023-02-01T18:03:11",
"upload_time_iso_8601": "2023-02-01T18:03:11.556668Z",
"url": "https://files.pythonhosted.org/packages/91/4f/0bd620b4636cb4000acfdd141a80327b3142df8786f14284f2b3c1e3ff1e/mercedestrenz-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-01 18:03:11",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "mercedestrenz"
}
