<?xml version="1.0" encoding="UTF-8"?>
<metadata>
  <idinfo>
    <citation>
      <citeinfo>
        <origin>Jenna A. Brown</origin>
        <origin>Justin J. Birchler</origin>
        <origin>Sharifa Karwandyar</origin>
        <origin>Eric Swanson</origin>
        <origin>Margaret L. Palmsten</origin>
        <pubdate>20230825</pubdate>
        <title>Intrinsic and Extrinsic Calibration Data From USGS CoastCam deployed at Madeira Beach, Florida</title>
        <edition>1.0</edition>
        <geoform>tabular digital data, raster digital data</geoform>
        <lworkcit>
          <citeinfo>
            <origin>Jenna A. Brown</origin>
            <origin>Justin J. Birchler</origin>
            <origin>Sharifa Karwandyar</origin>
            <origin>Eric Swanson</origin>
            <origin>Margaret L. Palmsten</origin>
            <pubdate>20230823</pubdate>
            <title>USGS Madeira Beach, Florida CoastCam Imagery and Calibration Data</title>
            <edition>1.0</edition>
            <serinfo>
              <sername>U.S. Geological Survey data release</sername>
              <issue>doi:10.5066/P9SGRTF1</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/P9SGRTF1</onlink>
          </citeinfo>
        </lworkcit>
      </citeinfo>
    </citation>
    <descript>
      <abstract>A digital video camera was installed at Madeira Beach, Florida (FL) and faced west along the beach. Every hour during daylight hours, daily from 2017 to 2022, the camera collected raw video and produced snapshots and time-averaged image products. This data release includes the necessary intrinsic orientation (IO) and extrinsic orientation (EO) calibration data to utilize imagery to make quantitative measurements. The camera is 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, 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/spcmsc/science/video-remote-sensing-coastal-processes.</abstract>
      <purpose>These data can be processed 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 data management protocols were followed, each survey was assigned a USGS field activity number (FAN); 2017-353-FA, 2017-358-FA, and 2017-380-FA. Additional information about the field activities from which the extrinsic orientation (EO) calibration data were derived are available on the Coastal and Marine Geoscience Data System (CMGDS): https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-353-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-358-FA, and https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-380-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 approximately 300 meters (m) directly in line of the camera facing alongshore. The intrinsic calibration photos were taken at the USGS SPCMSC on 20161130 (YYYYMMDD) and their location information is not consequential.</supplinf>
    </descript>
    <timeperd>
      <timeinfo>
        <mdattim>
          <sngdate>
            <caldate>20161130</caldate>
          </sngdate>
          <sngdate>
            <caldate>20170217</caldate>
          </sngdate>
          <sngdate>
            <caldate>20170919</caldate>
          </sngdate>
        </mdattim>
      </timeinfo>
      <current>ground condition</current>
    </timeperd>
    <status>
      <progress>Complete</progress>
      <update>As needed</update>
    </status>
    <spdom>
      <bounding>
        <westbc>-82.79837611</westbc>
        <eastbc>-82.7964421</eastbc>
        <northbc>27.79776803</northbc>
        <southbc>27.79620633</southbc>
      </bounding>
    </spdom>
    <keywords>
      <theme>
        <themekt>USGS Metadata Identifier</themekt>
        <themekey>USGS:eac27851-8de5-4a25-a960-8379e43e464c</themekey>
      </theme>
      <theme>
        <themekt>ISO 19115 Topic Category</themekt>
        <themekey>geoscientificInformation</themekey>
        <themekey>environment</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>
      <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>
      <place>
        <placekt>Geographic Names Information System (GNIS)</placekt>
        <placekey>Florida</placekey>
        <placekey>Madeira Beach</placekey>
        <placekey>Saint Petersburg</placekey>
      </place>
    </keywords>
    <accconst>None</accconst>
    <useconst>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.</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-8019</cntvoice>
        <cntemail>jbirchler@usgs.gov</cntemail>
      </cntinfo>
    </ptcontac>
    <browse>
      <browsen>c1MadeiraBeachFL_calibrationIOEO_exampleimagery.zip</browsen>
      <browsed>Zip file containing the following examples: A) Image used in intrinsic orientation (IO) calibration (c1_20161130_IO_0000.jpg) and B) Image used in extrinsic orientation (EO) calibration (c1_20170919_MadeiraBeachFL_GCP_image_annotated.jpg) and the target numbers for use in the CIRN Toolbox that correspond to the numbers in the c1_20170919_MadeiraBeachFL_EO_GCPsurvey.csv.</browsed>
      <browset>JPEG</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 R2016a (https://www.mathworks.com/products/matlab.html).</native>
    <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>
  </idinfo>
  <dataqual>
    <attracc>
      <attraccr>Extrinsic orientation (EO) calibration ground control points (GCPs) were surveyed with an Ashteck Z-Xtreme Differential Global Positioning System (DGPS) Post-Processed Kinematic (PPK) receiver. Calibration success can be examined using the CIRN 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 latest parameters are stored in the JavaScript Object Notation (JSON) files named with the date first active.</attraccr>
    </attracc>
    <logic>The camera system installed (Allied Vision Technologies Prosilica GT3400C) had an intrinsic and extrinsic calibration process. The EO process was completed on 20161130, 20170217, and 20170919 and each date consists of a JSON file of resultant EO parameters, a comma-separated values (CSV) file of GCP locations and description, and two Joint Photographic Experts Group (JPEG) images, one labeled as 'raw' and the other as 'annotated'. The intrinsic orientation (IO) calibration consists of a total of 1,086 images and the extrinsic calibration uses one snap photo with GCP targets that have pre-established location information. Of the 1,086 photos, 12 images that collectively covered the entire image frame were selected to solve for the intrinsic calibration. These include: c1_20161130_IO_0028.jpg, c1_20161130_IO_0082.jpg, c1_20161130_IO_0196.jpg, c1_20161130_IO_0256.jpg, c1_20161130_IO_0289.jpg, c1_20161130_IO_0345.jpg, c1_20161130_IO_0413.jpg, c1_20161130_IO_0441.jpg, c1_20161130_IO_0443.jpg, c1_20161130_IO_0451.jpg, c1_20161130_IO_0472.jpg, and c1_20161130_IO_1207.jpg. These are used in the CIRN Toolbox steps A through C. Results of the intrinsic and extrinsic calibrations are stored in separate JSON files (c1_20161130_IO.json, c1_20161130_MadeiraBeachFL_EO.json, c1_20170217_MadeiraBeachFL_EO.json, and c1_20170919_MadeiraBeachFL_EO.json).</logic>
    <complete>All calibration images are provided even if not all images are necessary for calibrating the camera.</complete>
    <posacc>
      <horizpa>
        <horizpar>PPK equipment with decimeter horizontal accuracy collected in field activities 2017-353-FA, 2017-358-FA, and 2017-380-FA were used to validate the extrinsic camera calibration. 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 17 North (NAD83(2011)/UTM Zone 17N) coordinate system, with a resolution of 1 meter.</horizpar>
      </horizpa>
      <vertacc>
        <vertaccr>PPK equipment with centimeter vertical accuracy collected in field activities 2017-353-FA, 2017-358-FA, and 2017-380-FA were used to validate the extrinsic camera calibration. 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 North American Vertical Datum of 1988 (NAVD88) coordinate system, with a resolution of 0.001 meters.</vertaccr>
      </vertacc>
    </posacc>
    <lineage>
      <procstep>
        <procdesc>The CoastCam was used to take IO photos. This involves slightly tilting a printed checkerboard with 2.7-centimeter (cm) squares in various parts of the cameras field of view. An example image can be found in c1_MadeiraBeachFL_calibrationIOEO_exampleimagery.zip. There are a total of 1,086 IO images (c1_20161130_IO.zip) of which 12 were used for the intrinsic calibration. These 12 images were used in step A in the Camera Calibration procedures outlined in Bruder and Brodie (2020). The resultant parameters are stored in a JSON file located in c1_20161130_IO.zip. Image file naming format follows c1_20161130_IO_####, where c1 is the camera name, 20161130 is the date the images were taken (YYYYMMDD format), IO is Intrinsic Orientation, and #### is the original unique ID from the camera.</procdesc>
        <procdate>20161130</procdate>
        <srcprod>c1_20161130_IO_####.jpg</srcprod>
        <srcprod>c1_20161130_IO.json</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-8019</cntvoice>
            <cntemail>jbirchler@usgs.gov</cntemail>
          </cntinfo>
        </proccont>
      </procstep>
      <procstep>
        <procdesc>Extrinsic orientation (EO) calibration ground control points (GCPs) were surveyed with an Ashteck Z-Xtreme Differential Global Positioning System (DGPS) Post-Processed Kinematic (PPK) receiver. GCPs were collected three times after the camera had been operational (20161130, 20170217, and 20170919). 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, multiple large square targets (ranging from 0.6 m to 1.2 m) painted white and black in opposite quadrants were propped up to face the CoastCam setup. Targets that were closest to the camera were laid flat and not propped up. The center of the target (between black and white) was measured with the PPK GPS equipment to collect ground control points. To obtain the elevation of the bottom center of the target (between black and white) closest to the sand, the 'zOffset' was subtracted from 'z'. The CoastCam took pictures of the position of each target within the camera view (raw JPEG images). The CSV files 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 images, solved in Step B of Bruder and Brodie (2020), the GPS positions from the CSV files, and the IO parameters in the IO JSON 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 JSON file located in c1_date_MadeiraBeachFL_EO.zip, where the date is in YYYYMMDD format for each EO GCP calibration (20161130, 20170217, and 20170919).</procdesc>
        <srcused>c1_20161130_IO.json</srcused>
        <srcused>c1_20161130_MadeiraBeachFL_EO_GCPsurvey.csv</srcused>
        <srcused>c1_20170217_MadeiraBeachFL_EO_GCPsurvey.csv</srcused>
        <srcused>c1_20170919_MadeiraBeachFL_EO_GCPsurvey.csv</srcused>
        <srcused>c1_20161130_MadeiraBeachFL_GCP_image_raw.jpg</srcused>
        <srcused>c1_20170217_MadeiraBeachFL_GCP_image_raw.jpg</srcused>
        <srcused>c1_20170919_MadeiraBeachFL_GCP_image_raw.jpg</srcused>
        <procdate>20230731</procdate>
        <srcprod>c1_20161130_MadeiraBeachFL_GCP_image_annotated.jpg</srcprod>
        <srcprod>c1_20170217_MadeiraBeachFL_GCP_image_annotated.jpg</srcprod>
        <srcprod>c1_20170919_MadeiraBeachFL_GCP_image_annotated.jpg</srcprod>
        <srcprod>c1_20161130_MadeiraBeachFL_EO.json</srcprod>
        <srcprod>c1_20170217_MadeiraBeachFL_EO.json</srcprod>
        <srcprod>c1_20170919_MadeiraBeachFL_EO.json</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-8019</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). All intrinsic photos were given EXIF header information in the directory with all the photos by assigning all the tags in a Python dictionary object to each photo using PyExifTool. The following describes the Python dictionary object 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': 'Allied Vision Technology','Model': 'Prosilica GT3400','UserComment': UserComment, 'GPSLatitude': '27.7962', 'GPSLongitude': '-82.7961', 'GPSMapDatum': 'EPSG:6318 (NAD83_National_Spatial_Reference_System_2011)', 'GPSLatitudeRef': 'N', 'GPSLongitudeRef': 'W', 'GPSDateStamp': '2016-11-30', '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/P9SGRTF1', 'ExternalMetadataLink': 'https://www1.usgs.gov/pir/api/identifiers/USGS:eac27851-8de5-4a25-a960-8379e43e464c', 'Contributor': 'Jenna Brown, Justin Birchler, Sharifa Karwandyar, Eric Swanson, Meg Palmsten', 'XMP-photoshop:Credit': 'U.S. Geological Survey', 'iptcCore:CreatorWorkEmail': 'gs-g-spcmsc_data_inquiries@usgs.gov','Rights': 'Public Domain', 'Keywords' : "Madeira Beach, Florida, CoastCam, USGS, intrinsic calibration, snapshot, remote sensing, ground control point", 'ImageDescription': 'This image was captured from a stationary mounted camera at Madeira Beach, Florida. Field Activity Number: 2016-363-DD (https://cmgds.marine.usgs.gov/fan_info.php?fan=2016-363-DD) Other FANs referenced in calibration metadata: https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-353-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-358-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-380-FA', 'Description': 'This image was captured from a stationary mounted camera at Madeira Beach, Florida. Field Activity Number: 2016-363-DD (https://cmgds.marine.usgs.gov/fan_info.php?fan=2016-363-DD) Other FANs referenced in calibration metadata: https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-353-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-358-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-380-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="Madeira Beach, Florida, CoastCam, USGS, intrinsic calibration" *.jpg'. 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 may be specified with this command, if preferred.</procdesc>
        <procdate>20230812</procdate>
        <srcprod>c1_20161130_IO_####.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>Physcical 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-8019</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). All extrinsic photos were given EXIF header information in the directory with all the photos by assigning all the tags in a Python dictionary object to each photo using PyExifTool. The following describes the Python dictionary object 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': 'Allied Vision Technology','Model': 'Prosilica GT3400','UserComment': UserComment, 'GPSLatitude': '27.7962', 'GPSLongitude': '-82.7961', 'GPSMapDatum': 'EPSG:6318 (NAD83_National_Spatial_Reference_System_2011)', 'GPSLatitudeRef': 'N', 'GPSLongitudeRef': 'W', '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/P9SGRTF1', 'ExternalMetadataLink':'https://www1.usgs.gov/pir/api/identifiers/USGS:eac27851-8de5-4a25-a960-8379e43e464c', 'Contributor': 'Jenna Brown, Justin Birchler, Sharifa Karwandyar, Eric Swanson, Meg Palmsten', 'XMP-photoshop:Credit': 'U.S. Geological Survey', 'iptcCore:CreatorWorkEmail': 'gs-g-spcmsc_data_inquiries@usgs.gov','Rights': 'Public Domain', 'Keywords' : "Madeira Beach, Florida, CoastCam, USGS, intrinsic calibration, snapshot, remote sensing, ground control point", 'ImageDescription': 'This image was captured from a stationary mounted camera at Madeira Beach, Florida. Field Activity Number: 2016-363-DD (https://cmgds.marine.usgs.gov/fan_info.php?fan=2016-363-DD) Other FANs referenced in calibration metadata: https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-353-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-358-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-380-FA', 'Description': 'This image was captured from a stationary mounted camera at Madeira Beach, Florida. Field Activity Number: 2016-363-DD (https://cmgds.marine.usgs.gov/fan_info.php?fan=2016-363-DD) Other FANs referenced in calibration metadata: https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-353-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-358-FA, https://cmgds.marine.usgs.gov/fan_info.php?fan=2017-380-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="Madeira Beach, Florida, CoastCam, USGS, extrinsic calibration" *.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 may be specified with this command, if preferred.</procdesc>
        <procdate>20230812</procdate>
        <srcprod>c1_20161130_MadeiraBeachFL_GCP_image_raw.jpg</srcprod>
        <srcprod>c1_20170217_MadeiraBeachFL_GCP_image_raw.jpg</srcprod>
        <srcprod>c1_20170919_MadeiraBeachFL_GCP_image_raw.jpg</srcprod>
        <srcprod>c1_20161130_MadeiraBeachFL_GCP_image_annotated.jpg</srcprod>
        <srcprod>c1_20170217_MadeiraBeachFL_GCP_image_annotated.jpg</srcprod>
        <srcprod>c1_20170919_MadeiraBeachFL_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-8019</cntvoice>
            <cntemail>jbirchler@usgs.gov</cntemail>
          </cntinfo>
        </proccont>
      </procstep>
    </lineage>
  </dataqual>
  <spref>
    <horizsys>
      <planar>
        <gridsys>
          <gridsysn>Universal Transverse Mercator</gridsysn>
          <utm>
            <utmzone>17</utmzone>
            <transmer>
              <sfctrmer>0.9996</sfctrmer>
              <longcm>-81.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>North American Vertical Datum of 1988</altdatum>
        <altres>0.001</altres>
        <altunits>meters</altunits>
        <altenc>Explicit elevation coordinate included with horizontal coordinates</altenc>
      </altsys>
    </vertdef>
  </spref>
  <eainfo>
    <detailed>
      <enttyp>
        <enttypl>c1_20161130_IO.json</enttypl>
        <enttypd>JSON file containing the solved intrinsic orientation (IO) 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>2448</rdommin>
            <rdommax>2448</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>2048</rdommin>
            <rdommax>2048</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>1277.09314682660</rdommin>
            <rdommax>1277.09314682660</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>994.264160394006</rdommin>
            <rdommax>994.264160394006</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>3518.92473711821</rdommin>
            <rdommax>3518.92473711821</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>3505.59066329524</rdommin>
            <rdommax>3505.59066329524</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.369949938809115</rdommin>
            <rdommax>-0.369949938809115</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>d2</attrlabl>
        <attrdef>Radial distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.150529438621191</rdommin>
            <rdommax>0.150529438621191</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>d3</attrlabl>
        <attrdef>Radial distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.823142233565792</rdommin>
            <rdommax>0.823142233565792</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>t1</attrlabl>
        <attrdef>Tangential distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.000733754639518832</rdommin>
            <rdommax>0.000733754639518832</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>t2</attrlabl>
        <attrdef>Tangential distortion coefficient</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.00239949609664961</rdommin>
            <rdommax>0.00239949609664961</rdommax>
          </rdom>
        </attrdomv>
      </attr>
    </detailed>
    <detailed>
      <enttyp>
        <enttypl>c1_20161130_MadeiraBeachFL_EO_GCPsurvey.csv, c1_20170217_MadeiraBeachFL_EO_GCPsurvey.csv, and c1_20170919_MadeiraBeachFL_EO_GCPsurvey.csv</enttypl>
        <enttypd>The CSV files containing the location (x,y,z, and zOffset) 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>Labeled identification of each GCP that can be found in c1_20161130_MadeiraBeachFL_GCP_image_annotated.jpg, c1_20170217_MadeiraBeachFL_GCP_image_annotated.jpg, and c1_20170919_MadeiraBeachFL_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>10</rdommax>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>Easting (UTM)</attrlabl>
        <attrdef>Post-Processed Kinematic (PPK) X-coordinates in NAD83(2011)/UTM Zone 17N</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>322833.559</rdommin>
            <rdommax>323021.8</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>Northing (UTM)</attrlabl>
        <attrdef>Post-Processed Kinematic (PPK) Y-coordinates in NAD83(2011)/UTM Zone 17N</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>3075921.578</rdommin>
            <rdommax>3076097.357</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>-82.79837611</rdommin>
            <rdommax>-82.7964421</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>27.79620633</rdommin>
            <rdommax>27.79776803</rdommax>
            <attrunit>decimal degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>z</attrlabl>
        <attrdef>Post-Processed Kinematic (PPK) Z-coordinates in NAD83(2011)/UTM Zone 17N referenced to NAVD88, in meters. A positive z value is the up direction.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>-0.983</rdommin>
            <rdommax>2.043</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>zOffset</attrlabl>
        <attrdef>The zOffset represents the standing elevation of the center of the GCP, in meters, if the GCP was propped up in order to be visible in the image. A positive zOffset value is the up direction.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>0.000</rdommin>
            <rdommax>0.696</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>gcpUsed</attrlabl>
        <attrdef>Indicates whether GCP was used to solve for extrinsic orientation, 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 extrinsic orientation.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <udom>GCP locations within the camera's FOV</udom>
        </attrdomv>
      </attr>
    </detailed>
    <detailed>
      <enttyp>
        <enttypl>c1_20161130_MadeiraBeachFL_EO.json, c1_20170217_MadeiraBeachFL_EO.json, and c1_20170919_MadeiraBeachFL_EO.json</enttypl>
        <enttypd>JSON files containing the solved extrinsic orientation (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 JSON files.</enttypd>
        <enttypds>USGS</enttypds>
      </enttyp>
      <attr>
        <attrlabl>azimuth</attrlabl>
        <attrdef>The horizontal direction the camera is pointing and positive clockwise (CW) from World Y Axis.</attrdef>
        <attrdefs>Bruder and Brodie (2020)</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>157.139316</rdommin>
            <rdommax>157.745249</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>79.769978</rdommin>
            <rdommax>80.182463</rdommax>
            <attrunit>Angle units in degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>roll</attrlabl>
        <attrdef>The side-to-side tilt 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>1.968700</rdommin>
            <rdommax>2.751242</rdommax>
            <attrunit>Angle units in degrees</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>camera - Easting (UTM)</attrlabl>
        <attrdef>X-coordinate in NAD83(2011)/UTM Zone 17N of camera position on rooftop.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>323055.067</rdommin>
            <rdommax>323056.015</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>camera - Northing (UTM)</attrlabl>
        <attrdef>Y-coordinate in NAD83(2011)/UTM Zone 17N of camera position on rooftop.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>3075921.557</rdommin>
            <rdommax>3075922.214</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
      <attr>
        <attrlabl>camera - z (m)</attrlabl>
        <attrdef>Z-coordinates referenced to NAVD88 in meters of GEOID12B.</attrdef>
        <attrdefs>U.S. Geological Survey</attrdefs>
        <attrdomv>
          <rdom>
            <rdommin>18.118</rdommin>
            <rdommax>19.228</rdommax>
            <attrunit>meters</attrunit>
          </rdom>
        </attrdomv>
      </attr>
    </detailed>
    <overview>
      <eaover>There are a total of 1,086 intrinsic orientation (IO) JPEG images. The filename for each IO image is formatted as "c1_20161130_IO_####", where the number (####) is the original photo ID. There are a total of 6 extrinsic orientation (EO) JPEG images. The filename for each EO image is formatted as "c1_date_MadeiraBeachFL_GCP_image_imagetype". Where the date is in YYYYMMDD format 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 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. The elevation and position of the lenses in the CoastCam setup were measured with the PPK GPS. The CoastCam 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 JSON file, and a 'raw' and 'annotated' image of the GCPs. CSV files (c1_20161130_MadeiraBeachFL_EO_GCPsurvey.csv, c1_20170217_MadeiraBeachFL_EO_GCPsurvey.csv, and c1_20170919_MadeiraBeachFL_EO_GCPsurvey.csv) with all the measurements were populated and GCP numbers were hand labeled on the annotated images (c1_20161130_MadeiraBeachFL_GCP_image_annotated.jpg, c1_20170217_MadeiraBeachFL_GCP_image_annotated.jpg, and c1_20170919_MadeiraBeachFL_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 a total of 6 JPEGs. 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>
  </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>c1_20161130_IO_####.jpg, c1_20161130_MadeiraBeachFL_EO.json, c1_20161130_MadeiraBeachFL_EO_GCPsurvey.csv, c1_20161130_MadeiraBeachFL_GCP_image_annotated.jpg, c1_20161130_MadeiraBeachFL_GCP_image_raw.jpg, c1_20170217_MadeiraBeachFL_EO.json, c1_20170217_MadeiraBeachFL_EO_GCPsurvey.csv, c1_20170217_MadeiraBeachFL_GCP_image_annotated.jpg, c1_20170217_MadeiraBeachFL_GCP_image_raw.jpg, c1_20170919_MadeiraBeachFL_EO.json, c1_20170919_MadeiraBeachFL_EO_GCPsurvey.csv, c1_20170919_MadeiraBeachFL_GCP_image_annotated.jpg, and c1_20170919_MadeiraBeachFL_GCP_image_raw.jpg</resdesc>
    <distliab>This publication was prepared by an agency of the United States Government. 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 on any other system or for general or scientific purposes, nor shall the act of distribution constitute any such warranty. 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. Any use of trade, firm, or product names is for descriptive purposes only and does not imply endorsement by the U.S. Government. Although these data have been processed successfully on a computer system at 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. The USGS or the U.S. Government shall not be held liable for improper or incorrect use of the data described and/or contained herein.</distliab>
    <stdorder>
      <digform>
        <digtinfo>
          <formname>JPEG, JSON, comma-delimited text</formname>
        </digtinfo>
        <digtopt>
          <onlinopt>
            <computer>
              <networka>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P9SGRTF1/data/c1_20161130_IO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P9SGRTF1/data/c1_20161130_MadeiraBeachFL_EO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P9SGRTF1/data/c1_20170217_MadeiraBeachFL_EO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P9SGRTF1/data/c1_20170919_MadeiraBeachFL_EO.zip</networkr>
                <networkr>https://coastal.er.usgs.gov/data-release/doi-P9SGRTF1/data/c1_MadeiraBeachFL_calibrationIOEO_exampleimagery.zip</networkr>
              </networka>
            </computer>
          </onlinopt>
        </digtopt>
      </digform>
      <fees>None</fees>
    </stdorder>
  </distinfo>
  <metainfo>
    <metd>20230825</metd>
    <metc>
      <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-8019</cntvoice>
        <cntemail>jbirchler@usgs.gov</cntemail>
      </cntinfo>
    </metc>
    <metstdn>FGDC Biological Data Profile of the Content Standard for Digital Geospatial Metadata</metstdn>
    <metstdv>FGDC-STD-001.1-1999</metstdv>
  </metainfo>
</metadata>
