{"id":19556853,"url":"https://github.com/muziing/pythonautomateddriving","last_synced_at":"2025-04-26T22:33:17.741Z","repository":{"id":63696551,"uuid":"565660341","full_name":"muziing/PythonAutomatedDriving","owner":"muziing","description":"Python codes for automated driving algorithms.自动驾驶算法。","archived":false,"fork":false,"pushed_at":"2024-12-22T03:30:59.000Z","size":1655,"stargazers_count":39,"open_issues_count":1,"forks_count":9,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-04T18:12:24.415Z","etag":null,"topics":["automated-driving","path-planning"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/muziing.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":"2022-11-14T03:26:52.000Z","updated_at":"2025-03-28T16:17:24.000Z","dependencies_parsed_at":"2023-11-13T22:23:42.623Z","dependency_job_id":"734142e9-3a66-4db9-bdfe-5f83868b70ac","html_url":"https://github.com/muziing/PythonAutomatedDriving","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muziing%2FPythonAutomatedDriving","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muziing%2FPythonAutomatedDriving/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muziing%2FPythonAutomatedDriving/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muziing%2FPythonAutomatedDriving/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muziing","download_url":"https://codeload.github.com/muziing/PythonAutomatedDriving/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251063667,"owners_count":21530837,"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":["automated-driving","path-planning"],"created_at":"2024-11-11T04:39:21.710Z","updated_at":"2025-04-26T22:33:12.724Z","avatar_url":"https://github.com/muziing.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n自动驾驶算法\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n自动驾驶相关算法代码仓库，Python 语言版。\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n简体中文 | \u003ca href=\"README_en.md\"\u003eEnglish\u003c/a\u003e\n\u003c/p\u003e\n\n[![GitHub Repo stars](https://img.shields.io/github/stars/muziing/PythonAutomatedDriving)](https://github.com/muziing/PythonAutomatedDriving)\n![License](https://img.shields.io/github/license/muziing/PythonAutomatedDriving)\n\n[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n[![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://mypy-lang.org/)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/muziing/PythonAutomatedDriving/main.svg)](https://results.pre-commit.ci/latest/github/muziing/PythonAutomatedDriving/main)\n\n## 简介\n\n本代码仓库收录若干关于「自动驾驶-规划与控制算法」相关的代码，全部由 Python 语言实现。希望能为其他 PnC 算法学习者提供一批接口清晰统一、可直接复用的代码段，避免减少重复造轮子。\n\n## 如何使用\n\n### 一、获取源码\n\n1. Star 本仓库 :smiley:\n2. 通过以下方式之一获取源码：\n    - 下载代码压缩包：\u003chttps://github.com/muziing/PythonAutomatedDriving/archive/refs/heads/main.zip\u003e\n    - （仅需要参与开发时）克隆仓库 `git clone https://github.com/muziing/PythonAutomatedDriving.git`\n3. 进入项目目录 `cd /your/path/to/PythonAutomatedDriving`\n\n### 二、配置虚拟环境与安装依赖\n\n**方式 A**： venv 与 pip\n\n1. 确保 Python 版本与 [pyproject.toml](./pyproject.toml) 中要求的一致\n2. 创建虚拟环境\n    - Windows: `python -m venv --upgrade-deps venv`\n    - Linux/macOS: `python3 -m venv --upgrade-deps venv`\n3. 激活虚拟环境\n    - Windows: `venv\\Scripts\\activate`\n    - Linux/macOS: `. venv/bin/activate`\n4. 安装依赖 `pip install -r requirements.txt`\n\n**方式 B**：[Poetry](https://python-poetry.org)\n\n1. 确保 Python 版本与 [pyproject.toml](./pyproject.toml) 中要求的一致\n2. 按[官方文档](https://python-poetry.org/docs/#installation)指示安装 Poetry\n3. 创建虚拟环境：`poetry env use /full/path/to/python`（注意替换路径，使用符合版本要求的解释器）\n4. 安装依赖：`poetry install --no-dev`\n5. 使用该虚拟环境： `poetry shell`（或在 PyCharm 等 IDE 中配置）\n\n**方式 C**：[Anaconda](https://www.anaconda.com/)\n\n由于主要开发与测试工作仅在 Poetry 环境中进行，conda 环境可能出现意料之外的错误。请[提交 issue](https://github.com/muziing/PythonAutomatedDriving/issues) 帮助我发现和解决这些问题。\n\n````shell\nconda env create -f environment.yml\n````\n\n### 三、运行！\n\n在每个子项目目录中运行 Python 脚本。\n\n## 目录\n\n### [utilities](src/utilities) 辅助函数\n\n- [coordinate_transformation](src/utilities/coordinate_transformation.py) - 坐标变换\n- [discrete_curve_funcs](src/utilities/discrete_curve_funcs.py) - 处理二维离散曲线的函数\n- [numpy_additional_funcs](src/utilities/numpy_additional_funcs.py) - 一些补充numpy功能的自实现函数\n\n### [LocalPathPlanning](src/LocalPathPlanning) - 局部路径规划\n\n- [FSAE Path Planning](src/LocalPathPlanning/FSAE_PathPlanning) - 一种适用于 FSAE 无人赛车高速循迹项目的路径规划算法\n\n## 许可协议\n\n````text\nCopyright 2022-2023 muzing\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\nhttps://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n````\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuziing%2Fpythonautomateddriving","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuziing%2Fpythonautomateddriving","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuziing%2Fpythonautomateddriving/lists"}