{"id":92407,"name":"EV Fleet Simulator","description":"Predict the energy usage of a fleet of electric vehicles.","url":"https://gitlab.com/eputs/ev-fleet-sim","last_synced_at":"2026-04-05T12:03:36.523Z","repository":{"id":50555463,"uuid":"25339556","full_name":"eputs/ev-fleet-sim","owner":"eputs","description":"This software computes the electrical energy requirements of a fleet of vehicles. It also determines how much of this energy can be offset by renewable energy. It does all this by analyzing the fleet's GPS traces and applying EV and PV models. Please contact us if you require the source code. Contact details are provided on our project website: 🔗 www.ev-fleet-sim.online ","archived":false,"fork":false,"pushed_at":null,"size":null,"stargazers_count":8,"open_issues_count":5,"forks_count":4,"subscribers_count":null,"default_branch":"master","last_synced_at":"2026-01-04T17:36:35.694Z","etag":null,"topics":["data analysis","electric vehicles","public transport","python","renewable energy"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0+","status":null,"scm":"git","pull_requests_enabled":false,"icon_url":"https://gitlab.com/uploads/-/system/project/avatar/25339556/WebsiteIcon_6_1024.png","metadata":{},"created_at":"2021-03-22T15:54:31.419Z","updated_at":"2025-08-28T20:14:25.221Z","dependencies_parsed_at":"2022-08-20T07:41:40.323Z","dependency_job_id":null,"html_url":"https://gitlab.com/eputs/ev-fleet-sim","commit_stats":null,"previous_names":[],"tags_count":4,"template":null,"template_full_name":null,"purl":"pkg:gitlab/eputs/ev-fleet-sim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/owners/eputs","download_url":"https://gitlab.com/eputs/ev-fleet-sim/-/archive/master/ev-fleet-sim-master.zip","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim/sbom","scorecard":null,"host":{"name":"gitlab.com","url":"https://gitlab.com","kind":"gitlab","repositories_count":4521539,"owners_count":7348,"icon_url":"https://github.com/gitlab.png","version":null,"created_at":"2022-05-30T11:31:42.605Z","updated_at":"2026-01-12T22:45:04.389Z","status":"online","status_checked_at":"2026-03-27T02:00:08.384Z","response_time":261,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.382Z","robots_txt_url":"https://gitlab.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/gitlab.com/owners"}},"owner":null,"packages":[],"commits":{"id":1638836,"full_name":"eputs/ev-fleet-sim","default_branch":"master","total_commits":306,"total_committers":3,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":102.0,"dds":0.009803921568627416,"past_year_total_commits":25,"past_year_total_committers":1,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":25.0,"past_year_dds":0.0,"last_synced_at":"2026-03-27T08:03:43.766Z","last_synced_commit":"a5e54def9d531998ea16e964ac26f65bcadbe28b","created_at":"2024-07-24T20:00:49.333Z","updated_at":"2025-09-08T06:04:47.814Z","committers":[{"name":"Chris Abraham","email":"4852431-_abrac@users.noreply.gitlab.com","login":null,"count":303},{"name":"unknown","email":"lala.fuessl@outlook.de","login":null,"count":2},{"name":"Chris Abraham","email":"chrisbrhm@gmail.com","login":null,"count":1}],"past_year_committers":[{"name":"Chris Abraham","email":"4852431-_abrac@users.noreply.gitlab.com","login":null,"count":14}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim/commits","host":{"name":"gitlab.com","url":"https://gitlab.com","kind":"gitlab","last_synced_at":"2026-03-29T00:04:24.181Z","repositories_count":23881,"commits_count":4109673,"contributors_count":113738,"owners_count":12313,"icon_url":"https://github.com/gitlab.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/gitlab.com","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/gitlab.com/repositories"}},"issues_stats":{"full_name":"eputs/ev-fleet-sim","html_url":"https://gitlab.com/eputs/ev-fleet-sim","last_synced_at":"2026-03-27T08:00:59.161Z","status":"error","issues_count":null,"pull_requests_count":null,"avg_time_to_close_issue":null,"avg_time_to_close_pull_request":null,"issues_closed_count":null,"pull_requests_closed_count":null,"pull_request_authors_count":null,"issue_authors_count":null,"avg_comments_per_issue":null,"avg_comments_per_pull_request":null,"merged_pull_requests_count":null,"bot_issues_count":null,"bot_pull_requests_count":null,"past_year_issues_count":null,"past_year_pull_requests_count":null,"past_year_avg_time_to_close_issue":null,"past_year_avg_time_to_close_pull_request":null,"past_year_issues_closed_count":null,"past_year_pull_requests_closed_count":null,"past_year_pull_request_authors_count":null,"past_year_issue_authors_count":null,"past_year_avg_comments_per_issue":null,"past_year_avg_comments_per_pull_request":null,"past_year_bot_issues_count":null,"past_year_bot_pull_requests_count":null,"past_year_merged_pull_requests_count":null,"created_at":"2024-10-30T20:00:28.627Z","updated_at":"2026-03-27T08:00:59.162Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/gitlab.com/repositories/eputs%2Fev-fleet-sim/issues","issue_labels_count":{},"pull_request_labels_count":{},"issue_author_associations_count":{},"pull_request_author_associations_count":{},"issue_authors":{},"pull_request_authors":{},"host":{"name":"gitlab.com","url":"https://gitlab.com","kind":"gitlab","last_synced_at":"2026-03-29T00:00:10.689Z","repositories_count":0,"issues_count":0,"pull_requests_count":0,"authors_count":61892,"icon_url":"https://github.com/gitlab.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/gitlab.com","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/gitlab.com/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/gitlab.com/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/gitlab.com/authors"},"past_year_issue_labels_count":{},"past_year_pull_request_labels_count":{},"past_year_issue_author_associations_count":{},"past_year_pull_request_author_associations_count":{},"past_year_issue_authors":{},"past_year_pull_request_authors":{},"maintainers":[],"active_maintainers":[]},"events":null,"keywords":["data analysis","electric vehicles","public transport","python","renewable energy"],"dependencies":[{"ecosystem":"rubygems","filepath":"docs/Gemfile","sha":null,"kind":"manifest","created_at":"2022-08-20T07:41:40.148Z","updated_at":"2022-08-20T07:41:40.148Z","repository_link":"https://gitlab.com/eputs/ev-fleet-sim/blob/master/docs/Gemfile","dependencies":[{"id":2149229998,"package_name":"jekyll","ecosystem":"rubygems","requirements":"\u003e= 0","direct":true,"kind":"runtime","optional":false},{"id":2149229999,"package_name":"minima","ecosystem":"rubygems","requirements":"\u003e= 0","direct":true,"kind":"runtime","optional":false},{"id":2149230000,"package_name":"webrick","ecosystem":"rubygems","requirements":"\u003e= 0","direct":true,"kind":"runtime","optional":false},{"id":2149230001,"package_name":"jekyll-sitemap","ecosystem":"rubygems","requirements":"\u003e= 0","direct":true,"kind":"development","optional":false},{"id":2149230002,"package_name":"jekyll-feed","ecosystem":"rubygems","requirements":"\u003e= 0","direct":true,"kind":"development","optional":false},{"id":2149230004,"package_name":"jekyll-seo-tag","ecosystem":"rubygems","requirements":"\u003e= 0","direct":true,"kind":"development","optional":false}]}],"score":3.6635616461296463,"created_at":"2023-09-25T00:09:15.535Z","updated_at":"2026-04-05T12:03:36.529Z","avatar_url":"https://gitlab.com/uploads/-/system/project/avatar/25339556/WebsiteIcon_6_1024.png","language":null,"category":"Consumption","sub_category":"Mobility and Transportation","monthly_downloads":0,"total_dependent_repos":0,"total_dependent_packages":0,"readme":"\u003c!-- Note: This is a markdown file. Use a markdown editor to easily edit and\n     view this file. Just search the web for a nice markdown editor (like\n     Ghostwriter). --\u003e\n\n\u003e Notice: Please visit https://gitlab.com/eputs/ev-fleet-sim to ensure that you\n\u003e are viewing the official, up-to-date version of this repository.\n\nElectric-Vehicle Fleet Simulator\n================================\n\nThis program is used to predict the energy usage of a fleet of electric vehicles. The program receives as input GPS traces of each of the vehicles of the fleet. These GPS traces can be obtained, for example, by installing tracking devices onto the vehicles of a fleet for which you want to predict the electrical energy usage. This is especially useful for projects whereby an existing petrol/diesel fleet is to be converted to electric vehicles. The program will analyse the vehicle's driving and stopping patterns in order to predict the amount of energy used and the amount of time that the vehicle can be charged during the average day. In addition, the program makes provisions to calculate how much of the energy can be provided for by renewable-energy sources.\n\nPlease refer to the accompanying open-access journal article publication: [Ray of hope for sub-Saharan Africa's paratransit: Solar charging of urban electric minibus taxis in South Africa](https://doi.org/10.1016/j.esd.2021.08.003). The article shows how this program can be used to derive meaningful results.\n\nLicensing\n=========\n\nThis software is [licensed under GPLv3](./LICENSE)\n\nIf you use the software, or a derivative thereof, you are required to attribute the original authors using the following citation:\n\n\u003e Abraham, C. J., Rix, A. J., Ndibatya, I., \u0026 Booysen, M. J. (2021). Ray of\n\u003e hope for sub-Saharan Africa's paratransit: Solar charging of urban electric\n\u003e minibus taxis in South Africa. Energy for Sustainable Development, 64,\n\u003e 118-127. https://doi.org/10.1016/j.esd.2021.08.003\n\n\u003cdetails\u003e\u003csummary\u003eBibtex\u003c/summary\u003e\n\n```\n@article{abraham2021,\ntitle = {Ray of hope for sub-Saharan Africa's paratransit: Solar charging of urban electric minibus taxis in South Africa},\njournal = {Energy for Sustainable Development},\nvolume = {64},\npages = {118-127},\nyear = {2021},\nissn = {0973-0826},\ndoi = {https://doi.org/10.1016/j.esd.2021.08.003},\nurl = {https://www.sciencedirect.com/science/article/pii/S0973082621000946},\nauthor = {C.J. Abraham and A.J. Rix and I. Ndibatya and M.J. Booysen},\nkeywords = {Electric vehicle, Paratransit, Minibus taxi, Demand management, Renewable energy},\nabstract = {Minibus taxi public transport is a seemingly chaotic phenomenon in the developing cities of the Global South with unique mobility and operational characteristics. Eventually this ubiquitous fleet of minibus taxis is expected to transition to electric vehicles, which will result in an additional energy burden on Africa's already fragile electrical grids. This paper examines the electrical energy demands of this possible evolution, and presents a generic simulation environment to assess the grid impact and charging opportunities. We used GPS tracking and spatio-temporal data to assess the energy requirements of nine electric minibus taxis as well as the informal and formal stops at which the taxis can recharge. Given the region's abundant sunshine, we modelled a grid-connected solar photovoltaic charging system to determine how effectively PV may be used to offset the additional burden on the electrical grid. The mean energy demand of the taxis was 213kWh/d, resulting in an average efficiency of 0.93kWh/km. The stopping time across taxis, a proxy for charging opportunity, ranged from 7.7 h/d to 10.6 h/d. The energy supplied per surface area of PV to offset the charging load of a taxi while stopping, ranged from 0.38 to 0.90kWh/m2 per day. Our simulator, which is publicly available, and the results will allow traffic planners and grid operators to assess and plan for looming electric vehicle roll-outs.}\n}\n```\n\u003c/details\u003e\n\nPlease also click the \"star\" button on the top of our [code repository](https://gitlab.com/eputs/ev-fleet-sim) so that we know how many people our software is benefitting. This helps us to justify future funding and work on the project. Thank you!\n\nDocumentation\n=============\n\nTo learn how to install and use this software, please refer to the [documentation](https://ev-fleet-sim.online/docs.html).\n\nIf you learn better with videos, here is a video tutorial of the software:\n\n\u003ca href=\"https://youtu.be/vhiw34Hm7CI\" target=\"_blank\" rel=\"noopener noreferrer\"\u003e![Video Tutorial](./docs/assets/images/youtube_tutorial.png)\u003c/a\u003e\n\nGetting Support\n===============\n\nWelcome to our EV-Fleet-Sim community! You can join our community's Matrix\nchannel (an open-source alternative of Microsoft Teams):\nhttps://matrix.to/#/#ev-fleet-sim:matrix.org.\n\nFor more help, please don't hesitate to contact me on my e-mail address: \n`chris \u003cabraham-without-the-A's\u003e [at] gmail [dot] com` or via Matrix:\nhttps://matrix.to/#/@abrac:matrix.org.\n\nIf you have encountered any issues/bugs with the software, you can report them in our [issues tracker](https://gitlab.com/eputs/ev-fleet-sim/-/issues).\n\nAlso remember to press the \"star\" and \"notification bell\" on the top of the\nGitLab page. That way, you will be notified of the latest commits and\npull-requests.\n","funding_links":[],"readme_doi_urls":["https://doi.org/10.1016/j.esd.2021.08.003"],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":["electric-vehicles","public-transport","renewable-energy"],"project_url":"https://ost.ecosyste.ms/api/v1/projects/92407","html_url":"https://ost.ecosyste.ms/projects/92407"}