indoor_localization

A ROS Package using Apriltags & IMU to Estimate Pose Indoors

This package combines the usb_cam, apriltags2_ros, phidgets_imu, and robot_pose_ekf packages to produce a robot pose estimation using visual odometry through apriltags and inertial odometry from a phidgets IMU.

Image 1: example development platform with Phidget IMU and Webcam

documentation

Apriltag Setup

Print out 17.5 in * 17.5 in tags with a pixel-width border around them from the 36h11 april tag set (link. The file used in testing is included in the repository as ceilingtag.ai(link).
Place tags on ceiling tiles above the area in which the platform will operate.

Placement is limited to blank ceiling tiles that can be fully removed, as successfully attaching the tags requires taping to the backside of the tiles. All tags must be placed in line with a single coordinate system.
In AC227 (as of Spring 2019), the tags are oriented with the x-axis pointed away from the doorway and the y-axis pointed towards the rear of the room.

Image 2: example of ceiling tile-mounted april tags

Apriltag Calibration

Follow the instructions for apriltag bundle calibration (link).

Ensure that you measure the tags that you have printed, as the printer may not recreate them in your specified size.
After running the rosbag command, make sure that you move the resulting .bag file into the correct folder such that the Matlab script can find it.
In step 2, when running the Matlab script, if you receive an error saying that Matlab cannot find the file specified, make sure that the names match up between the script and the file.
Use the output from the file to update indoor_localization/config/apriltags.yaml.

Camera Calibration

Follow the instructions for monocular camera calibration (link).

Upon creating the .yml file in step 7, move the file to indoor_localization/camera_info/<camera_name.yml>, Then update the camera_info_url parameter in camera.launch.
The image_rect node is already launched in camera.launch, so you don't have to worry about image rectification.

Authors

This package was built by Connor Novak (20') and Kawin Nikomborirak (21') for the Ground Robotic Autonomous Vehicle Laboratory (link).

tienhoangvan / indoor_localization Goto Github PK