
Retrieve apparent fishing effort and convert response to tibble
Source:R/get_raster.R
get_raster.Rd
Retrieve apparent fishing effort and convert response to tibble
Usage
get_raster(
spatial_resolution = NULL,
temporal_resolution = NULL,
start_date = "2023-01-01",
end_date = "2023-12-31",
region_source = NULL,
region = NULL,
group_by = NULL,
filter_by = NULL,
key = gfw_auth(),
print_request = FALSE
)
Arguments
- spatial_resolution
Raster spatial resolution. Can be
"LOW"
(0.1 degree) or"HIGH"
(0.01 degree).- temporal_resolution
Raster temporal resolution. Can be
"HOURLY"
,"DAILY"
,"MONTHLY"
,"YEARLY"
.- start_date
Required. Start of date range to search events, in YYYY-MM-DD format and including this date.
- end_date
Required. End of date range to search events, in YYYY-MM-DD format and excluding this date.
- region_source
Required. Source of the region:
"EEZ"
,"MPA"
,"RFMO"
or"USER_SHAPEFILE"
.- region
Required. If
region_source
is set to"EEZ"
,"MPA"
or"RFMO"
, GFW region code (seeget_region_id()
). Ifregion_source = "USER_SHAPEFILE"
,sf
shapefile with the area of interest.- group_by
Optional. Parameter to group by. Can be
"VESSEL_ID"
,"FLAG"
,"GEARTYPE"
,"FLAGANDGEARTYPE"
or"MMSI"
.- filter_by
Fields to filter AIS-based apparent fishing effort. Possible options are
flag
,shipname
,geartype
andid
(to filter for vessel ids). Receives SQL expressions likefilter_by = "flag IN ('ESP')"
.- key
Character, API token. Defaults to
gfw_auth()
.- print_request
Boolean. Whether to print the request, for debugging purposes. When contacting the GFW team it will be useful to send this string.
Examples
if (FALSE) { # \dontrun{
library(gfwr)
# using region codes
code_eez <- get_region_id(region_name = "CIV", region_source = "EEZ")
get_raster(spatial_resolution = "LOW",
temporal_resolution = "YEARLY",
group_by = "FLAG",
start_date = "2021-01-01",
end_date = "2022-01-01",
region = code_eez$id,
region_source = "EEZ",
key = gfw_auth(),
print_request = TRUE)
code_mpa <- get_region_id(region_name = "Galapagos", region_source = "MPA")
get_raster(spatial_resolution = "LOW",
temporal_resolution = "MONTHLY",
group_by = "FLAG",
start_date = "2022-01-01",
end_date = "2023-01-01",
region = code_mpa$id[3],
region_source = "MPA")
code_rfmo <- get_region_id(region_name = "IATTC", region_source = "RFMO")
get_raster(spatial_resolution = "LOW",
temporal_resolution = "MONTHLY",
start_date = "2022-01-01",
end_date = "2023-01-01",
region = code_rfmo$id[1],
region_source = "RFMO")
#using a sf from disk /loading a test sf object
data(test_shape)
get_raster(spatial_resolution = "LOW",
temporal_resolution = "YEARLY",
start_date = "2021-01-01",
end_date = "2021-10-01",
region = test_shape,
region_source = "USER_SHAPEFILE",
key = gfw_auth(),
print_request = TRUE)
} # }