{"id":13723984,"url":"https://github.com/XavB64/lowtrip","last_synced_at":"2025-05-07T17:32:18.318Z","repository":{"id":233983812,"uuid":"720400217","full_name":"XavB64/lowtrip","owner":"XavB64","description":"A web app to compute travel CO2eq for different means of transport worldwide","archived":false,"fork":false,"pushed_at":"2025-04-27T20:10:46.000Z","size":13413,"stargazers_count":67,"open_issues_count":4,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-02T16:55:24.732Z","etag":null,"topics":["carbon-footprint","energy","map","slow-travelers","travel"],"latest_commit_sha":null,"homepage":"https://lowtrip.fr","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/XavB64.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-18T11:21:00.000Z","updated_at":"2025-04-27T20:10:46.000Z","dependencies_parsed_at":"2024-04-24T06:53:08.539Z","dependency_job_id":"6dabe1c3-b769-4db6-aa00-81b52ba64555","html_url":"https://github.com/XavB64/lowtrip","commit_stats":{"total_commits":280,"total_committers":13,"mean_commits":21.53846153846154,"dds":0.7785714285714286,"last_synced_commit":"59c5ac68263612726d8309f4b2520a45315c870c"},"previous_names":["xavb64/lowtrip"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XavB64%2Flowtrip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XavB64%2Flowtrip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XavB64%2Flowtrip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/XavB64%2Flowtrip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/XavB64","download_url":"https://codeload.github.com/XavB64/lowtrip/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252926757,"owners_count":21826360,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carbon-footprint","energy","map","slow-travelers","travel"],"created_at":"2024-08-03T01:01:48.035Z","updated_at":"2025-05-07T17:32:13.633Z","avatar_url":"https://github.com/XavB64.png","language":"TypeScript","readme":"\n\u003cimg src=\"./frontend/src/assets/lowtrip_color.png\" alt=\"lowtrip\" width=\"400\"/\u003e\n\n# a web app to compute travel CO2eq for different means of transport worldwide\n\nThe work presented here is independent and not-for-profit. This work has been carried out on a\nvoluntary basis.\n\nThe aim of this web app is to present precise carbon inventories per passenger for each mode of\ntransport and each journey. These results enable users to make informed choices in the context of\nreducing their greenhouse gas emissions to mitigate climate change. To put these results into context, total net yearly\nper-capita emissions should not exceed 2 tons CO2eq in 2050 to limit global warming below +2°C.\n\nYou can have a look at https://lowtrip.fr/.\n\n# How the emissions are calculated?\n\nTo calculate CO2 equivalent emissions per person, we multiply the distance of a journey (km) by the corresponding emission factor (mass of CO2 equivalent per person per km) of a mean of transport. For a mutlistep journey, these emissions are summed over the different steps:\n\n$$CO_2eq = \\sum_{step} Distance(km) \\times Emission \\\\: Factor(kgCO_2eq / km) $$\n\n### Estimation of distances\n\n| Mean of Transport | Distance |\n| --- | --- |\n| `Train` | OpenStreetMap network |\n| `Car \u0026 Bus \u0026 eCar` | OpenStreetMap network |\n| `Bike route` | OpenStreetMap network |\n| `Plane` | Geodesic distance and average detour |\n| `Ferry \u0026 Sailboat` | Approximation of shortest path |\n\n### What do emission factors depend on?\n\n| Mean of Transport | Variable |\n| --- | --- |\n| `Train` | Visited countries |\n| `Bus` | - |\n| `Car` | Number of passengers |\n| `Electric car` | Visited countries \u0026 Number of passengers |\n| `Bike route` | - |\n| `Plane` | Distance of journey |\n| `Ferry` | User-specified parameters |\n| `Sailboat` | - ; improvements on the way |\n\nEmissions factors consider usage (linked to the manufacture and use of energy to move the vehicle) as well as infrastructure and vehicle construction where these are significant. The table below summarizes the types of emissions taken into account by lowtrip. Empty cells mean that the related emissions did not contribute significantly to the result and are therefore excluded to facilitate understanding and readability for the user.\n\n| Mean of Transport | Usage | Vehicle construction | Infrastruture construction |\n| --- |  :---: |  :---: |  :---: |\n| `Train` | :white_check_mark: |  | :white_check_mark: |\n| `Car \u0026 Bus \u0026 eCar` | :white_check_mark: | :white_check_mark: |  |\n| `Bike route` | | :white_check_mark: | Not found |\n| `Plane` |  :white_check_mark: |  |  |\n| `Ferry` |  :white_check_mark: | | Not found |\n| `Sailboat` | :white_check_mark: | | Not found |\n\nAll assumptions, data and sources used are available in the [methodology](https://github.com/XavB64/lowtrip/blob/main/frontend/src/assets/lowtrip_methodology.pdf) document.\n\n# How to launch the app?\n\n### Prerequisites\n\nHave docker installed\n\n### Launch the app\n\nAt the root of the directory, run:\n\n```bash\ndocker-compose up --build\n```\n\nYou can now connect to [http://localhost:3000](http://localhost:3000) to test the application.\n\nNote: If you want to launch them in the backgroup and leave them running, you can add the flag `-d` or `--detach`.\n\n### Rebuild and restart a service\n\nAt the root of the directory, run:\n\n```bash\ndocker-compose up --build \u003cservice name: backend or frontend\u003e\n```\n\n### Stop the app\n\nAt the root of the directory, run:\n\n```bash\ndocker-compose down\n```\n\n## How to launch the app components separately?\n\n### Prerequisites\n\nHave python \u0026 node installed\n\n### Launch the backend\n\n```bash\ncd backend\n\n# create a python environment and activate it\npython -m venv lowtrip-venv\nsource lowtrip-venv/bin/activate\n\n# install the dependencies\npip install -r requirements.txt\n\n# launch the app\ngunicorn app:app\n```\n\nYou can format the code with ruff:\n```bash\npip install ruff\nruff format\n```\n\n### Launch the frontend\n\n\n```bash\ncd frontend\n\n# install the dependencies\nnpm install\n\n# launch the app\nnpm start\n```\n\n# How to cite this work ?\n\n*Bonnemaizon, Xavier, Ni, Clara, Gres, Paola \u0026 Pellas, Chiara. lowtrip (2024). https://lowtrip.fr*\n","funding_links":[],"categories":["Consumption","TypeScript"],"sub_categories":["Mobility and Transportation"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXavB64%2Flowtrip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FXavB64%2Flowtrip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FXavB64%2Flowtrip/lists"}