Remotely sensed data from a reach of the Sacramento River near Glenn, California, used to perform Particle Image Velocimetry (PIV) within the Robot Operating System (ROS)
Dates
Acquisition
2022-09-16
Publication Date
2023-10-30
Citation
Legleiter, C.J., Dille, M., Dawson, C.B., and Kinzel, P.J., 2023, Remotely sensed data from a reach of the Sacramento River near Glenn, California, used to perform Particle Image Velocimetry (PIV) within the Robot Operating System (ROS): U.S. Geological Survey data release, https://doi.org/10.5066/P96BQQQ6.
Summary
This data release provides an example data set to accompany the manuscript titled "A Robot Operating System (ROS) package for mapping flow fields in rivers via Particle Image Velocimetry (PIV)", submitted to the journal Software X. This ROS *.bag file contains remotely sensed data acquired during an Uncrewed Aircraft System (UAS) flight along a reach of the Sacramento River near Glenn, California, USA, on September 16, 2022. Cooperators on this project include the Intelligent Robotics Group from the National Aeronautics and Space Administration (NASA) Ames Research Center and the National Oceanographic and Atmospheric Administration (NOAA) Southwest Fisheries Science Center. The file bag6xs600.bag contains a single topic named "/camera/image_raw" [...]
Summary
This data release provides an example data set to accompany the manuscript titled "A Robot Operating System (ROS) package for mapping flow fields in rivers via Particle Image Velocimetry (PIV)", submitted to the journal Software X. This ROS *.bag file contains remotely sensed data acquired during an Uncrewed Aircraft System (UAS) flight along a reach of the Sacramento River near Glenn, California, USA, on September 16, 2022. Cooperators on this project include the Intelligent Robotics Group from the National Aeronautics and Space Administration (NASA) Ames Research Center and the National Oceanographic and Atmospheric Administration (NOAA) Southwest Fisheries Science Center.
The file bag6xs600.bag contains a single topic named "/camera/image_raw" of the standard ROS message type sensor_msgs/Image. The individual messages published on this topic are frames acquired by an Allied Vision Mako G-503C color (RGB) camera at a rate of approximately 4 Hz. This camera was one of several included in an experimental payload designed for measuring streamflow. For this test flight, the payload was deployed from a DJI Matrice M600 hovering approximately 137 m above the river surface. The data are not geo-referenced but the pixel size of the images is approximately 0.078 m.
To simply view the data, the Foxglove Studio program linked below (https://foxglove.dev/download) provides a convenient platform. To actually read the bag file and perform PIV, please refer to the USGS GitLab repository for the ROSPIV network (https://code.usgs.gov/wma/osd/trivia/-/tree/ROSPIV/ROSPIV?ref_type=heads), which includes a document outlining how to set up ROS on a Windows computer, a user's guide for the ROSPIV network, and a demo script for illustrating its application using the bag file provided in this data release.
Legleiter, C. J., & Dille, M. (2024). A Robot Operating System (ROS) package for mapping flow fields in rivers via Particle Image Velocimetry (PIV). SoftwareX, 26, 101711. https://doi.org/10.1016/j.softx.2024.101711
For questions concerning this data set, please contact:
Dr. Carl J. Legleiter - cjl@usgs.gov
Observing Systems Division
United States Geological Survey
Purpose
The purpose of this study was to introduce a framework for performing Particle Image Velocimetry (PIV) analysis within the Robot Operating System (ROS) as an important first step toward enabling real-time mapping of river velocity fields in an embedded/edge computing environment. A reach of the Sacramento River near Glenn, California, was used as an example to illustrate the application of this approach in the context of a particular study site.
Rights
Any use of trade, firm, or product names is for descriptive purposes only and does not imply endorsement by the U.S. Government.
Preview Image
ROS bag file with image data from the Sacramento River displayed in Foxglove