Skip to main content
U.S. flag

An official website of the United States government

This site is currently in beta, and your feedback is helping shape its ongoing development.

Particle Image Velocimetry Results

Published by U.S. Geological Survey | Department of the Interior | Metadata Last Checked: January 27, 2026 | Last Modified: 2022-02-14T00:00:00Z
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): <br> <ul> <li><strong>calibration_distance:</strong> The distance between calibration points in meters.</li> <li><strong>calibration_points:</strong> Pixel coordinates of the calibration points. Format (array): [X1,Y1; X2; Y2]</li> <li><strong>calibration_time:</strong> Time increment between image frames in milliseconds.</li> <li><strong>caluv:</strong> Correction factor used to convert pixel/second into meters/second.</li> <li><strong>calxy:</strong> Pixel ground resolution in meters/pixel.</li> <li><strong>directory:</strong> Path to folder containing images used in PIV analysis.</li> <li><strong>filenames:</strong> Cell array of strings containing image frame filenames. Format (cellarray): 1*m (m: number of frames)</li> <li><strong>imagesLocation:</strong> Path to folder containing images used in PIV analysis.</li> <li><strong>i:</strong> Dimensions of PIV results. Format: i*number of rows along y-axis</li> <li><strong>j:</strong> Dimensions of PIV results. Format: j*number of columns along x-axis</li> <li><strong>k:</strong> Dimensions of PIV results. Format: k*number ofimages or frames in time (numbmer of images processed)</li> <li><strong>p:</strong> PIVLab image pre-processing settings. See PIVLab documentation for information.</li> <li><strong>pixel_resolution:</strong> Pixel ground resolution in meters. Assumes square pixels.</li> <li><strong>r:</strong> PIVLab post-processing settings. See PIVLab documentation for information.</li> <li><strong>resultsFileFullPath:</strong> Path to folder containing PIV results in mat-file format.</li> <li><strong>s:</strong> PIVLab standard processing settings. See PIVLab documentation for information.</li> <li><strong>typevector:</strong> 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</li> <li><strong>typevector_filt:</strong> 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</li> <li><strong>u_mean:</strong> 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).</li> <li><strong>u_stack:</strong> Array (m*n*p) containing filtered u component velocities for each vector (m*n) for each frame (p).</li> <li><strong>v_mean:</strong> 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).</li> <li><strong>v_stack:</strong> Array (m*n*p) containing filtered v component velocities for each vector (m*n) for each frame (p).</li> <li><strong>x_ground:</strong> Array (m*n) containing the x (horizontal) ground coordinate in meters for each PIV result vector. Origin of coordinates is the lower left corner.</li> <li><strong>x_pixel:</strong> Array (m*n) containing the x (horizontal) pixel coordinate for each PIV result vector.</li> <li><strong>y_ground:</strong> Array (m*n) containing the y (horizontal) ground coordinate in meters for each PIV result vector. Origin of coordinates is the lower left corner.</li> <li><strong>y_pixel:</strong> Array (m*n) containing the y (horizontal) pixel coordinate for each PIV result vector.</li> <li><strong>zzVariableDescriptions:</strong> A structured array containing elements named after each variable in this dataset.</li> </ul> <br> 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: <ul> <li>ACR: Androscoggin River, Auburn, Maine, USA</li> <li>AFR: Agua Fria River, near Rock Springs, Arizona, USA</li> <li>CCC: Coachella Canal above All-American Canal Diversion, California, USA</li> <li>CMC: Cochiti East Side Main Channel, near Cochiti, New Mexico, USA</li> <li>GLR: Gila River near Dome, Arizona, USA</li> <li>RMC: Reservation Main Canal near Yuma, Arizona, USA</li> <li>SMC: Sile Main Canal (at head) at Cochiti, New Mexico, USA</li> <li>WMD: Wellton-Mohawk Main Outlet Drain near Yuma, Arizona, USA</li> </ul>

Complete Metadata

data.gov

An official website of the GSA's Technology Transformation Services

Looking for U.S. government information and services?
Visit USA.gov