Particle Image Velocimetry Results

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): 1m (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: inumber of rows along y-axis</li> <li><strong>j:</strong> Dimensions of PIV results. Format: jnumber of columns along x-axis</li> <li><strong>k:</strong> Dimensions of PIV results. Format: knumber 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 (mnp) containing raw vector result type of frame (mn) 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 (mnp) containing filtered vector result type of frame (mn) 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 (mn) 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 (mnp) containing filtered u component velocities for each vector (mn) for each frame (p).</li> <li><strong>v_mean:</strong> Array (mn) 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 (mnp) containing filtered v component velocities for each vector (mn) for each frame (p).</li> <li><strong>x_ground:</strong> Array (mn) 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 (mn) containing the x (horizontal) pixel coordinate for each PIV result vector.</li> <li><strong>y_ground:</strong> Array (mn) 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 (mn) 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>

Data and Resources

Field Value
accessLevel public
bureauCode {010:12}
catalog_@context https://project-open-data.cio.gov/v1.1/schema/catalog.jsonld
catalog_conformsTo https://project-open-data.cio.gov/v1.1/schema
catalog_describedBy https://project-open-data.cio.gov/v1.1/schema/catalog.json
identifier USGS:61eb31cfd34e8b818ada914b
metadata_type geospatial
modified 20220214
old-spatial -114.94343, 32.71551, -70.2241, 44.0947
publisher U.S. Geological Survey
publisher_hierarchy Department of the Interior > U.S. Geological Survey
resource-type Dataset
source_datajson_identifier true
source_hash fa3ee06cc05f8f02d48624b8817c90badd1bfe94
source_schema_version 1.1
spatial {"type": "Polygon", "coordinates": [[[-114.94343, 32.71551], [-114.94343, 44.0947], [ -70.2241, 44.0947], [ -70.2241, 32.71551], [-114.94343, 32.71551]]]}
theme {geospatial}
Groups
  • AmeriGEOSS
  • National Provider
  • North America
Tags
  • acoustic-doppler-current-profiling
  • aerial-video
  • agua-fria-river-maricopa-county-arizona-usa
  • amerigeo
  • amerigeoss
  • androscoggin-river-androscoggin-county-maine-usa
  • auburn-androscoggin-county-maine-usa
  • ckan
  • coachella-canal-imperial-county-california-usa
  • cochiti-lake-reservoir-sandoval-county-new-mexico-usa
  • cochiti-main-canal-cochiti-lake-sandoval-county-new-mexico-usa
  • drone
  • geo
  • geoss
  • gila-river-yuma-county-arizona-usa
  • great-falls-androscoggin-county-maine-usa
  • hydrographic-datasets
  • imperial-valley-imperial-county-california-usa
  • inlandwaters
  • kinter-yuma-county-arizona-usa
  • national
  • north-america
  • remote-sensing
  • reservation-main-canal-imperial-county-california-usa
  • stream-discharge
  • stream-gage-measurement
  • streamflow
  • suas
  • united-states
  • unmanned-aircraft-system
  • unoccupied-aircraft-system
  • usgs-61eb31cfd34e8b818ada914b
  • usgs-science-data-catalog-sdc
  • videography
  • water-resources
isopen False
license_id notspecified
license_title License not specified
maintainer Frank L. Engel
maintainer_email fengel@usgs.gov
metadata_created 2025-11-21T23:24:20.188830
metadata_modified 2025-11-21T23:24:20.188834
notes 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): &lt;br&gt; &lt;ul&gt; &lt;li&gt;&lt;strong&gt;calibration_distance:&lt;/strong&gt; The distance between calibration points in meters.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;calibration_points:&lt;/strong&gt; Pixel coordinates of the calibration points. Format (array): [X1,Y1; X2; Y2]&lt;/li&gt; &lt;li&gt;&lt;strong&gt;calibration_time:&lt;/strong&gt; Time increment between image frames in milliseconds.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;caluv:&lt;/strong&gt; Correction factor used to convert pixel/second into meters/second.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;calxy:&lt;/strong&gt; Pixel ground resolution in meters/pixel.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;directory:&lt;/strong&gt; Path to folder containing images used in PIV analysis.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;filenames:&lt;/strong&gt; Cell array of strings containing image frame filenames. Format (cellarray): 1*m (m: number of frames)&lt;/li&gt; &lt;li&gt;&lt;strong&gt;imagesLocation:&lt;/strong&gt; Path to folder containing images used in PIV analysis.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;i:&lt;/strong&gt; Dimensions of PIV results. Format: i*number of rows along y-axis&lt;/li&gt; &lt;li&gt;&lt;strong&gt;j:&lt;/strong&gt; Dimensions of PIV results. Format: j*number of columns along x-axis&lt;/li&gt; &lt;li&gt;&lt;strong&gt;k:&lt;/strong&gt; Dimensions of PIV results. Format: k*number ofimages or frames in time (numbmer of images processed)&lt;/li&gt; &lt;li&gt;&lt;strong&gt;p:&lt;/strong&gt; PIVLab image pre-processing settings. See PIVLab documentation for information.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;pixel_resolution:&lt;/strong&gt; Pixel ground resolution in meters. Assumes square pixels.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;r:&lt;/strong&gt; PIVLab post-processing settings. See PIVLab documentation for information.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;resultsFileFullPath:&lt;/strong&gt; Path to folder containing PIV results in mat-file format.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;s:&lt;/strong&gt; PIVLab standard processing settings. See PIVLab documentation for information.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;typevector:&lt;/strong&gt; 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&lt;/li&gt; &lt;li&gt;&lt;strong&gt;typevector_filt:&lt;/strong&gt; 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&lt;/li&gt; &lt;li&gt;&lt;strong&gt;u_mean:&lt;/strong&gt; 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).&lt;/li&gt; &lt;li&gt;&lt;strong&gt;u_stack:&lt;/strong&gt; Array (m*n*p) containing filtered u component velocities for each vector (m*n) for each frame (p).&lt;/li&gt; &lt;li&gt;&lt;strong&gt;v_mean:&lt;/strong&gt; 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).&lt;/li&gt; &lt;li&gt;&lt;strong&gt;v_stack:&lt;/strong&gt; Array (m*n*p) containing filtered v component velocities for each vector (m*n) for each frame (p).&lt;/li&gt; &lt;li&gt;&lt;strong&gt;x_ground:&lt;/strong&gt; Array (m*n) containing the x (horizontal) ground coordinate in meters for each PIV result vector. Origin of coordinates is the lower left corner.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;x_pixel:&lt;/strong&gt; Array (m*n) containing the x (horizontal) pixel coordinate for each PIV result vector.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;y_ground:&lt;/strong&gt; Array (m*n) containing the y (horizontal) ground coordinate in meters for each PIV result vector. Origin of coordinates is the lower left corner.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;y_pixel:&lt;/strong&gt; Array (m*n) containing the y (horizontal) pixel coordinate for each PIV result vector.&lt;/li&gt; &lt;li&gt;&lt;strong&gt;zzVariableDescriptions:&lt;/strong&gt; A structured array containing elements named after each variable in this dataset.&lt;/li&gt; &lt;/ul&gt; &lt;br&gt; 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: &lt;ul&gt; &lt;li&gt;ACR: Androscoggin River, Auburn, Maine, USA&lt;/li&gt; &lt;li&gt;AFR: Agua Fria River, near Rock Springs, Arizona, USA&lt;/li&gt; &lt;li&gt;CCC: Coachella Canal above All-American Canal Diversion, California, USA&lt;/li&gt; &lt;li&gt;CMC: Cochiti East Side Main Channel, near Cochiti, New Mexico, USA&lt;/li&gt; &lt;li&gt;GLR: Gila River near Dome, Arizona, USA&lt;/li&gt; &lt;li&gt;RMC: Reservation Main Canal near Yuma, Arizona, USA&lt;/li&gt; &lt;li&gt;SMC: Sile Main Canal (at head) at Cochiti, New Mexico, USA&lt;/li&gt; &lt;li&gt;WMD: Wellton-Mohawk Main Outlet Drain near Yuma, Arizona, USA&lt;/li&gt; &lt;/ul&gt;
num_resources 2
num_tags 35
title Particle Image Velocimetry Results