bccm_all_variables_full: Download all 22 BCCM full model results from Zenodo to a...

In pbs-assess/PACea: An R package of Pacific ecosystem information to help facilitate an ecosystem approach to fisheries management

Download all 22 BCCM full model results from Zenodo to a local drive.

Description

This downloads (in parallel by default) all 22 BCCM full model results from https://zenodo.org/records/14031460 to your local cache directory given by 'paste0(pacea_cache(), "/bccm_full")'. Each file is around 120 Mb, and only took about two minutes each on a home network (and since was running on 6 parallel cores, it all took less than 10 minutes. Any files that are already present in your cache directory are not re-downloaded. You can look at your cache directory to see progress (files should gradually appear).

Usage

bccm_all_variables_full(run_parallel = TRUE, timeout_value = 14400)

Arguments

run_parallel	logical Run the downloads in parallel using 'parallel::foreach()'.
timeout_value	numeric Timeout (seconds) for downloading a single file from the internet. Gets used by [zen4R::download_zenodo()] via [get_zenodo_data()]. Try increasing if get an Error saying Timeout has been reached. If it says 'Timeout of 60 seconds' then 'timeout_value' is not getting used (the default is 4 hours). Maybe try the manual download option above.

Details

The download is done in parallel (by default). Speed depends on network speed and number of cores.

You can download individual files, see [bccm_bottom_oxygen_full()], but since the downloading is a one-time exercise it's likely desirable to just get them all at once, providing you have the disk space (around 2.4 Gb).

If you get an error saying 'Windows Defender Firewall has blocked some features of this app' when running from RStudio, try running from just R. You may as well try downloading all variables in one go with [bccm_all_variables_full()], then you will be fine as they will all then be cached on your machine. You can also try, in the command line in RStudio, the command ‘system2("R -e ’library(pacea); bccm_all_variables_full()'")'. If that does not work you will have to just run R and do 'library(pacea); bccm_all_variables_full()'.

If this function fails with a different error, you can try rerunning it; it will not re-download any that were successful and this worked for someone testing it. Else you could then also try 'hotssea_all_variables(run_parallel = FALSE)', or increasing the 'timeout' option even higher, especially if running from the Pacific Biological Station. This function is particularly hard to test independently under different scenarios.

Or you can always just download them manually (download all) from the Zenodo site given above) and put them in 'paste0(pacea_cache(), "/bccm_full")'.

Type 'bccm_data' to view the full list of available variables. See help files for specific variables for more details on BCCM model results, e.g. [bccm_bottom_temperature_full()].

Also see the two BCCM vignettes.

Value

downloaded files to 'paste0(pacea_cache(), "/bccm_full")' directory.

Author(s)

Andrew Edwards and Travis Tai

Examples

## Not run: 
bccm_all_variables_full()
plot(bccm_avg100mtoBot_temperature_full())

## End(Not run)

pbs-assess/PACea documentation built on April 17, 2025, 11:36 p.m.