Skip to content
Open source simulator for autonomous vehicles built on Unreal Engine / Unity, from Microsoft AI & Research
Branch: master
Clone or download
Latest commit 73c1ab2 Mar 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
AirLib fix misconfigured hexacopter motor geometry Jan 26, 2019
AirLibUnitTests Make WindowsTargetPlatformVersion more easily configurable in AirSim … Dec 7, 2018
DroneServer
DroneShell Make WindowsTargetPlatformVersion more easily configurable in AirSim … Dec 7, 2018
Examples
HelloCar Make WindowsTargetPlatformVersion more easily configurable in AirSim … Dec 7, 2018
HelloDrone
LogViewer Merge pull request #922 from Microsoft/review/px4_landing Apr 5, 2018
MavLinkCom Use recvfrom for reading data from socket in macos. Fixes #1723 Jan 26, 2019
PythonClient Added IR tutorial Feb 5, 2019
SGM
Unity Merge pull request #1749 from ykpgrr/master Jan 31, 2019
Unreal [camera settings] auto exposure settings were not being reflected in … Mar 11, 2019
cmake merge from github/master Oct 17, 2018
docs Added troubleshooting section Feb 25, 2019
tools Enable mkdocs Nov 9, 2018
.gitignore
.gitmodules remove, rpclib as submodule, download from git release, cmake install… Jan 20, 2018
.travis.yml Disable travis WIndows build as it error outs due to msbuild not inst… Dec 1, 2018
AUTHORS.md
AirSim.props Make WindowsTargetPlatformVersion more easily configurable in AirSim … Dec 7, 2018
AirSim.sln
AirSim.sln.vlconfig squashing last 3 commits to get rid of visuallint May 29, 2018
CHANGELOG.md
CONTRIBUTING.md
ISSUE_TEMPLATE.md Updated changelog, added standard md files Nov 8, 2018
LICENSE Badge recognition for license Nov 20, 2018
README.md
SUPPORT.md
UnrealPluginFiles.vcxproj Fix release build issues Nov 29, 2018
UnrealPluginFiles.vcxproj.filters
build.cmd copy AirSim.props to unreal build Dec 7, 2018
build.sh Fix Mac build.sh clang paths Jul 6, 2018
build_docs.bat add images folder in docs build Nov 9, 2018
check_cmake.bat remove, rpclib as submodule, download from git release, cmake install… Jan 20, 2018
clean.cmd remove rd external from clean.cmd Apr 30, 2018
clean.sh fixed pushd issue in setup.sh, cmake issue with -L Jul 21, 2017
clean_rebuild.bat
clean_rebuild.sh
install_run_all.sh Better Linux upgrade steps Apr 28, 2018
install_unreal.sh Better Linux upgrade steps Apr 28, 2018
setup.sh merge from github/master Oct 17, 2018

README.md

Welcome to AirSim

AirSim is a simulator for drones, cars and more, built on Unreal Engine (we now also have an experimental Unity release). It is open-source, cross platform, and supports hardware-in-loop with popular flight controllers such as PX4 for physically and visually realistic simulations. It is developed as an Unreal plugin that can simply be dropped into any Unreal environment. Similarly, we have an experimental release for a Unity plugin.

Our goal is to develop AirSim as a platform for AI research to experiment with deep learning, computer vision and reinforcement learning algorithms for autonomous vehicles. For this purpose, AirSim also exposes APIs to retrieve data and control vehicles in a platform independent way.

Check out the quick 1.5 minute demo

Drones in AirSim

AirSim Drone Demo Video

Cars in AirSim

AirSim Car Demo Video

What's New

For complete list of changes, view our Changelog

How to Get It

Windows

Linux

Build Status

How to Use It

Documentation

View our detailed documentation on all aspects of AirSim.

Manual drive

If you have remote control (RC) as shown below, you can manually control the drone in the simulator. For cars, you can use arrow keys to drive manually.

More details

record screenshot

record screenshot

Programmatic control

AirSim exposes APIs so you can interact with the vehicle in the simulation programmatically. You can use these APIs to retrieve images, get state, control the vehicle and so on. The APIs are exposed through the RPC, and are accessible via a variety of languages, including C++, Python, C# and Java.

These APIs are also available as part of a separate, independent cross-platform library, so you can deploy them on a companion computer on your vehicle. This way you can write and test your code in the simulator, and later execute it on the real vehicles. Transfer learning and related research is one of our focus areas.

Note that you can use SimMode setting to specify the default vehicle or the new ComputerVision mode so you don't get prompted each time you start AirSim.

More details

Gathering training data

There are two ways you can generate training data from AirSim for deep learning. The easiest way is to simply press the record button in the lower right corner. This will start writing pose and images for each frame. The data logging code is pretty simple and you can modify it to your heart's content.

record screenshot

A better way to generate training data exactly the way you want is by accessing the APIs. This allows you to be in full control of how, what, where and when you want to log data.

Computer Vision mode

Yet another way to use AirSim is the so-called "Computer Vision" mode. In this mode, you don't have vehicles or physics. You can use the keyboard to move around the scene, or use APIs to position available cameras in any arbitrary pose, and collect images such as depth, disparity, surface normals or object segmentation.

More details

Weather Effects

Press F10 to see various options available for weather effects. You can also control the weather using APIs. Press F1 to see other options available.

record screenshot

Tutorials

Participate

Paper

More technical details are available in AirSim paper (FSR 2017 Conference). Please cite this as:

@inproceedings{airsim2017fsr,
  author = {Shital Shah and Debadeepta Dey and Chris Lovett and Ashish Kapoor},
  title = {AirSim: High-Fidelity Visual and Physical Simulation for Autonomous Vehicles},
  year = {2017},
  booktitle = {Field and Service Robotics},
  eprint = {arXiv:1705.05065},
  url = {https://arxiv.org/abs/1705.05065}
}

Contribute

Please take a look at open issues if you are looking for areas to contribute to.

Who is Using AirSim?

We are maintaining a list of a few projects, people and groups that we are aware of. If you would like to be featured in this list please make a request here.

Contact

Join the AirSim group on Facebook to stay up to date or ask any questions.

FAQ

If you run into problems, check the FAQ and feel free to post issues in the AirSim repository.

License

This project is released under the MIT License. Please review the License file for more details.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.