Skip to content

usdot-fhwa-stol/autoware.auto

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CicleCI Build Status Sonar Code Quality Docker Hub Develop
CircleCI Quality Gate Status Docker Cloud Build Status

autoware.auto

This is a fork of AutowareAuto containing modifications to support usage with the CARMAPlatform. This repository contains changes to the AutowareAuto source code and configuration that may not be supported by the Autoware Foundation and may not be consistent with the original design intent of Autoware. All modifications in this repository are licensed under the same Apache License 2.0 as Autoware and all modifications of the source code made will be marked as such in accordance with the terms of the Apache License 2.0. For a list of modifications and their descriptions please see NOTICE.md.

The next several sections of this readme provide standard information on how this repo relates to the rest of the CARMA project. Below that is the full content of the readme from the master AutowareAuto repo.

Autoware is the world's first "all-in-one" open-source software for self-driving vehicles hosted under the Autoware Foundation.

The Autoware.Auto project, based on ROS 2, is the next generation successor of the Autoware.AI project, based on ROS 1.

Please see the documentation for all information, including how to build, run, and contribute to Autoware.Auto.

For developers working in this repository:

For any modified file please follow these steps to ensure proper documentation of this modification in compliance with the terms of the Apache License 2.0:

  1. Add a comment at the top of any modified file with a high-level description of the modification and date the modification was made.
  2. Add a high-level description and date of the overall modification to the NOTICE.md file.

Repository Structure

This repository consists of multiple git subtrees to combine the multi-repo structure used by AutowareAuto into a single structure for CARMA. For more information on working with subtrees see the SUBTREES.md file.

NOTICE: When working with subtrees please ensure that individual commits only change files in ONE-AND-ONLY-ONE subtree.

If your branch must change multiple subtrees please make those changes in separate commits. Do not squash commits that change multiple subtrees, even when merging via Github.

CARMAPlatform

The primary CARMAPlatform repository can be found here and is part of the USDOT FHWA STOL github organization. Documentation on how the CARMAPlatform functions, how it will evolve over time, and how you can contribute can be found at the above links as well

Contribution

Welcome to the CARMA contributing guide. Please read this guide to learn about our development process, how to propose pull requests and improvements, and how to build and test your changes to this project. CARMA Contributing Guide

Code of Conduct

Please read our CARMA Code of Conduct which outlines our expectations for participants within the CARMA community, as well as steps to reporting unacceptable behavior. We are committed to providing a welcoming and inspiring community for all and expect our code of conduct to be honored. Anyone who violates this code of conduct may be banned from the community.

Attribution

The development team would like to acknowledge the people who have made direct contributions to the design and code in this repository. CARMA Attribution

License

By contributing to the Federal Highway Administration (FHWA) Connected Automated Research Mobility Applications (CARMA), you agree that your contributions will be licensed under its Apache License 2.0 license. CARMA License

Contact

Please click on the CARMA logo below to visit the Federal Highway Adminstration(FHWA) CARMA website. For technical support from the CARMA team, please contact the CARMA help desk at CAVSupportServices@dot.gov.

CARMA Image

Autoware

Autoware

Autoware is the world's first "all-in-one" open-source software for self-driving vehicles. The capabilities of Autoware are primarily well-suited for urban cities, but highways, freeways, mesomountaineous regions, and geofenced areas can be also covered. The code base of Autoware is protected by the Apache 2 License. Please use it at your own discretion. For safe use, we provide a ROSBAG-based simulation environment for those who do not own real autonomous vehicles. If you plan to use Autoware with real autonomous vehicles, please formulate safety measures and assessment of risk before field testing.

You may refer to Autoware Wiki for Users Guide and Developers Guide.

What Is Autoware

Autoware Overview

Autoware provides a rich set of self-driving modules composed of sensing, computing, and actuation capabilities. An overview of those capabilities is described here. Keywords include Localization, Mapping, Object Detection & Tracking, Traffic Light Recognition, Mission & Motion Planning, Trajectory Generation, Lane Detection & Selection, Vehicle Control, Sensor Fusion, Cameras, LiDARs, RADARs, Deep Learning, Rule-based System, Connected Navigation, Logging, Virtual Reality, and so on.

Free manuals can be also found at Autoware-Manuals. You are encouraged to contribute to the maintenance of these manuals. Thank you for your cooperation!

Getting Started

Autoware Demo

Recommended System Specifications

  • Number of CPU cores: 8
  • RAM size: 32GB
  • Storage size: 64GB+

Users Guide

  1. Installation
    1. Docker
    2. Source
  2. Demo
  3. Field Test
  4. Simulation Test
  5. Videos

Developers Guide

  1. Contribution Rules (Must Read)
  2. Overview
  3. Specification

Research Papers for Citation

  1. S. Kato, S. Tokunaga, Y. Maruyama, S. Maeda, M. Hirabayashi, Y. Kitsukawa, A. Monrroy, T. Ando, Y. Fujii, and T. Azumi,``Autoware on Board: Enabling Autonomous Vehicles with Embedded Systems,'' In Proceedings of the 9th ACM/IEEE International Conference on Cyber-Physical Systems (ICCPS2018), pp. 287-296, 2018. Link

  2. S. Kato, E. Takeuchi, Y. Ishiguro, Y. Ninomiya, K. Takeda, and T. Hamada. ``An Open Approach to Autonomous Vehicles,'' IEEE Micro, Vol. 35, No. 6, pp. 60-69, 2015. Link

Cloud Services

Autoware Online

You may test Autoware at Autoware Online. No need to install the Autoware repository to your local environment.

Automan

You may annotate and train your ROSBAG data using your web browser through Automan. The trained models can be used for deep neural network algorithms in Autoware, such as SSD and Yolo.

ROSBAG STORE

You may download a number of test and simulation data sets from Tier IV's ROSBAG STORE. Note that free accounts would not allow you to access image data due to privacy matters.

Map Tools

You may create 3D map data through Tier IV's Map Tools. The 3D map data used in Autoware are composed of point cloud structure data and vector feature data.

License

Autoware is provided under the Apache 2 License.

Contact

Autoware Developers Slack Team

Autoware Discourse

Please see the Support Guidelines for more details about getting help.