Skip to content

Commit 8e8b095

Browse files
committed
Add GitHub actions and badges
1 parent 77dbddb commit 8e8b095

File tree

4 files changed

+39
-4
lines changed

4 files changed

+39
-4
lines changed

.github/workflows/ruff.yml

+8
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
name: Ruff
2+
on: [ push, pull_request ]
3+
jobs:
4+
ruff:
5+
runs-on: ubuntu-latest
6+
steps:
7+
- uses: actions/checkout@v4
8+
- uses: astral-sh/ruff-action@v1

.github/workflows/testing.yml

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
name: Testing
2+
3+
on: [push]
4+
5+
jobs:
6+
test:
7+
runs-on: ubuntu-latest
8+
steps:
9+
- uses: actions/checkout@v4
10+
- uses: actions/setup-python@v5
11+
with:
12+
python-version: '3.8'
13+
cache: 'pip'
14+
architecture: 'x64'
15+
- name: Install dependencies
16+
run: pip install .
17+
- name: Test with pytest
18+
run: |
19+
pip install pytest pytest-cov
20+
pytest tests.py --doctest-modules --junitxml=junit/test-results.xml --cov=com --cov-report=xml --cov-report=html
21+

README.md

+7-1
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,14 @@
11
# Autonomous Drone Racing Project Course
2-
![ADR Banner](docs/img/banner.jpeg)
2+
<p align="center">
3+
<img width="460" height="300" src="docs/img/banner.jpeg">
4+
</p>
35
<sub><sup>AI generated image</sup></sub>
6+
[![Ruff Check](https://github.com/utiasDSL/lsy_drone_racing/actions/workflows/ruff.yml/badge.svg?style=flat-square)](https://github.com/utiasDSL/lsy_drone_racing/actions/workflows/ruff.yml) [![Documentation Status](https://readthedocs.org/projects/lsy-drone-racing/badge/?version=latest&style=flat-square)](https://lsy-drone-racing.readthedocs.io/en/latest/?badge=latest)
47

58
## Table of Contents
69
- [Autonomous Drone Racing Project Course](#autonomous-drone-racing-project-course)
710
- [Table of Contents](#table-of-contents)
11+
- [Documentation](#documentation)
812
- [Installation](#installation)
913
- [Fork lsy\_drone\_racing](#fork-lsy_drone_racing)
1014
- [Using conda/mamba](#using-condamamba)
@@ -28,6 +32,8 @@
2832
- [Launch](#launch)
2933

3034

35+
## Documentation
36+
To get you started with the drone racing project, you can head over to our [documentation page](https://lsy-drone-racing.readthedocs.io/en/latest/getting_started/general.html).
3137

3238
## Installation
3339

docs/getting_started/general.rst

+3-3
Original file line numberDiff line numberDiff line change
@@ -5,13 +5,13 @@ Welcome to the LSY Drone Racing Project! This is a platform developed by the LSY
55

66
Implementing Your Own Algorithms
77
--------------------------------
8-
To implement your own controller, you need to implement a ``Controller`` class in the :mod:`lsy_drone_racing.control` module. The only restriction we place on controllers is that they have to implement the interface defined by the :class:` BaseController <lsy_drone_racing.control.controller.BaseController>` class. Apart from that, you are encouraged to use the full spectrum of control algorithms, e.g., MPC, trajectory optimization, reinforcement learning, etc., to compete in the challenge. Please make sure to put your controller implementation in the :mod:`lsy_drone_racing.control` module to make sure that it is correctly recognized by our scripts.
8+
To implement your own controller, you need to implement a ``Controller`` class in the :mod:`lsy_drone_racing.control` module. The only restriction we place on controllers is that they have to implement the interface defined by the :class:`BaseController <lsy_drone_racing.control.controller.BaseController>` class. Apart from that, you are encouraged to use the full spectrum of control algorithms, e.g., MPC, trajectory optimization, reinforcement learning, etc., to compete in the challenge. Please make sure to put your controller implementation in the :mod:`lsy_drone_racing.control` module to make sure that it is correctly recognized by our scripts.
99

1010
.. note::
1111
Make sure to inherit from the base class for your controller implementation. This ensures that your controller is compatible with our scripts. Also make sure to only create one controller class per file. Otherwise, we do not know which controller to load from the file.
1212

1313
.. warning::
14-
You are not allowed to modify the interface of the :class:` BaseController <lsy_drone_racing.control.controller.BaseController>` class. Doing so will make your controller incompatible with the deployment environment and we won't be able to run your controller on our setup.
14+
You are not allowed to modify the interface of the :class:`BaseController <lsy_drone_racing.control.controller.BaseController>` class. Doing so will make your controller incompatible with the deployment environment and we won't be able to run your controller on our setup.
1515

1616
.. warning::
1717
Many students are enthusiastic about deep reinforcement learning and try to use it to solve the challenge. While you are completely free in choosing your control algorithm, we know from experience that training good agents is non-trivial, requires significant compute, and can be difficult to transfer into the real world setup. Students taking this approach should make sure they already have some experience with RL, and take their policies to the real world setup early to address potential sim2real issues.
@@ -39,7 +39,7 @@ Project Structure
3939
-----------------
4040
The project is organized as follows:
4141

42-
The `lsy_drone_racing` package contains all the code for the project. The :mod:`lsy_drone_racing.control` module contains the interface for the controllers, and the :mod:`lsy_drone_racing.envs` module contains the environments for the project.
42+
The ``lsy_drone_racing`` package contains all the code for the project. The :mod:`lsy_drone_racing.control` module contains the interface for the controllers, and the :mod:`lsy_drone_racing.envs` module contains the environments for the project.
4343

4444
The levels are defined in the config files contained in the `config` folder. You can have a look at the configuration options to understand how exactly they differ from each other.
4545

0 commit comments

Comments
 (0)