USGS CoastCam at Isla Verde, Puerto Rico: 2018-2019 Timestack Imagery and Coordinate Data

Metadata also available as - [Outline] - [Parseable text] - [XML]

Frequently anticipated questions:


What does this data set describe?

Title:
USGS CoastCam at Isla Verde, Puerto Rico: 2018-2019 Timestack Imagery and Coordinate Data
Abstract:
A digital video camera was installed at Isla Verde Beach in San Juan, Puerto Rico (PR) and faced northeast along the beach. Every hour during daylight hours, daily from February 1, 2019, to July 15, 2019, the camera collected raw video and produced snapshots and time-averaged image products. One such product is a "runup timestack". Runup timestacks are images created by sampling a cross-shore array of pixels from an image through time as waves propagate towards and run up a beach. Runup timestacks store the red, green, and blue or monochrome pixel intensity as a function of the cross-shore position as imagery for the sampling period, typically around 10 minutes. The images included in this data release were collected from February 8, 2019, to February 23, 2019. The camera is part of a U.S. Geological Survey (USGS) research project to study the beach and nearshore environment. USGS researchers analyzed the timestack imagery collected from this camera to remotely sense information such as the elevation of wave runup. This camera is part of the USGS CoastCam network, supported by the Total Water Level/Coastal Change Project under the Coastal and Marine Hazards and Resources Program (CMHRP). To learn more about this specific camera visit https://www.usgs.gov/centers/pcmsc/science/using-video-imagery-study-wave-dynamics-isla-verde.
Supplemental_Information:
The bounding coordinates below represent the limits of the rectified images from the CoastCam that covers the entirety of the beach at low tide and approximately 300 meters (m) directly in line of the camera facing alongshore. This dataset represents the timestack images (in Network Common Data Form format (netCDF, .nc)) collected from the Isla Verde CoastCam in 2019. More timestack images will be added to this release as they are processed.
  1. How might this data set be cited?
    Harrison, Shawn R., Buckley, Mark L., Mújica, Paco López, Logan, Joshua, Cheriton, Olivia, Viehman, T. Shay, Storlazzi, Curt D., Birchler, Justin J., Palmsten, Margaret L., Swanson, Eric, and Johnson, Emily L., 20240510, USGS CoastCam at Isla Verde, Puerto Rico: 2018-2019 Timestack Imagery and Coordinate Data:.

    This is part of the following larger work.

    Harrison, Shawn R., Buckley, Mark L., Mújica, Paco López, Logan, Joshua, Cheriton, Olivia, Viehman, T. Shay, Storlazzi, Curt D., Birchler, Justin J., Palmsten, Margaret L., Swanson, Eric, and Johnson, Emily L., 20240510, USGS CoastCam at Isla Verde, Puerto Rico: 2018-2019 Timestack Imagery and Coordinate Data: U.S. Geological Survey data release doi:10.5066/P13MJ66F, U.S. Geological Survey - St. Petersburg Coastal and Marine Science Center, St. Petersburg, Florida.

    Online Links:

  2. What geographic area does the data set cover?
    West_Bounding_Coordinate: -66.012003
    East_Bounding_Coordinate: -66.007598
    North_Bounding_Coordinate: 18.446538
    South_Bounding_Coordinate: 18.443801
  3. What does it look like?
  4. Does the data set describe conditions during a particular time period?
    Beginning_Date: 08-Feb-2019
    Ending_Date: 23-Feb-2019
    Currentness_Reference:
    ground condition
  5. What is the general form of this data set?
    Geospatial_Data_Presentation_Form: raster digital data
  6. How does the data set represent geographic features?
    1. How are geographic features stored in the data set?
      This is a Raster data set. It contains the following raster data types:
      • Dimensions, type Grid Cell
    2. What coordinate system is used to represent geographic features?
      Grid_Coordinate_System_Name: Universal Transverse Mercator
      Universal_Transverse_Mercator:
      UTM_Zone_Number: 20
      Transverse_Mercator:
      Scale_Factor_at_Central_Meridian: 0.9996
      Longitude_of_Central_Meridian: -63.0
      Latitude_of_Projection_Origin: 0.0
      False_Easting: 500000.0
      False_Northing: 0.0
      Planar coordinates are encoded using row and column
      Abscissae (x-coordinates) are specified to the nearest 1
      Ordinates (y-coordinates) are specified to the nearest 1
      Planar coordinates are specified in meters
      The horizontal datum used is NAD83 (National Spatial Reference System 2011) (EPSG:6318).
      The ellipsoid used is GRS 1980 (EPSG:7019).
      The semi-major axis of the ellipsoid used is 6378137.0.
      The flattening of the ellipsoid used is 1/298.257222101.
      Vertical_Coordinate_System_Definition:
      Altitude_System_Definition:
      Altitude_Datum_Name: Puerto Rico Vertical Datum of 2002
      Altitude_Resolution: 0.001
      Altitude_Distance_Units: meters
      Altitude_Encoding_Method: Attribute values
  7. How does the data set describe geographic features?
    Entity_and_Attribute_Overview:
    The Climate and Forecast (CF)-compliant metadata (version CF-1.6) in the header of each of the netCDF files provides spatial information for projecting the data into a Geographic Information System (GIS). It also provides information about the conventions used for attributes in the dataset. The column and row count are variable between the data files.
    Entity_and_Attribute_Detail_Citation:
    The entity and attribute information were generated by the individual and/or agency identified as the originator of the dataset. Please review the rest of the metadata record for additional details and information.

Who produced the data set?

  1. Who are the originators of the data set? (may include formal authors, digital compilers, and editors)
    • Shawn R. Harrison
    • Mark L. Buckley
    • Paco López Mújica
    • Joshua Logan
    • Olivia Cheriton
    • T. Shay Viehman
    • Curt D. Storlazzi
    • Justin J. Birchler
    • Margaret L. Palmsten
    • Eric Swanson
    • Emily L. Johnson
  2. Who also contributed to the data set?
  3. To whom should users address questions about the data?
    USGS SPCMSC Data Management Group
    U.S. Geological Survey - St. Petersburg Coastal and Marine Science Center
    600 4th Street South
    St. Petersburg, Florida
    USA

    727-502-8000 (voice)
    gs-g-spcmsc_data_inquiries@usgs.gov

Why was the data set created?

Data were obtained to document changes in shoreline position and coastal morphology. These data are intended for science researchers, students, policy makers, and the public. These data can be further processed to calculate wave runup. To ensure that USGS CMHRP data management protocols were followed, a USGS Field Activity Number was assigned (FAN) for this camera imagery collection: 2018-670-FA. Additional information about this FAN is available on the Coastal and Marine Geoscience Data System (CMGDS): https://cmgds.marine.usgs.gov/fan_info.php?fan=2018-670-FA.

How was the data set created?

  1. From what previous works were the data drawn?
    IslaVerdePR_c1_20181105_IO, IslaVerdePR_c1_20181106_EO, IslaVerdePR_XYZ_20181107 (source 1 of 2)
    Harrison, Shawn R., Buckley, Mark L., Mújica, Paco López, Logan, Joshua, Cheriton, Olivia, Viehman, T. Shay, Storlazzi, Curt D., Birchler, Justin J., Palmsten, Margaret L., Swanson, Eric, and Johnson, Emily L., 20240510, USGS CoastCam at Isla Verde, Puerto Rico: 2018-2019 Calibration and GNSS Topography Survey Data: U.S. Geological Survey, St. Petersburg, FL.

    Online Links:

    Type_of_Source_Media: JPEG, YAML, comma-delimited-text
    Source_Contribution:
    Images to solve camera intrinsic and extrinsic orientation along with solved parameters during imagery and timestack data collection at Isla Verde, PR. Global navigation satellite system (GNSS) survey data collected within the field-of-view of the camera used to generate a topo-bathymetric surface.
    lidar data (source 2 of 2)
    Survey, National Geodetic, 20240110, 2019 NOAA NGS Topobathy Lidar DEM: Puerto Rico: National Oceanic and Atmospheric Administration (NOAA), Charleston, SC.

    Online Links:

    Type_of_Source_Media: raster digital data
    Source_Contribution:
    Light detection and ranging (lidar) data used in the generation of a topo-bathymetric surface.
  2. How were the data generated, processed, and modified?
    Date: 05-Nov-2018 (process 1 of 4)
    Before mounting the CoastCam (c1) at the beach, the camera (FLIR BFLY-PGE-50S5C-C) was used to take intrinsic camera calibration images. Please refer to the IslaVerdePR_c1_20181105_IO zip file and the IslaVerdePR_c1_calibration_metadata record included in Harrison and others (2024) for access to the intrinsic camera calibration data and more information on the calibration process. After calibration was complete, the camera was mounted on a pole. The computer and camera were powered by a solar panel and battery. Data was transferred via cellular. Person who carried out this activity:
    Joshua Logan
    U.S. Geological Survey, Pacific Coastal and Marine Science Center
    2885 Mission Street
    Santa Cruz, CA
    USA

    831-460-7519 (voice)
    jlogan@usgs.gov
    Data sources used in this process:
    • IslaVerdePR_c1_20181105_IO
    Date: 2019 (process 2 of 4)
    The camera was programmed to collect three-band (RGB) images at 2 Hertz (Hz) for a total of approximately 10 minutes, every hour during daylight hours. The images included in this data release were collected from February 9, 2019, to February 23, 2019. Gaps exist in the dataset because not every image collected by the camera is being used in the dataset. Additionally, some images may have been obscured by water droplets, insects, birds, salt, sand and dirt, poor visibility from adverse weather conditions, or sun glare, and thus may not reflect the true state of the beach and ocean. Each hour the camera was activated, a timestack image product was produced by sampling intensity values at a single transect of pixels, defined by (U,V) pixel coordinates. The (U,V) sampling locations were determined by identifying a cross-shore transect of locations in local horizontal (X,Y) coordinate system, which aligned with the local shoreline orientation. The elevation of samples was chosen as Z = 0 m, which is an elevation assumed to be near the water line. The vertical reference frame was PRVD02 coordinate system. XYZ-sampling locations were projected into (U,V) image coordinates following established methods (Palmsten and Brodie, 2022; Bruder and Brodie, 2020) and using intrinsic (IslaVerdePR_c1_20181105_IO) and extrinsic (IslaVerdePR_c1_20181106_EO) camera calibration parameters from Harrison and others (2024). Person who carried out this activity:
    Justin J. Birchler
    U.S. Geological Survey
    600 4th Street South
    St. Petersburg, FL
    US

    727-502-8019 (voice)
    jbirchler@usgs.gov
    Data sources used in this process:
    • IslaVerdePR_c1_20181105_IO, IslaVerdePR_c1_20181106_EO
    Date: 2024 (process 3 of 4)
    The timestack images were converted to netCDF timestacks and processed to add additional information using the netCDF4 Python library version 1.6.2. The times of the collection, sampled at 2 Hz, were stored as a one-dimensional (1D) array, where each index of the array contained a time represented as epoch time, seconds elapsed since 00:00:00 UTC on January 1, 1970. The sampling locations, saved as local XYZ values, were stored as a two-dimensional array. Because pixels were stored assuming an elevation of Z = 0 m and the true beach surface may vary, an additional processing step was needed to project the sampling locations onto a topo-bathymetric surface representative of the beach at the time of the image data collection following previously described methods (Palmsten and Brodie, 2023; Holland and others, 1997). The topo-bathymetric surface was developed from GNSS survey data collected within the field-of-view of the camera (Harrison and others, 2024) and lidar (National Geodetic Survey, 2024). The point data was interpolated onto a grid using the method described by Plant and others (2002) with smoothing length scales of 1.5 m in the cross-shore direction and 3 m in the alongshore direction. The local (X,Y) coordinates were rotated and translated into UTM coordinates using information describing the local origin and rotation angle for the site. The (X,Y) coordinates were also translated from UTM to WGS84 latitude and longitude coordinates using the UTM Python library version 0.7.0. One netCDF(.nc) file was created for each timestack image using the netCDF Python library. The data included in each netCDF file includes the timestack image; the UV image coordinates, the XY coordinates in UTM; the XY local coordinates; the latitude and longitude coordinates; the Z-elevation coordinates projected onto the beach surface; and an array of the epoch times as previously described. Additional metadata was included in the netCDF files as global and variable attributes using the Climate and Forecast (CF)-compliant metadata convention (version CF-1.6). These attributes describe the data collection, as well as how the different coordinate systems are used within the data. Person who carried out this activity:
    Mark L. Buckley
    U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center
    Research Oceanographer
    600 4th Street South
    St. Petersburg, FL
    USA

    727-502-8024 (voice)
    mbuckley@usgs.gov
    Date: 2024 (process 4 of 4)
    A total of 15 netCDF timestack files (*.nc) are included in this release and can be viewed and downloaded on the data release webpage. The netCDF files were renamed using the following convention, with ten period-separated elements: 1) the epoch time--seconds elapsed since 00:00:00 UTC on January 1 1970--the timestack was collected 2) The day of the week the timestack was collected, abbreviated to three letters 3) The month the timestack was collected, abbreviated to three letters 4) The date when the timestack was collected in the format dd_hh_mm_ss where 'dd' is the day of the month, 'hh' is the hour in 24-hour format, 'mm' is the minute, and 'ss' is the second 5) The timezone for date previously described 6) The year the timestack was collected 7) The site nickname where the timestack was collected 8) The camera the timestack was collected from, where 'cx' represents the timestack image 9) the name of the transect sampled to create the timestack 10) the file extension, .nc. An example of a filename formatted in this way would be 1549623660.Fri.Feb.08_11_01_00.GMT.2019.islaverde.cx.runup01.nc. Person who carried out this activity:
    USGS SPCMSC Data Management Group
    U.S. Geological Survey - St. Petersburg Coastal and Marine Science Center
    600 4th Street South
    St. Petersburg, FL
    USA

    727-502-8000 (voice)
    gs-g-spcmsc_data_inquiries@usgs.gov
    Data sources used in this process:
    • netCDF timestacks
    Data sources produced in this process:
    • *.nc
  3. What similar or related data should the user be aware of?
    Bruder, Brittany L., and Brodie, Katherine L., 20200909, CIRN Quantitative Coastal Imaging Toolbox: SoftwareX Volume 12, 100582, Elsevier, Online.

    Online Links:

    Holland, K. Todd, Holman, Robert A., Lippmann, Thomas C., Stanley, John, and Plant, Nathaniel, 19970101, Practical Use of Video Imagery in Nearshore Oceanographic Field Studies: IEEE Journal of Oceanic Engineering Volume 22, Issue 1, IEEE, Online.

    Online Links:

    Holman, Robert A., and Stanley, John, 20070416, The History and Technical Capabilities of Argus: Coastal Engineering Volume 54, Issues 6–7, Elsevier, Online.

    Online Links:

    Palmsten, Margaret L., and Brodie, Katherine L., 20220118, The Coastal Imaging Research Network (CIRN): Remote Sensing Volume 14, Issues 3, MDPI, Online.

    Online Links:

    Plant, Nathaniel G., Holland, K.Todd, and Puleo, Jack A., 20021005, Analysis of the Scale of Errors in Nearshore Bathymetric Data: Marine Geology Volume 191, Issues 1–2, Elsevier, Online.

    Online Links:


How reliable are the data; what problems remain in the data set?

  1. How well have the observations been checked?
    The video camera collected 5-megapixel images, with file sizes generally between 0.08 and 0.65 megabytes (MB) on disc. Images may be obscured by water droplets, insects, birds, salt, sand and dirt, poor visibility from adverse weather conditions or sun glare, and thus may not reflect the true state of the beach and ocean.
  2. How accurate are the geographic locations?
    The post-processed kinematic (PPK) data collected in field activity 2018-670-FA were used to validate the extrinsic camera calibration using corrections referenced to the National Geodetic Survey (NGS) Continuously Operating Base Station (CORS), ZSU4, located approximately 2.5 kilometers from the study area (https://geodesy.noaa.gov/CORS/). The mean reported horizontal precision of these measurements was 0.020 meters (with a standard deviation of 0.003 meters). The magnitude of additional errors resulting from uncertainty in the base station reference position, errors in tripod centering, and antenna height measurement errors are unknown. The precise locations of the targets are used in the CIRN Quantitative Coastal Imaging Toolbox steps B and C (Bruder and Brodie, 2020). Horizontal coordinates are referenced to the North American Datum of 1983 (National Spatial Reference System 2011) Universal Transverse Mercator Zone 20 North (NAD83(2011)/UTM Zone 20N) coordinate system, with a resolution of 0.001 meters.
  3. How accurate are the heights or depths?
    The PPK data collected in field activity 2018-670-FA were used to validate the extrinsic camera calibration using corrections referenced to the National Geodetic Survey (NGS) Continuously Operating Base Station (CORS), ZSU4, located approximately 2.5 kilometers from the study area (https://geodesy.noaa.gov/CORS/). The mean reported vertical precision of these measurements was 0.045 meters (with a standard deviation of 0.011 meters). The magnitude of additional errors resulting from uncertainty in the base station reference position, errors in tripod centering, and antenna height measurement errors are unknown. The precise locations of the targets are used in the CIRN Quantitative Coastal Imaging Toolbox steps B and C (Bruder and Brodie, 2020). Vertical positions are referenced to the Puerto Rico Vertical Datum of 2002 (PRVD02; EPSG:1123), derived using GEOID12B, coordinate system, with a resolution of 0.001 meters.
  4. Where are the gaps in the data? What is missing?
    The imagery represents a fixed location at Isla Verde, PR. Images may not be available every hour of operation due to camera malfunction. Images may be obscured by water droplets, insects, birds, salt, sand and dirt, poor visibility from adverse weather conditions or sun glare, and thus may not reflect the true state of the beach and ocean. This product is considered complete for the information presented, as described in the abstract. Users are advised to read the rest of the metadata record carefully for additional details.
  5. How consistent are the relationships among the observations, including topology?
    The camera system installed (FLIR BFLY-PGE-50S5C-C) was programmed to collect three-band images every hour during daylight hours and take video for approximately 10 minutes. A timestack image for the 10-minute period was created by sampling a single transect on the beach.

How can someone get a copy of the data set?

Are there legal restrictions on access or use of the data?
Access_Constraints None
Use_Constraints Public domain data from the U.S. Government are freely redistributable with proper metadata and source attribution. Please recognize the U.S. Geological Survey (USGS) as the source of this information.
  1. Who distributes the data set? (Distributor 1 of 1)
    USGS SPCMSC Data Management Group
    U.S. Geological Survey - St. Petersburg Coastal and Marine Science Center
    600 4th Street South
    St. Petersburg, Florida
    USA

    727-502-8000 (voice)
    gs-g-spcmsc_data_inquiries@usgs.gov
  2. What's the catalog number I need to order this data set? *.nc
  3. What legal disclaimers am I supposed to read?
    This digital publication was prepared by an agency of the United States Government. Although these data have been processed successfully on a computer system at the U.S. Geological Survey, no warranty expressed or implied is made regarding the display or utility of the data on any other system, nor shall the act of distribution imply any such warranty. The U.S. Geological Survey shall not be held liable for improper or incorrect use of the data described and (or) contained herein. Reference herein to any specific commercial product, process, or service by trade name, trademark, manufacturer, or otherwise does not constitute or imply its endorsement, recommendation, or favoring by the United States Government or any agency thereof.
  4. How can I download or order the data?
    • Availability in digital form:
      Data format: The data download file is compressed and must be unzipped using software such as WinZip, 7zip, Peazip or pkUnzip before use. in format NetCDF (version 4.3) *.nc is a netCDF file that contains timestack imagery; elevations, in meters; and, coordinate information, in Easting and Northing, longitude and latitude degrees, and local grid coordinates, measured in meters. The netCDF files can be downloaded in the zip files listed in the Network_Resource_Name link below.
      Network links: https://coastal.er.usgs.gov/data-release/P13MJ66F/data/IslaVerde_c1_timestacks.zip
    • Cost to order the data: None


Who wrote the metadata?

Dates:
Last modified: 10-May-2024
Metadata author:
USGS SPCMSC Data Management Group
U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center
600 4th Street South
Saint Petersburg, FL
USA

727-502-8000 (voice)
gs-g-spcmsc_data_inquiries@usgs.gov
Metadata standard:
Content Standard for Digital Geospatial Metadata (FGDC-STD-001-1998)

This page is <https://cmgds.marine.usgs.gov/catalog/spcmsc/IslaVerdePR_c1_timestacks_metadata.faq.html>
Generated by mp version 2.9.51 on Fri May 10 09:48:24 2024