Particle Image Velocimetry Results

Dates

Publication Date: 2022-02-14
Time Period: 2021-09-20

Citation

Engel, F.L., Cadogan, A., and Duan, J.G., 2022, Small Unoccupied Aircraft System Imagery and Associated Data used for Discharge Measurement at Eight Locations Across the United States in 2019 and 2020: U.S. Geological Survey data release, https://doi.org/10.5066/P9H2MM1M.

Summary

This child item contains the Mathworks Matlab mat-file outputs from the scripts described in the Ancillary Scripts child item. Each file contains the results for a particular field site. See the FGDC metadata Process Steps section for more information about opening these files. The mat-files included here have a standard set of output variables and include a variable named "zzVariableDescriptions" in each mat-file which describes the contents of the file. The following variables and descriptions are included in each mat-file (extracted from the "zzVariableDescriptions" variable): calibration_distance: The distance between calibration points in meters. calibration_points: Pixel coordinates of the calibration points. Format (array): [...]

Summary

This child item contains the Mathworks Matlab mat-file outputs from the scripts described in the Ancillary Scripts child item. Each file contains the results for a particular field site. See the FGDC metadata Process Steps section for more information about opening these files. The mat-files included here have a standard set of output variables and include a variable named "zzVariableDescriptions" in each mat-file which describes the contents of the file. The following variables and descriptions are included in each mat-file (extracted from the "zzVariableDescriptions" variable):

calibration_distance: The distance between calibration points in meters.
calibration_points: Pixel coordinates of the calibration points. Format (array): [X1,Y1; X2; Y2]
calibration_time: Time increment between image frames in milliseconds.
caluv: Correction factor used to convert pixel/second into meters/second.
calxy: Pixel ground resolution in meters/pixel.
directory: Path to folder containing images used in PIV analysis.
filenames: Cell array of strings containing image frame filenames. Format (cellarray): 1*m (m: number of frames)
imagesLocation: Path to folder containing images used in PIV analysis.
i: Dimensions of PIV results. Format: i*number of rows along y-axis
j: Dimensions of PIV results. Format: j*number of columns along x-axis
k: Dimensions of PIV results. Format: k*number ofimages or frames in time (numbmer of images processed)
p: PIVLab image pre-processing settings. See PIVLab documentation for information.
pixel_resolution: Pixel ground resolution in meters. Assumes square pixels.
r: PIVLab post-processing settings. See PIVLab documentation for information.
resultsFileFullPath: Path to folder containing PIV results in mat-file format.
s: PIVLab standard processing settings. See PIVLab documentation for information.
typevector: Array (m*n*p) containing raw vector result type of frame (m*n) for each frame (p). Format: type 1-valid PIV vector; type 0-masked vector; type 2-invalid PIV vector
typevector_filt: Array (m*n*p) containing filtered vector result type of frame (m*n) for each frame (p). Format: type 1-valid PIV vector; type 0-masked vector; type 2-invalid PIV vector
u_mean: Array (m*n) containing the temporal average u component of velocity in meters/second. Values are averaged for every vector for each frame (along p dimension).
u_stack: Array (m*n*p) containing filtered u component velocities for each vector (m*n) for each frame (p).
v_mean: Array (m*n) containing the temporal average v component of velocity in meters/second. Values are averaged for every vector for each frame (along p dimension).
v_stack: Array (m*n*p) containing filtered v component velocities for each vector (m*n) for each frame (p).
x_ground: Array (m*n) containing the x (horizontal) ground coordinate in meters for each PIV result vector. Origin of coordinates is the lower left corner.
x_pixel: Array (m*n) containing the x (horizontal) pixel coordinate for each PIV result vector.
y_ground: Array (m*n) containing the y (horizontal) ground coordinate in meters for each PIV result vector. Origin of coordinates is the lower left corner.
y_pixel: Array (m*n) containing the y (horizontal) pixel coordinate for each PIV result vector.
zzVariableDescriptions: A structured array containing elements named after each variable in this dataset.

Each Field Site is abbreviated in various files in this data release. File and folder names are used to quickly identify which site a particular file or dataset represents. The following abbreviations are used:

ACR: Androscoggin River, Auburn, Maine, USA
AFR: Agua Fria River, near Rock Springs, Arizona, USA
CCC: Coachella Canal above All-American Canal Diversion, California, USA
CMC: Cochiti East Side Main Channel, near Cochiti, New Mexico, USA
GLR: Gila River near Dome, Arizona, USA
RMC: Reservation Main Canal near Yuma, Arizona, USA
SMC: Sile Main Canal (at head) at Cochiti, New Mexico, USA
WMD: Wellton-Mohawk Main Outlet Drain near Yuma, Arizona, USA

Child Items (1)

View children in Folder

Search children

Particle Image Velocimetry Results Images

Contacts

Point of Contact :: Frank L Engel
Process Contact :: Frank L Engel
Originator :: Frank L Engel, Ammon Cadogan, Jennifer Duan
Metadata Contact :: Frank L Engel
Publisher :: U.S. Geological Survey
Distributor :: U.S. Geological Survey - ScienceBase

Attached Files

sorting

Metadata First

Recent First

Alphabetical

Click on title to download individual files attached to this item.

Particle_Image_Velocimetry_Results.xml Original FGDC Metadata	View	20.47 KB	application/fgdc+xml
		19.12 MB	application/octet-stream
		7.65 MB	application/octet-stream
		74.67 MB	application/octet-stream
		88.88 MB	application/octet-stream
		50.9 MB	application/octet-stream
		173.13 MB	application/octet-stream
		173.13 MB	application/octet-stream
		337.71 MB	application/octet-stream
		475.04 MB	application/octet-stream

Purpose

These data were collected as part of a series of field experiments to test the validity of using small unoccupied aircraft systems (sUAS) to collect stream surface velocity and discharge measurements. This child item contains the resuting output files representing the calibrated PIV results for each field site.

Particle Image Velocimetry Results

Dates

Citation

Summary

Summary

Child Items (1)

View children in Folder

Search children

Contacts

Attached Files

sorting

Metadata First

Recent First

Alphabetical

Purpose

Map

Spatial Services

Communities

Tags

Provenance

Item Actions

View Item as ...

Save Item as ...

View Item...

Dates

Citation

Summary

Summary

Child Items (1) View children in Folder Search children

Contacts

Attached Files sorting Metadata First Recent First Alphabetical

Purpose

Map

Spatial Services

Communities

Tags

Provenance

Item Actions

View Item as ...

Save Item as ...

View Item...

Child Items (1)

View children in Folder

Search children

Attached Files

sorting

Metadata First

Recent First

Alphabetical