<?xml version="1.0" encoding="UTF-8"?>
<metadata>
  <idinfo>
    <citation>
      <citeinfo>
        <origin>Justin J. Birchler</origin>
        <origin>Margaret L. Palmsten</origin>
        <origin>Priscila Vargas-Babilonia</origin>
        <origin>Eric Swanson</origin>
        <origin>Mark L. Buckley</origin>
        <pubdate>20250402</pubdate>
        <title>USGS CoastCam at Dorado, Puerto Rico: 2022-2023 Intrinsic and Extrinsic Calibration Data (Camera 1)</title>
        <edition>1.0</edition>
        <geoform>tabular digital data, raster digital data</geoform>
        <lworkcit>
          <citeinfo>
            <origin>Justin J. Birchler</origin>
            <origin>Margaret L. Palmsten</origin>
            <origin>Priscila Vargas-Babilonia</origin>
            <origin>Eric Swanson</origin>
            <origin>Mark L. Buckley</origin>
            <pubdate>20250402</pubdate>
            <title>USGS CoastCam at Dorado, Puerto Rico: 2022-2023 Calibration Data</title>
            <edition>1.0</edition>
            <serinfo>
              <sername>U.S. Geological Survey data release</sername>
              <issue>doi:10.5066/P13CYA5A</issue>
            </serinfo>
            <pubinfo>
              <pubplace>St. Petersburg, Florida</pubplace>
              <publish>U.S. Geological Survey - St. Petersburg Coastal and Marine Science Center</publish>
            </pubinfo>
            <onlink>https://doi.org/10.5066/P13CYA5A</onlink>
          </citeinfo>
        </lworkcit>
      </citeinfo>
    </citation>
    <descript>
      <abstract>Two digital video cameras were installed at Dorado, Puerto Rico (PR); camera 1 faced west alongshore and camera 2 faced northeast alongshore. Every hour during daylight hours, daily starting in August 2022, the cameras collected raw video and produced snapshots and time-averaged image products. This metadata record is for camera 1 and includes the necessary intrinsic orientation (IO) and extrinsic orientation (EO) calibration data to utilize imagery to make quantitative measurements. The initial IO calibration was completed during a previous camera installation (Brown and others, 2024), a second IO calibration was completed during this deployment period. The cameras are part of a U.S. Geological Survey (USGS) research project to study the beach and nearshore environment. USGS researchers analyzed the imagery collected from this camera to remotely sense a range of information including shoreline position, sandbar migration, wave run-up on the beach, alongshore currents, and nearshore bathymetry. This camera is part of the USGS CoastCam network.</abstract>
      <purpose>These data can be utilized to produce orthorectified products that can be viewed in a geographic information system (GIS) or other software to identify topographic and shallow-water bathymetric features. See the image processing toolbox developed by Bruder and Brodie (2020) for more information. To ensure that USGS-St. Petersburg Coastal and Marine Science Center data management protocols were followed, a USGS field activity number (FAN) was assigned for this survey; 2022-330-FA. Additional information about this FAN is available on the Coastal and Marine Geoscience Data System (CMGDS): https://cmgds.marine.usgs.gov/services/activity.php?fan=2022-330-FA.</purpose>
      <supplinf>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 the adjacent nearshore area approximately 520 meters (m) directly in line of camera 1 facing alongshore. The initial intrinsic calibration photos were taken during a previous camera installation (Brown and others, 2024). A second set of intrinsic calibration photos were taken on 20230314 (YYYYMMDD) and their location information is not consequential.</supplinf>
    </descript>
    <timeperd>
      <timeinfo>
        <mdattim>
          <sngdate>
            <caldate>20220811</caldate>
          </sngdate>
          <sngdate>
            <caldate>20221207</caldate>
          </sngdate>
          <sngdate>
            <caldate>20230314</caldate>
          </sngdate>
          <sngdate>
            <caldate>20230322</caldate>
          </sngdate>
        </mdattim>
      </timeinfo>
      <current>ground condition</current>
    </timeperd>
    <status>
      <progress>Complete</progress>
      <update>None planned</update>
    </status>
    <spdom>
      <bounding>
        <westbc>-66.289560</westbc>
        <eastbc>-66.284422</eastbc>
        <northbc>18.475125</northbc>
        <southbc>18.470166</southbc>
      </bounding>
    </spdom>
    <keywords>
      <theme>
        <themekt>USGS Metadata Identifier</themekt>
        <themekey>USGS:9c8a00be-de55-408b-8c2b-802a6e4d6461</themekey>
      </theme>
      <theme>
        <themekt>ISO 19115 Topic Category</themekt>
        <themekey>geoscientificInformation</themekey>
        <themekey>environment</themekey>
      </theme>
      <theme>
        <themekt>USGS Thesaurus</themekt>
        <themekey>image analysis</themekey>
        <themekey>field methods</themekey>
        <themekey>video monitoring</themekey>
        <themekey>optical methods</themekey>
        <themekey>ecosystem management</themekey>
        <themekey>photography</themekey>
        <themekey>remote sensing</themekey>
        <themekey>image collections</themekey>
        <themekey>geomorphology</themekey>
        <themekey>ocean sciences</themekey>
        <themekey>coastal processes</themekey>
      </theme>
      <theme>
        <themekt>None</themekt>
        <themekey>U.S Geological Survey</themekey>
        <themekey>USGS</themekey>
        <themekey>Coastal and Marine Hazards and Resources Program</themekey>
        <themekey>CMHRP</themekey>
        <themekey>St. Petersburg Coastal and Marine Science Center</themekey>
        <themekey>SPCMSC</themekey>
        <themekey>CoastCam</themekey>
        <themekey>Total Water Level</themekey>
      </theme>
      <place>
        <placekt>Geographic Names Information System (GNIS)</placekt>
        <placekey>Atlantic Ocean</placekey>
        <placekey>Puerto Rico</placekey>
        <placekey>Dorado</placekey>
      </place>
    </keywords>
    <accconst>No access constraints. Please see 'Distribution Information' for details.</accconst>
    <useconst>These data are marked with a Creative Common CC0 1.0 Universal License. These data are in the public domain and do not have any use constraints. Users are advised to read the dataset's metadata thoroughly to understand appropriate use and data limitations.</useconst>
    <ptcontac>
      <cntinfo>
        <cntperp>
          <cntper>Justin J. Birchler</cntper>
          <cntorg>U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center</cntorg>
        </cntperp>
        <cntpos>Physical Scientist</cntpos>
        <cntaddr>
          <addrtype>mailing and physical</addrtype>
          <address>600 4th Street South</address>
          <city>Saint Petersburg</city>
          <state>FL</state>
          <postal>33701</postal>
          <country>USA</country>
        </cntaddr>
        <cntvoice>727-502-8000</cntvoice>
        <cntemail>jbirchler@usgs.gov</cntemail>
      </cntinfo>
    </ptcontac>
    <browse>
      <browsen>dorado_c1_calibrationIOEO_exampleImagery.zip</browsen>
      <browsed>Zip file containing the following examples: A) Image used in IO calibration (c1_20230314_IO_0002_186E0B6F76B.tiff) and B) Image used in EO calibration (dorado_c1_20221207_GCP_image_annotated.jpg) and the target numbers for use in the Coastal Imaging Research Network (CIRN) Quantitative Coastal Imaging Toolbox (QCIT) that correspond to the numbers in dorado_c1_20221207_EO_GCPsurvey.csv (file available in dorado_c1_20221207_EO.zip).</browsed>
      <browset>Tagged Imaged File Format (TIFF), Joint Photographic Experts Group (JPG)</browset>
    </browse>
    <native>Environment as of metadata creation: Microsoft Windows 10 Enterprise Version 22H2; PyExifTool Python library (https://pypi.org/project/PyExifTool/) version 0.5.5; pyexiv2 Python library (https://python3-exiv2.readthedocs.io/en/latest/) version 2.7.1; ExifTool (https://exiftool.org/) version 12.39; MathWorks MATLAB R2024a (https://www.mathworks.com/products/matlab.html).</native>
    <crossref>
      <citeinfo>
        <origin>Jenna A. Brown</origin>
        <origin>Margaret L. Palmsten</origin>
        <origin>Eric Swanson</origin>
        <pubdate>20240726</pubdate>
        <title>USGS CoastCam at DUNEX: Calibration Data</title>
        <geoform>publication</geoform>
        <serinfo>
          <sername>U.S. Geological Survey data release</sername>
          <issue>doi:10.5066/P1GDP4HR</issue>
        </serinfo>
        <pubinfo>
          <pubplace>St. Petersburg, FL</pubplace>
          <publish>U.S. Geological Survey - St. Petersburg Coastal and Marine Science Center</publish>
        </pubinfo>
        <onlink>https://doi.org/10.5066/P1GDP4HR</onlink>
      </citeinfo>
    </crossref>
    <crossref>
      <citeinfo>
        <origin>Brittany L. Bruder</origin>
        <origin>Katherine L. Brodie</origin>
        <pubdate>20200909</pubdate>
        <title>CIRN Quantitative Coastal Imaging Toolbox</title>
        <geoform>publication</geoform>
        <pubinfo>
          <pubplace>Online</pubplace>
          <publish>Elsevier SoftwareX</publish>
        </pubinfo>
        <onlink>https://doi.org/10.1016/j.softx.2020.100582</onlink>
      </citeinfo>
    </crossref>
    <crossref>
      <citeinfo>
        <origin>Jean-Yves Bouguet</origin>
        <pubdate>20220504</pubdate>
        <title>Camera Calibration Toolbox for Matlab</title>
        <edition>1.0</edition>
        <geoform>publication</geoform>
        <pubinfo>
          <pubplace>Online</pubplace>
          <publish>CaltechDATA</publish>
        </pubinfo>
        <onlink>https://doi.org/10.22002/D1.20164</onlink>
      </citeinfo>
    </crossref>
  </idinfo>
  <dataqual>
    <attracc>
      <attraccr>EO calibration ground control points (GCPs) were surveyed with Spectra Geospatial SP80 and SP90 Differential Global Positioning System (DGPS) Post-Processed Kinematic (PPK) receivers. Calibration success can be examined using the CIRN QCIT Toolbox (Bruder and Brodie, 2020) where parameters azimuth, tilt, and roll have errors less than 2 degrees. Accuracy of the extrinsic calibration was also tied to human ability to locate targets in the imagery. The camera systems were liable to move over time via wind, wear, and human interactions cleaning the camera - all of which may change the camera calibration parameters. The parameters are stored in YML files named with the date first active.</attraccr>
    </attracc>
    <logic>The camera systems installed (FLIR BlackFly S GigE 12MP) had intrinsic and extrinsic calibration processes. The IO calibration process was completed two times. The initial IO calibration process was completed on 20210914 during a previous camera installation (Brown and others, 2024). This IO calibration was relevant at the Dorado, PR site from 20220811 to 20230321. The second IO calibration process was completed on 20230314 and is relevant starting 20230322. The 20230314 IO calibration consists of a total of 202 images for c1. Of the 202 images for c1, 23 images that collectively covered the entire image frame were selected to solve for the intrinsic calibration, using the Camera Calibration Toolbox (Bouguet, 2022). These photos are listed in c1_20230314_IO_calibratedImageSet.txt. These photos are used in the CIRN QCIT Toolbox steps A through C. The EO process was completed on 20220811, 20221207, and 20230322 and each date consists of a YML file of resultant EO parameters, a comma-separated values (CSV) file of GCP locations and description, and two JPG images, one labeled as 'raw' and the other as 'annotated'. The extrinsic calibration uses one "snap" photo with GCP targets that have pre-established location information. Results of the intrinsic and extrinsic calibrations are stored in separate YML files (dorado_c1_20230314_IO.yml, dorado_c1_20220811_EO.yml, dorado_c1_20221207_EO.yml, and dorado_c1_20230322_EO.yml).</logic>
    <complete>All calibration images are provided, even if all images were not necessary for calibrating the camera.</complete>
    <posacc>
      <horizpa>
        <horizpar>PPK equipment with decimeter horizontal accuracy collected in field activity 2022-330-FA were used to validate the extrinsic camera calibration. The precise locations of the targets are used in the CIRN QCIT 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 19 North (NAD83(2011)/UTM Zone 19N) coordinate system.</horizpar>
      </horizpa>
      <vertacc>
        <vertaccr>PPK equipment with centimeter vertical accuracy collected in field activity 2022-330-FA were used to validate the extrinsic camera calibration. The precise locations of the targets are used in the CIRN QCIT Toolbox steps B and C (Bruder and Brodie, 2020). Vertical positions are referenced to the Puerto Rico Vertical Datum of 2002 (PRVD02) coordinate system.</vertaccr>
      </vertacc>
    </posacc>
    <lineage>
      <procstep>
        <procdesc>The CoastCam was used to take IO photos. This involves slightly tilting a printed checkerboard with 2.9-centimeter (cm) squares in various parts of the camera's field of view. An example image can be found in dorado_c1_calibrationIOEO_exampleImagery.zip. There are a total of 202 IO images for c1 (dorado_c1_20230314_IO.zip) of which 23 were used for the intrinsic calibration (Bouguet, 2022). The filenames of all, calibrated, and excluded images are listed in separate text files. The output from the calibration was used in step A in the Camera Calibration procedures outlined in Bruder and Brodie (2020). The resultant parameters are stored in a YML file located in dorado_c1_20230314_IO.zip. Image file naming format follows "c1_20230314_IO_####_###########", where c1 is the camera name, 20230314 is the date the images were taken (YYYYMMDD format), IO is Intrinsic Orientation, and ####_########### is the unique ID from the camera.</procdesc>
        <procdate>20230314</procdate>
        <srcprod>c1_20230314_IO_####_###########.tiff</srcprod>
        <srcprod>dorado_c1_20230314_IO.yml</srcprod>
        <srcprod>c1_20230314_IO_wholeImageSet.txt</srcprod>
        <srcprod>c1_20230314_IO_calibratedImageSet.txt</srcprod>
        <srcprod>c1_20230314_IO_excludedImageSet.txt</srcprod>
        <proccont>
          <cntinfo>
            <cntperp>
              <cntper>Justin J. Birchler</cntper>
              <cntorg>U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center</cntorg>
            </cntperp>
            <cntpos>Physical Scientist</cntpos>
            <cntaddr>
              <addrtype>mailing and physical</addrtype>
              <address>600 4th Street South</address>
              <city>Saint Petersburg</city>
              <state>FL</state>
              <postal>33701</postal>
              <country>USA</country>
            </cntaddr>
            <cntvoice>727-502-8000</cntvoice>
            <cntemail>jbirchler@usgs.gov</cntemail>
          </cntinfo>
        </proccont>
      </procstep>
      <procstep>
        <procdesc>EO calibration GCPs were surveyed with Spectra Geospatial SP80 and SP90 DGPS PPK receivers. GCPs were collected three times after the camera had been operational (20220811, 20221207, and 20230322). To place the photos taken by the CoastCam into real world coordinates and to rectify them into a planar view, objects within the field of view of the camera must be located. To do so, the elevation and position of the lenses in the CoastCam setup were measured with the PPK GPS. Then, a 1.2-meter square target with white and black color in opposite quadrants was propped up to face the CoastCam setup. The bottom center of the target (between black and white) where it met the beach surface was measured with the PPK GPS equipment to collect ground control points. The CoastCam took pictures of the position of each target within the camera view (raw JPG images). The images were then digitally combined so that all GCPs would appear on a single image. The survey locations of the GCPs in the CSV file were used to hand label the raw images to generate annotated images so that the targets could be labeled correctly in Step B of the Camera Calibration steps in Bruder and Brodie (2020). The pixel coordinates of each GCP within the raw image (hand-selected), solved in Step B of Bruder and Brodie (2020), the GPS positions from the CSV file, and the IO parameters in the IO YML file were used in Step C of the Camera Calibration steps in Bruder and Brodie (2020) to solve for the EO parameters. The resultant parameters for each of the three EO calibration dates are stored in a YML file located in "dorado_c1_YYYYMMDD_EO.zip", where YYYYMMDD is the date for each EO GCP calibration (20220811, 20221207, and 20230322).</procdesc>
        <srcused>dunex_c1_20210914_IO.yml</srcused>
        <srcused>dorado_c1_20230314_IO.yml</srcused>
        <srcused>dorado_c1_20220811_EO_GCPsurvey.csv</srcused>
        <srcused>dorado_c1_20221207_EO_GCPsurvey.csv</srcused>
        <srcused>dorado_c1_20230322_EO_GCPsurvey.csv</srcused>
        <srcused>dorado_c1_20220811_GCP_image_raw.jpg</srcused>
        <srcused>dorado_c1_20221207_GCP_image_raw.jpg</srcused>
        <srcused>dorado_c1_20230322_GCP_image_raw.jpg</srcused>
        <procdate>20231019</procdate>
        <srcprod>dorado_c1_20220811_GCP_image_annotated.jpg</srcprod>
        <srcprod>dorado_c1_20221207_GCP_image_annotated.jpg</srcprod>
        <srcprod>dorado_c1_20230322_GCP_image_annotated.jpg</srcprod>
        <srcprod>dorado_c1_20220811_EO.yml</srcprod>
        <srcprod>dorado_c1_20221207_EO.yml</srcprod>
        <srcprod>dorado_c1_20230322_EO.yml</srcprod>
        <proccont>
          <cntinfo>
            <cntperp>
              <cntper>Justin J. Birchler</cntper>
              <cntorg>U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center</cntorg>
            </cntperp>
            <cntpos>Physical Scientist</cntpos>
            <cntaddr>
              <addrtype>mailing and physical</addrtype>
              <address>600 4th Street South</address>
              <city>Saint Petersburg</city>
              <state>FL</state>
              <postal>33701</postal>
              <country>USA</country>
            </cntaddr>
            <cntvoice>727-502-8000</cntvoice>
            <cntemail>jbirchler@usgs.gov</cntemail>
          </cntinfo>
        </proccont>
      </procstep>
      <procstep>
        <procdesc>All intrinsic calibration images were given additional information required by the USGS to the exchangeable image file format (EXIF) and other imagery headers using PyExifTool Python library (https://pypi.org/project/PyExifTool/, version: 0.5.5). The following describes the Python dictionary object used, with each entry in the dictionary being a tag-value pair: tags = { 'Copyright': 'Public Domain', 'CopyrightNotice': 'Public Domain - please credit U.S. Geological Survey', 'Artist': 'USGS SPCMSC', 'Make': 'FLIR', 'Model': 'BlackFly S GigE 12MP','UserComment': UserComment, 'GPSLatitude': '18.4719695', 'GPSLongitude': '-66.284424', 'GPSMapDatum': 'EPSG:6348 NAD83(2011) / UTM zone 19N', 'GPSLatitudeRef': 'N', 'GPSLongitudeRef': 'W', 'GPSDateStamp': '2023-03-14', 'Credit': 'U.S. Geological Survey', 'Contact': 'gs-g-spcmsc_data_inquiries@usgs.gov', 'UsageTerms': "Unless otherwise stated, all data, metadata and related materials are considered to satisfy the quality standards relative to the purpose for which the data were collected. Although these data and associated metadata have been reviewed for accuracy and completeness and approved for release by the U.S. Geological Survey (USGS), no warranty expressed or implied is made regarding the display or utility of the data for other purposes, nor on all computer systems, nor shall the act of distribution constitute any such warranty", 'AttributionURL': 'https://doi.org/10.5066/P13CYA5A', 'ExternalMetadataLink': 'https://www.usgs.gov/pir/api/identifiers/USGS:9c8a00be-de55-408b-8c2b-802a6e4d6461', 'Contributor': 'Justin J. Birchler, Margaret L. Palmsten, Priscila Vargas-Babilonia, Eric Swanson, Mark L. Buckley', 'XMP-photoshop:Credit': 'U.S. Geological Survey', 'iptcCore:CreatorWorkEmail': 'gs-g-spcmsc_data_inquiries@usgs.gov', 'Rights': 'Public Domain', 'Keywords' : "Dorado, Puerto Rico, CoastCam, USGS, intrinsic calibration, snapshot, remote sensing, ground control point", 'ImageDescription': 'This image was captured from a stationary mounted camera at the Dorado camera site (station name: dorado) camera 1 in Dorado, Puerto Rico. Field Activity Number (FAN): 2022-330-FA (https://cmgds.marine.usgs.gov/fan_info.php?fan=2022-330-FA).', 'Description': 'This image was captured from a stationary mounted camera at the Dorado camera site (station name: dorado) camera 1 in Dorado, Puerto Rico. Field Activity Number (FAN): 2022-330-FA (https://cmgds.marine.usgs.gov/fan_info.php?fan=2022-330-FA).'}. If there were errors generating keywords with the Python script, additional keywords were added to the imagery headers for all of the IO images using the following command: 'exiftool -sep ", " -iptc:keywords="Dorado, Puerto Rico, CoastCam, USGS, intrinsic calibration, snapshot, remote sensing, ground control point" *.tiff'. The UserComment EXIF metadata field was used to store the camera intrinsics and extrinsics in the image metadata. The UserComment has a nested dictionary structure. The highest-level dictionary contains two nested dictionaries as well as a note explaining the structure of the UserComment field. One nested dictionary contains the actual intrinsic and extrinsic data variables. The other nested dictionary contains text descriptions for each of the variables in the dictionary of data variables. To read out the imagery header information to a CSV file the command is: 'exiftool -csv *.tiff &gt; allheaders.csv'. Specific tags can also be specified with this command.</procdesc>
        <procdate>20240301</procdate>
        <srcprod>c1_20230314_IO_####_###########.tiff</srcprod>
        <proccont>
          <cntinfo>
            <cntperp>
              <cntper>Justin J. Birchler</cntper>
              <cntorg>U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center</cntorg>
            </cntperp>
            <cntpos>Physical Scientist</cntpos>
            <cntaddr>
              <addrtype>mailing and physical</addrtype>
              <address>600 4th Street South</address>
              <city>Saint Petersburg</city>
              <state>FL</state>
              <postal>33701</postal>
              <country>USA</country>
            </cntaddr>
            <cntvoice>727-502-8000</cntvoice>
            <cntemail>jbirchler@usgs.gov</cntemail>
          </cntinfo>
        </proccont>
      </procstep>
      <procstep>
        <procdesc>All extrinsic calibration ground control point images were given additional information required by the USGS to the exchangeable image file format (EXIF) and other imagery headers using PyExifTool Python library (https://pypi.org/project/PyExifTool/, version: 0.5.5). The following describes the Python dictionary object used, with each entry in the dictionary being a tag-value pair: tags = { 'Copyright': 'Public Domain', 'CopyrightNotice': 'Public Domain - please credit U.S. Geological Survey', 'Artist': 'USGS SPCMSC', 'Make': 'FLIR', 'Model': 'BlackFly S GigE 12MP','UserComment': UserComment, 'GPSLatitude': '18.4719695', 'GPSLongitude': '-66.284424', 'GPSMapDatum': 'EPSG:6348 NAD83(2011) / UTM zone 19N', 'GPSLatitudeRef': 'N', 'GPSLongitudeRef': 'W', 'GPSDateStamp': '2023-03-22', 'Credit': 'U.S. Geological Survey', 'Contact': 'gs-g-spcmsc_data_inquiries@usgs.gov', 'UsageTerms': "Unless otherwise stated, all data, metadata and related materials are considered to satisfy the quality standards relative to the purpose for which the data were collected. Although these data and associated metadata have been reviewed for accuracy and completeness and approved for release by the U.S. Geological Survey (USGS), no warranty expressed or implied is made regarding the display or utility of the data for other purposes, nor on all computer systems, nor shall the act of distribution constitute any such warranty", 'AttributionURL': 'https://doi.org/10.5066/P13CYA5A', 'ExternalMetadataLink':'https://www.usgs.gov/pir/api/identifiers/USGS:9c8a00be-de55-408b-8c2b-802a6e4d6461', 'Contributor': 'Justin J. Birchler, Margaret L. Palmsten, Priscila Vargas-Babilonia, Eric Swanson, Mark L. Buckley', 'XMP-photoshop:Credit': 'U.S. Geological Survey', 'iptcCore:CreatorWorkEmail': 'gs-g-spcmsc_data_inquiries@usgs.gov','Rights': 'Public Domain', 'Keywords' : "Dorado, Puerto Rico, CoastCam, USGS, extrinsic calibration, snapshot, remote sensing, ground control point", 'ImageDescription': 'This image was captured from a stationary mounted camera at the Dorado camera site (station name: dorado) camera 1 in Dorado, Puerto Rico. Field Activity Number (FAN): 2022-330-FA (https://cmgds.marine.usgs.gov/fan_info.php?fan=2022-330-FA).', 'Description': 'This image was captured from a stationary mounted camera at the Dorado camera site (station name: dorado) camera 1 in Dorado, Puerto Rico. Field Activity Number (FAN): 2022-330-FA (https://cmgds.marine.usgs.gov/fan_info.php?fan=2022-330-FA).'}. If there were errors generating keywords with the Python script, additional keywords were added to the imagery headers for all of the IO images using the following command: 'exiftool -sep ", " -iptc:keywords="Dorado, Puerto Rico, CoastCam, USGS, extrinsic calibration, snapshot, remote sensing, ground control point" *.jpg'. The only tag which can have a different value from image to image is GPSDateStamp. Depending on the date the photo was captured, the value in the GPSDatestamp tag changes. The UserComment EXIF metadata field was used to store the camera intrinsics and extrinsics in the image metadata. The UserComment has a nested dictionary structure. The highest-level dictionary contains two nested dictionaries as well as a note explaining the structure of the UserComment field. One nested dictionary contains the actual intrinsic and extrinsic data variables. The other nested dictionary contains text descriptions for each of the variables in the dictionary of data variables. To read out the imagery header information to a CSV file the command is: 'exiftool -csv *.jpg &gt; allheaders.csv'. Specific tags can also be specified with this command.</procdesc>
        <procdate>20231019</procdate>
        <srcprod>dorado_c1_20220811_GCP_image_raw.jpg</srcprod>
        <srcprod>dorado_c1_20221207_GCP_image_raw.jpg</srcprod>
        <srcprod>dorado_c1_20230322_GCP_image_raw.jpg</srcprod>
        <srcprod>dorado_c1_20220811_GCP_image_annotated.jpg</srcprod>
        <srcprod>dorado_c1_20221207_GCP_image_annotated.jpg</srcprod>
        <srcprod>dorado_c1_20230322_GCP_image_annotated.jpg</srcprod>
        <proccont>
          <cntinfo>
            <cntperp>
              <cntper>Justin J. Birchler</cntper>
              <cntorg>U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center</cntorg>
            </cntperp>
            <cntpos>Physical Scientist</cntpos>
            <cntaddr>
              <addrtype>mailing and physical</addrtype>
              <address>600 4th Street South</address>
              <city>Saint Petersburg</city>
              <state>FL</state>
              <postal>33701</postal>
              <country>USA</country>
            </cntaddr>
            <cntvoice>727-502-8000</cntvoice>
            <cntemail>jbirchler@usgs.gov</cntemail>
          </cntinfo>
        </proccont>
      </procstep>
    </lineage>
  </dataqual>
  <spref>
    <horizsys>
      <planar>
        <gridsys>
          <gridsysn>Universal Transverse Mercator</gridsysn>
          <utm>
            <utmzone>19</utmzone>
            <transmer>
              <sfctrmer>0.9996</sfctrmer>
              <longcm>-69.0</longcm>
              <latprjo>0.0</latprjo>
              <feast>500000.0</feast>
              <fnorth>0.0</fnorth>
            </transmer>
          </utm>
        </gridsys>
        <planci>
          <plance>row and column</plance>
          <coordrep>
            <absres>1</absres>
            <ordres>1</ordres>
          </coordrep>
          <plandu>meters</plandu>
        </planci>
      </planar>
      <geodetic>
        <horizdn>NAD83_National_Spatial_Reference_System_2011</horizdn>
        <ellips>Geodetic Reference System 80</ellips>
        <semiaxis>6378137.000000</semiaxis>
        <denflat>298.257222101</denflat>
      </geodetic>
    </horizsys>
    <vertdef>
      <altsys>
        <altdatum>Puerto Rico Vertical Datum of 2002</altdatum>
        <altres>0.001</altres>
        <altunits>meters</altunits>
        <altenc>Explicit elevation coordinate included with horizontal coordinates</altenc>
      </altsys>
    </vertdef>
  </spref>
  <eainfo>
    <detailed>
      <enttyp>
        <enttypl>dorado_c1_20230314_IO.yml</enttypl>
        <enttypd>YML file containing the solved IO for camera 1 from step A in the Camera Calibration procedures outlined in Bruder and Brodie (2020).</enttypd>
        <enttypds>USGS</enttypds>
      </enttyp>
      <attr>
        <attrlabl>NU</attrlabl>
        <attrdef>the number of pixel columns</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>4096</rdommin>
            <rdommax>4096</rdommax>
            <attrunit>pixel</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>NV</attrlabl>
        <attrdef>the number of pixel rows</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>3000</rdommin>
            <rdommax>3000</rdommax>
            <attrunit>pixel</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>coU</attrlabl>
        <attrdef>U component of principal point</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>2038.92960729081</rdommin>
            <rdommax>2038.92960729081</rdommax>
            <attrunit>pixel</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>coV</attrlabl>
        <attrdef>V component of principal point</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>1474.41477189975</rdommin>
            <rdommax>1474.41477189975</rdommax>
            <attrunit>pixel</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>fx</attrlabl>
        <attrdef>U component of focal length in pixels</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>2352.47072243352</rdommin>
            <rdommax>2352.47072243352</rdommax>
            <attrunit>pixels</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>fy</attrlabl>
        <attrdef>V component of focal length in pixels</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>2347.49602948946</rdommin>
            <rdommax>2347.49602948946</rdommax>
            <attrunit>pixels</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>d1</attrlabl>
        <attrdef>Radial distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-0.0112814675598822</rdommin>
            <rdommax>-0.0112814675598822</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>d2</attrlabl>
        <attrdef>Radial distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-0.0432446932694334</rdommin>
            <rdommax>-0.0432446932694334</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>d3</attrlabl>
        <attrdef>Radial distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.0133086008681728</rdommin>
            <rdommax>0.0133086008681728</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>t1</attrlabl>
        <attrdef>Tangential distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-0.000565628335530937</rdommin>
            <rdommax>-0.000565628335530937</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>t2</attrlabl>
        <attrdef>Tangential distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.000480141705109364</rdommin>
            <rdommax>0.000480141705109364</rdommax>
          </rdom>
        </attrdomv>
      </attr>
    </detailed>
    <detailed>
      <enttyp>
        <enttypl>dorado_c1_20220811_EO_GCPsurvey.csv, dorado_c1_20221207_EO_GCPsurvey.csv, and dorado_c1_20230322_EO_GCPsurvey.csv</enttypl>
        <enttypd>The CSV files containing the location (x,y,z) of the ground control points (black and white targets) in the CoastCam field of view.</enttypd>
        <enttypds>USGS</enttypds>
      </enttyp>
      <attr>
        <attrlabl>GCP</attrlabl>
        <attrdef>Number of each GCP that can be found in dorado_c1_20220811_GCP_image_annotated.jpg, dorado_c1_20221207_GCP_image_annotated.jpg, and dorado_c1_20230322_GCP_image_annotated.jpg so that targets can be labeled correctly in Step B of Camera Calibration steps in Bruder and Brodie (2020).</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>1</rdommin>
            <rdommax>25</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>ID</attrlabl>
        <attrdef>Name of GCP</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <udom>Letter-number combination describing unique GCPs.</udom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>Easting (UTM)</attrlabl>
        <attrdef>Post-Processed Kinematic (PPK) X-coordinates in NAD83(2011)/UTM Zone 19N</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>786478.4410</rdommin>
            <rdommax>786785.2010</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>Northing (UTM)</attrlabl>
        <attrdef>Post-Processed Kinematic (PPK) Y-coordinates in NAD83(2011)/UTM Zone 19N</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>2044526.4880</rdommin>
            <rdommax>2044577.2930</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>Lon</attrlabl>
        <attrdef>Longitude (decimal degrees) in NAD83(2011)</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-66.28737256</rdommin>
            <rdommax>-66.28446808</rdommax>
            <attrunit>decimal degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>Lat</attrlabl>
        <attrdef>Latitude (decimal degrees) in NAD83 (2011)</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>18.47170528</rdommin>
            <rdommax>18.47214354</rdommax>
            <attrunit>decimal degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>z</attrlabl>
        <attrdef>Post-Processed Kinematic (PPK) Z-coordinates in NAD83(2011)/UTM Zone 19N referenced to PRVD02, in meters. A positive z value is the up direction.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.057</rdommin>
            <rdommax>2.033</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>gcpUsed</attrlabl>
        <attrdef>Indicates whether GCP was used to solve for EO, where 0 indicates not used and 1 indicates used.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0</rdommin>
            <rdommax>1</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>Description</attrlabl>
        <attrdef>Location of each ground control point (GCP) placed within the camera's field of view (FOV) to solve for EO.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <udom>GCP locations within the camera's FOV</udom>
        </attrdomv>
      </attr>
    </detailed>
    <detailed>
      <enttyp>
        <enttypl>dorado_c1_20220811_EO.yml, dorado_c1_20221207_EO.yml, and dorado_c1_20230322_EO.yml</enttypl>
        <enttypd>YML files containing the solved EO from Step C in the Camera Calibration procedures outlined in Bruder and Brodie (2020). The ranges represent the min and max values across all three YML files.</enttypd>
        <enttypds>USGS</enttypds>
      </enttyp>
      <attr>
        <attrlabl>x</attrlabl>
        <attrdef>X-coordinate in NAD83(2011)/UTM Zone 19N of camera position.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>786789.7075</rdommin>
            <rdommax>786790.0166</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>y</attrlabl>
        <attrdef>Y-coordinate in NAD83(2011)/UTM Zone 19N of camera position.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>2044558.1859</rdommin>
            <rdommax>2044558.1897</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>z</attrlabl>
        <attrdef>Z-coordinates referenced to PRVD02, GEOID18 of camera position.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>9.6646</rdommin>
            <rdommax>9.7342</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>azimuth</attrlabl>
        <attrdef>The horizontal direction the camera is pointing; positive clockwise (CW) from World Y Axis.</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>286.3156</rdommin>
            <rdommax>287.3326</rdommax>
            <attrunit>Angle units in degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>tilt</attrlabl>
        <attrdef>The up/down tilt of the camera. 0 is the camera looking nadir, 90 is the camera looking at the horizon right side up, 180 is looking directly up, and so on.</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>62.2047</rdommin>
            <rdommax>62.7143</rdommax>
            <attrunit>Angle units in degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>roll</attrlabl>
        <attrdef>The rotation around a horizontal axis going through the length of the lens of the camera. 0 degrees is a horizontal flat camera. Looking from behind the camera, counterclockwise (CCW) rotation of the camera would result in a positive roll.</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-2.9901</rdommin>
            <rdommax>-1.9803</rdommax>
            <attrunit>Angle units in degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
    </detailed>
    <overview>
      <eaover>There are a total of 202 IO TIFF images for c1. The filename for each IO image is formatted as "c1_20230314_IO_####_###########", where the number (####_###########) is the original photo ID. There are 6 EO JPG images for c1. The filename for each EO image is formatted as "dorado_c1_YYYYMMDD_GCP_image_imagetype", where YYYYMMDD is the date and the imagetype is either 'raw' or 'annotated'. These images have EXIF and other imagery header information encoded within each file; see the process steps for more information.</eaover>
      <eadetcit>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.</eadetcit>
    </overview>
    <overview>
      <eaover>To place the photos taken by the CoastCams into real world coordinates and to rectify them into a planar view, objects within the field of view of the camera must be located. The approximate elevation and position of the lenses in the CoastCam setup were measured with the PPK GPS. The CoastCams took pictures of the position of each target within the camera view. Each '_EO' zip folder contains the GCP CSV file, the resultant EO parameters in a YML file, and a 'raw' and 'annotated' image of the GCPs. CSV files (dorado_c1_20220811_EO_GCPsurvey.csv, dorado_c1_20221207_EO_GCPsurvey.csv, and dorado_c1_20230322_EO_GCPsurvey.csv) with all the measurements were populated and GCP numbers were hand labeled on the annotated images (dorado_c1_20220811_GCP_image_annotated.jpg, dorado_c1_20221207_GCP_image_annotated.jpg, and dorado_c1_20230322_GCP_image_annotated.jpg) so that the targets could be labeled correctly in Step B of the Camera Calibration steps in Bruder and Brodie (2020). There are 6 JPG files per camera for a total of 12 JPGs. Images have EXIF and other imagery header information encoded within each file; see the process steps for more information.</eaover>
      <eadetcit>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.</eadetcit>
    </overview>
    <overview>
      <eaover>There are a total of 202 IO images for c1 (dorado_c1_20230314_IO.zip) of which 23 were used for the intrinsic calibration (Bouguet, 2022). The filenames of all, calibrated, and excluded images are listed in separate text files.</eaover>
      <eadetcit>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.</eadetcit>
    </overview>
  </eainfo>
  <distinfo>
    <distrib>
      <cntinfo>
        <cntperp>
          <cntper>USGS SPCMSC Data Management Group</cntper>
          <cntorg>U.S. Geological Survey - St. Petersburg Coastal and Marine Science Center</cntorg>
        </cntperp>
        <cntaddr>
          <addrtype>mailing address</addrtype>
          <address>600 4th Street South</address>
          <city>St. Petersburg</city>
          <state>Florida</state>
          <postal>33701</postal>
          <country>USA</country>
        </cntaddr>
        <cntvoice>727-502-8000</cntvoice>
        <cntemail>gs-g-spcmsc_data_inquiries@usgs.gov</cntemail>
      </cntinfo>
    </distrib>
    <resdesc>dorado_c1_20220811_EO.yml, dorado_c1_20220811_EO_GCPsurvey.csv, dorado_c1_20220811_GCP_image_annotated.jpg, dorado_c1_20220811_GCP_image_raw.jpg, dorado_c1_20221207_EO.yml, dorado_c1_20221207_EO_GCPsurvey.csv, dorado_c1_20221207_GCP_image_annotated.jpg, dorado_c1_20221207_GCP_image_raw.jpg, dorado_c1_20230322_EO.yml, dorado_c1_20230322_EO_GCPsurvey.csv, dorado_c1_20230322_GCP_image_annotated.jpg, dorado_c1_20230322_GCP_image_raw.jpg, c1_20230314_IO_####_###########.tiff, c1_20230314_IO_calibratedImageSet, c1_20230314_IO_excludedImageSet, c1_20230314_IO_wholeImageSet, and dorado_c1_20230314_IO.yml</resdesc>
    <distliab>Unless otherwise stated, all data, metadata and related materials are considered to satisfy the quality standards relative to the purpose for which the data were collected. Although these data and associated metadata have been reviewed for accuracy and completeness and approved for release by the U.S. Geological Survey (USGS), no warranty expressed or implied is made regarding the display or utility of the data for other purposes, nor on all computer systems, nor shall the act of distribution constitute any such warranty. Any use of trade, firm, or product names is for descriptive purposes only and does not imply endorsement by the U.S. Government.</distliab>
    <stdorder>
      <digform>
        <digtinfo>
          <formname>TIFF, JPG, YML, comma-delimited text</formname>
        </digtinfo>
        <digtopt>
          <onlinopt>
            <computer>
              <networka>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P13CYA5A/data/dorado_c1_20230314_IO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P13CYA5A/data/dorado_c1_20220811_EO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P13CYA5A/data/dorado_c1_20221207_EO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P13CYA5A/data/dorado_c1_20230322_EO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P13CYA5A/data/dorado_c1_calibrationIOEO_exampleImagery.zip</networkr>
              </networka>
            </computer>
          </onlinopt>
        </digtopt>
      </digform>
      <fees>None</fees>
    </stdorder>
  </distinfo>
  <metainfo>
    <metd>20250402</metd>
    <metc>
      <cntinfo>
        <cntorgp>
          <cntorg>U.S. Geological Survey, St. Petersburg Coastal and Marine Science Center</cntorg>
          <cntper>USGS SPCMSC Data Management</cntper>
        </cntorgp>
        <cntaddr>
          <addrtype>mailing and physical</addrtype>
          <address>600 4th Street South</address>
          <city>Saint Petersburg</city>
          <state>FL</state>
          <postal>33701</postal>
          <country>United States</country>
        </cntaddr>
        <cntvoice>727-502-8000</cntvoice>
        <cntemail>gs-g-spcmsc_data_inquiries@usgs.gov</cntemail>
      </cntinfo>
    </metc>
    <metstdn>Content Standard for Digital Geospatial Metadata</metstdn>
    <metstdv>FGDC-STD-001-1998</metstdv>
  </metainfo>
</metadata>
