search

PIFSC-Protected-Species-Division / cruise-maps-live

This repository contains code necessary to generate daily maps of the cetacean survey cruises
https://storymaps.arcgis.com/stories/b3bbf0e90d0141f7bf47edc5339ccb7a
MIT License
3 stars 0 forks source link

readme

Near Real-Time Cetacean Cruise Maps

<img src="README_files/figure-gfm/fa-icon-bcbd573b0c4bf742a1242819bebaac28.svg" style="width:0.88em;height:1em" /> Last Update: 06 Dec 2023

<img src="README_files/figure-gfm/fa-icon-d8ea6ac07fd86570bd4146f5874f7163.svg" style="width:1.12em;height:1em" /> This code is always in development

Developers

Janelle Badger (janelle.badger AT noaa.gov; @badgerjj)
Yvonne Barkley (yvonne.barkley AT noaa.gov; @ybarkley)
Selene Fregosi (selene.fregosi AT noaa.gov; @sfregosi)
Kym Yano (kym.yano AT noaa.gov; @kmyano)

Cetacean Research Program | Protected Species Division
Pacific Islands Fisheries Science Center
National Marine Fisheries Service
National Oceanic and Atmospheric Administration

The idea for these live maps and this repository was inspired by the Alaska Fisheries Science Center’s live survey maps. The code and outputs presented here are modified from the AFSC team’s survey-live-temperature-map repository.

Table of contents

Purpose

The Hawaiian Islands Cetacean and Ecosystem Survey (HICEAS) assesses whale, dolphin, and seabird populations across the Hawaiian Islands. The survey is conducted by NOAA Fisheries’ Pacific Islands Fisheries Science Center. The code in this repository allows us to generate summary maps and tables of our survey progress and cetacean sightings. These scripts compile the various data streams, collected and uploaded to Google Drive by the researchers at sea, and then create daily maps and an up-to-date summary table. The generated map and table are shared to the cruise website: HICEAS 2023 is Underway!

HICEAS 2023 completed in early December 2023. This repository will be used again for future Cetacean Research Program surveys, so stay tuned in the coming years!

Final HICEAS 2023 maps

(click to enlarge)

HICEAS 2023 Map - Latest Map. This map shows the most up-to-date completed survey tracklines (pink) and cetacean sightings (colored symbols). The map creation date is above the scale bar. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.HICEAS 2023 Map - Latest Map. This map shows the most up-to-date completed survey tracklines (pink) and acoustic detections of cetaceans (colored symbols). The map creation date is above the scale bar. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Final HICEAS 2023 Summary Table

(click to enlarge)

HICEAS 2023 Summary Table. This table shows the final effort summary for HICEAS 2023 including total number of days at sea for each ship and leg, total kilometers of survey effort track completed, the number of cetaceang roups visually sighted, and the number of cetacean groups acoustically detected.

Notes

How to set up automation using Windows Task Scheduler This includes information on setting up the Windows Task Scheduler to execute an R script on a schedule (in our case run.r) and to autocommit and push changes to GitHub.

Where the input and output files will be saved: Google Drive - Restricted access

When running the run.R script for the first time on your local machine, first run the prep.R script to ensure the folder structure is set up properly and all necessary packages are installed.

To re-run a day (perhaps the DAS was updated/corrected), use the das_reRunPrep.R script. This will remove previous entries for this date from the compiled data outputs and the dasList record of which das have been successfully processed. After cleaning those up, the full run.R script can be re-run and the latest copy of those DAS files will be downloaded and processed.

To re-run all days, delete the dasList*.Rda file from the ‘outputs’ folder and all the compiled*.Rda files from the ‘data’ folder (e.g., compiledDetections_OES2303.Rda).

Plot Examples - HICEAS 2023

As each survey leg completes we will share some example plots here!

Blank, pre-survey base map

HICEAS 2023 Base Map, A bathymetric map of the HICEAS study area and the planned transect lines. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ. This map image does not show any completed survey tracklines or cetacaen sightings but serves as the basemap that will be populated with this information as the survey gets underway.

Sette Leg 1

Visual sightings

HICEAS 2023 Map - End of Leg 1. This map shows the completed survey tracklines (pink) and cetacean sightings (colored symbols) that occured during HICEAS 2023 Leg 1 on the R/V *Oscar Elton Sette* from 23 to 28 July 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Acoustic detections

HICEAS 2023 Map - End of Leg 1. This map shows the completed survey tracklines (pink) and acoustic detections of cetaceans (colored symbols) that occured during HICEAS 2023 Leg 1 on the R/V *Oscar Elton Sette* from 23 to 28 July 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Sette Leg 2

Visual sightings

HICEAS 2023 Map - End of Leg 2. This map shows the completed survey tracklines (pink) and cetacean sightings (colored symbols) that occured during HICEAS 2023 through the end of Leg 2 on the R/V *Oscar Elton Sette* from 23 July to 31 August 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Acoustic detections

HICEAS 2023 Map - End of Leg 2. This map shows the completed survey tracklines (pink) and acoustic detections of cetaceans (colored symbols) that occured during HICEAS 2023 through the end of Leg 2 on the R/V *Oscar Elton Sette* from 23 July to 31 August 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Sette Leg 3

Visual sightings

HICEAS 2023 Map - End of Leg 3. This map shows the completed survey tracklines (pink) and cetacean sightings (colored symbols) that occured during HICEAS 2023 through the end of Leg 3 on the R/V *Oscar Elton Sette* from 23 July to 3 October 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Acoustic detections

HICEAS 2023 Map - End of Leg 3. This map shows the completed survey tracklines (pink) and acoustic detections of cetaceans (colored symbols) that occured during HICEAS 2023 through the end of Leg 3 on the R/V *Oscar Elton Sette* from 23 July to 3 October 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Sette Leg 4/Lasker Leg 1

Visual sightings

HICEAS 2023 Map - End of OES Leg 4/LSK Leg 1. This map shows the completed survey tracklines (*Sette* in pink and *Lasker* in orange) and cetacean sightings (colored symbols) that occured during HICEAS 2023 through the end of Leg 4 on the R/V *Oscar Elton Sette* and Leg 1 on the R/V *Reuben Lasker* from 23 July to 5 November 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Acoustic detections

HICEAS 2023 Map - End of OES Leg 4/LSK Leg 1. This map shows the completed survey tracklines (*Sette* in pink and *Lasker* in orange) and acoustic detections of cetaceans (colored symbols) that occured during HICEAS 2023 through the end of Leg 4 on the R/V *Oscar Elton Sette* and Leg 1 on the R/V *Reuben Lasker* from 23 July to 5 November 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Sette Leg 5/Lasker Leg 2

Visual sightings

HICEAS 2023 Map - End of OES Leg 5/LSK Leg 2. This map shows the completed survey tracklines (*Sette* in pink and *Lasker* in orange) and cetacean sightings (colored symbols) that occured during HICEAS 2023 through the end of Leg 5 on the R/V *Oscar Elton Sette* and Leg 2 on the R/V *Reuben Lasker* from 23 July to 4 December 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Acoustic detections

HICEAS 2023 Map - End of OES Leg 5/LSK Leg 2. This map shows the completed survey tracklines (*Sette* in pink and *Lasker* in orange) and acoustic detections of cetaceans (colored symbols) that occured during HICEAS 2023 through the end of Leg 5 on the R/V *Oscar Elton Sette* and Leg 2 on the R/V *Reuben Lasker* from 23 July to 4 December 2023. The U.S. Exclusive Economic Zone (EEZ) surrounding the Hawaiian archipelago (study area) is marked with a white boundary line and planned transect lines are in thin black lines. The Papahānaumokuākea Marine National Monument area and Main Hawaiian Islands are labeled in white text. The transect lines run lengthwise from northwest to southeast, covering the entire EEZ.

Suggestions and Comments

If you see that the data, product, or metadata can be improved, you are invited to create a pull request, or submit an issue to this repository

If you notice the map has not been updated in a few days, please submit an issue. Sometimes that can happen if our processing computer reboots or there is an authentication issue. We will see the issue and check it out!

R Version Metadata

FALSE R version 4.3.1 (2023-06-16 ucrt)
FALSE Platform: x86_64-w64-mingw32/x64 (64-bit)
FALSE Running under: Windows 10 x64 (build 19045)
FALSE 
FALSE Matrix products: default
FALSE 
FALSE 
FALSE locale:
FALSE [1] LC_COLLATE=English_United States.utf8 
FALSE [2] LC_CTYPE=English_United States.utf8   
FALSE [3] LC_MONETARY=English_United States.utf8
FALSE [4] LC_NUMERIC=C                          
FALSE [5] LC_TIME=English_United States.utf8    
FALSE 
FALSE time zone: America/Los_Angeles
FALSE tzcode source: internal
FALSE 
FALSE attached base packages:
FALSE [1] stats     graphics  grDevices utils     datasets  methods   base     
FALSE 
FALSE other attached packages:
FALSE [1] fontawesome_0.5.2
FALSE 
FALSE loaded via a namespace (and not attached):
FALSE  [1] digest_0.6.33     utf8_1.2.4        R6_2.5.1          fastmap_1.1.1    
FALSE  [5] xfun_0.40         glue_1.6.2        rsvg_2.5.0        knitr_1.45       
FALSE  [9] htmltools_0.5.6   rmarkdown_2.25    lifecycle_1.0.4   cli_3.6.1        
FALSE [13] fansi_1.0.5       readtext_0.90     vctrs_0.6.4       data.table_1.14.8
FALSE [17] compiler_4.3.1    highr_0.10        httr_1.4.7        rstudioapi_0.15.0
FALSE [21] tools_4.3.1       pillar_1.9.0      evaluate_0.23     yaml_2.3.7       
FALSE [25] rlang_1.1.1       stringi_1.7.12

NOAA Disclaimer and License

This repository is a scientific product and is not official communication of the National Oceanic and Atmospheric Administration, or the United States Department of Commerce. All NOAA GitHub project code is provided on an ‘as is’ basis and the user assumes responsibility for its use. Any claims against the Department of Commerce or Department of Commerce bureaus stemming from the use of this GitHub project will be governed by all applicable Federal law. Any reference to specific commercial products, processes, or services by service mark, trademark, manufacturer, or otherwise, does not constitute or imply their endorsement, recommendation or favoring by the Department of Commerce. The Department of Commerce seal and logo, or the seal and logo of a DOC bureau, shall not be used in any manner to imply endorsement of any commercial product or activity by DOC or the United States Government.

Software code created by U.S. Government employees is not subject to copyright in the United States (17 U.S.C. §105). The United States/Department of Commerce reserve all rights to seek and obtain copyright protection in countries other than the United States for Software authored in its entirety by the Department of Commerce. To this end, the Department of Commerce hereby grants to Recipient a royalty-free, nonexclusive license to use, copy, and create derivative works of the Software outside of the United States.

NOAA Fisheries

U.S. Department of Commerce | National Oceanographic and Atmospheric Administration | NOAA Fisheries