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.

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

Jeff Delmerico 35cfc4ae0f Merge pull request #32 from microsoft/jeffdelmerico-patch-1 Add retirement announcement to README.		2024-11-05 18:25:03 +01:00
asa_ros	CMakeLists was not using catkin simple to add libraries. As such the public methods were not callable from an outside node as intended.	2022-06-29 11:06:06 -05:00
asa_ros_msgs	Modified FindAnchors.srv to specify multiple IDs using a vector.	2022-01-24 10:10:55 -06: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	Add bit about archiving repo.	2024-11-05 18:10:48 +01:00
SECURITY.md	Initial SECURITY.md commit	2020-09-02 02:47:52 -07:00

README.md

The underlying service "Azure Spatial Anchors (ASA)" that this ROS wrapper uses will be retired on November 20th 2024 (see announcement). After this date the ASA inux SDK and this ROS wrapper will no longer work. This repo will also be archived after this retirement date. We thank you for being part of this research-preview!

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 was presented as part of the IROS 2020 Tutorial on Mixed Reality and Robotics. The tutorial was available from October 2020 until January 2021 at https://www.iros2020.org/.

The lecture content of the tutorial is now available as a Microsoft Research Webinar: https://note.microsoft.com/MSR-Webinar-Reality-and-Robotics-Registration-On-Demand.html

The hands-on video walkthroughs for the demos are available on the MSR YouTube channel:

Demo 1: Interaction (the demo that uses the sample code in this repo)
Demo 2: Colocalization (the demo that goes with this repo and is described in the wiki)

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.

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.
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.