ROS wrapper for the Azure Spatial Anchors Linux SDK, allowing robots (and other devices with vision-based sensors) to co-localize with other robots, AR-enabled phones, and Hololens devices.

Перейти к файлу

Helen Oleynikova 7d07ad86f0 Pull up versions.		2020-12-02 20:53:39 +01:00
asa_ros	Pull up versions.	2020-12-02 20:53:39 +01:00
asa_ros_msgs	Pull up versions.	2020-12-02 20:53:39 +01:00
docs/images	Staging initial release.	2020-10-24 15:06:32 +02:00
.gitignore	Staging initial release.	2020-10-24 15:06:32 +02:00
CODE_OF_CONDUCT.md	Initial CODE_OF_CONDUCT.md commit	2020-09-02 02:47:50 -07:00
LICENSE	Initial LICENSE commit	2020-09-02 02:47:51 -07:00
README.md	Update README.md	2020-10-25 11:19:33 +01:00
SECURITY.md	Initial SECURITY.md commit	2020-09-02 02:47:52 -07:00

README.md

Azure Spatial Anchors Linux SDK ROS Wrapper

This is a ROS wrapper for the Azure Spatial Anchors Linux SDK, allowing robots (and other devices equipped with a vision-based sensors and a pose estimation system) to create and query Azure Spatial Anchors, allowing the robot to co-localize with AR-enabled phones and Hololens devices.

This is presented as part of the IROS 2020 Tutorial on Mixed Reality and Robotics. Tutorial videos are available for free starting October 25th through IROS 2020.

You can sign up to get access to the Azure Spatial Anchors Linux SDK here: aka.ms/ASALinuxSDKSignup. This is REQUIRED to use this repo. It may take us up to 2 business days to add you. This requires an Azure Devops account.

You should have an Azure Spatial Anchors account in Azure to use this SDK and wrapper. Please see instructions for the ASA Quickstarts to create one. Keep the Account ID, and Account Key, and Account Domain nearby. This is free up to 10k queries/month.

Requirements

Ubuntu 18.04/20.04
ROS melodic or noetic
Azure Portal account with an Azure Spatial Anchors resource.
Azure Devops account account.
Signed up for Azure Spatial Anchors Linux SDK, which may take 1-2 days.

Input data requirements

Timeseries of:

Undistorted grayscale images
6 DoF poses of the cameras for the corresponding images
Camera intrinsics (focal length, principal point)

See this description of camera calibration for more details.

Get Started

See the Wiki for getting started and installation instructions.

Support

Check out the FAQ and Known Issues page on the Wiki first!

Please file an issue on the Github repo if it is not covered in the Wiki.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.