Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 37 additions & 34 deletions src/lane_visualize/README.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,52 @@
# 神经网络实现代理
自动驾驶汽车车道和路径检测
=========================================
## Demo
<div align="center">
<a href="https://www.youtube.com/watch?v=UFQQbTYH9hI-Y">
<img
src="https://i.ytimg.com/vi/UFQQbTYH9hI/maxresdefault.jpg"
alt="Demo"
style="width:100%;">
</a>
</div>

利用神经网络/ROS 实现 Carla(车辆、行人的感知、规划、控制)、AirSim、Mujoco 中人和载具的代理。
## 如何安装

## 环境配置
为了能够运行它,我建议使用 Python 3.6 或更高版本。

* 平台:Windows 10/11,Ubuntu 20.04/22.04
* 软件:Python 3.7-3.12(需支持3.7)、Pytorch(尽量不使用Tensorflow)
* 相关软件下载 [链接](https://pan.baidu.com/s/1IFhCd8X9lI24oeYQm5-Edw?pwd=hutb)
1. 安装要求

```
pip3 install -r requirements.txt
```
这将安装运行此作所需的所有依赖项。

## 贡献指南
2. 下载示例数据

准备提交代码之前,请阅读 [贡献指南](https://github.com/OpenHUTB/.github/blob/master/CONTRIBUTING.md) 。
代码的优化包括:注释、[PEP 8 风格调整](https://peps.pythonlang.cn/pep-0008/) 、将神经网络应用到Carla模拟器中、撰写对应 [文档](https://openhutb.github.io/nn/) 、添加 [源代码对应的自动化测试](https://docs.github.com/zh/actions/use-cases-and-examples/building-and-testing/building-and-testing-python) 等(从Carla场景中获取神经网络所需数据或将神经网络的结果输出到场景中)。
The sample data can be downloaded from [here.](https://drive.google.com/file/d/1hP-v8lLn1g1jEaJUBYJhv1mEb32hkMvG/view?usp=sharing) More data will be added soon.

### 约定
3. 运行程序

* 每个模块位于`src/{模块名}`目录下,`模块名`需要用2-3个单词表示,首字母不需要大写,下划线`_`分隔,不能宽泛,越具体越好
* 每个模块的入口须为`main.`开头,比如:main.py、main.cpp、main.bat、main.sh等,提供的ROS功能以`main.launch`文件作为启动配置文件
* 每次pull request都需要保证能够通过main脚本直接运行整个模块,在提交信息中提供运行动图或截图;Pull Request的标题不能随意,需要概括具体的修改内容;README.md文档中提供运行环境和运行步骤的说明
* 仓库尽量保存文本文件,二进制文件需要慎重,如运行需要示例数据,可以保存少量数据,大量数据可以通过提供网盘链接并说明下载链接和运行说明
```
python3 main.py <path-to-sample-data-hevc>
```

## 下一步是什么 ?

### 文档生成
使用 YOLOv3 进行红绿灯、汽车、卡车、自行车、摩托车、行人和停车标志检测。
实时语义分割,或几乎实时。
快速大满贯。

测试生成的文档:
1. 安装python 3.11,并使用以下命令安装`mkdocs`和相关依赖:
```shell
pip install mkdocs -i http://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com
pip install -r requirements.txt
```
(可选)安装完成后使用`mkdocs --version`查看是否安装成功。
## 相关研究

2. 在命令行中进入`nn`目录下,运行:
```shell
mkdocs build
mkdocs serve
```
然后使用浏览器打开 [http://127.0.0.1:8000](http://127.0.0.1:8000),查看文档页面能否正常显示。
[Learning a driving simulator](https://arxiv.org/abs/1608.01230)

## 学分

[comma.ai for supercombo model](https://github.com/commaai/openpilot/blob/master/models/supercombo.keras)

[Harald Schafer for parts of the code](https://github.com/haraldschafer)

## 参考
[lanes_image_space.py Code by @Shane](https://github.com/ShaneSmiskol)

* [代理模拟器文档](https://openhutb.github.io)
* 已有相关 [无人车](https://openhutb.github.io/doc/used_by/) 、[无人机](https://openhutb.github.io/air_doc/third/used_by/) 、[具身人](https://openhutb.github.io/doc/pedestrian/humanoid/) 的实现
* [神经网络原理](https://github.com/OpenHUTB/neuro)

通过网盘分享的文件:supercombo.h5
链接: https://pan.baidu.com/s/1yYc4aPBLnXRuWXEb0hyKMA?pwd=1234 提取码: 1234
8 changes: 3 additions & 5 deletions src/lane_visualize/requirements.txt
Original file line number Diff line number Diff line change
@@ -1,5 +1,3 @@
python-markdown-math
imageio
numpy
matplotlib
tensorflow
opencv-python>=4.8.0
numpy>=1.24.0
matplotlib>=3.7.0
Binary file removed src/lane_visualize/sample.hevc
Binary file not shown.
Loading