Last updated: 2021-03-12

Checks: 6 1

Knit directory: mapme.protectedareas/

This reproducible R Markdown analysis was created with workflowr (version 1.6.2). The Checks tab describes the reproducibility checks that were applied when the results were created. The Past versions tab lists the development history.


The R Markdown file has unstaged changes. To know which version of the R Markdown file created these results, you’ll want to first commit it to the Git repo. If you’re still working on the analysis, you can ignore this warning. When you’re finished, you can run wflow_publish to commit the R Markdown file and build the HTML.

Great job! The global environment was empty. Objects defined in the global environment can affect the analysis in your R Markdown file in unknown ways. For reproduciblity it’s best to always run the code in an empty environment.

The command set.seed(20210305) was run prior to running the code in the R Markdown file. Setting a seed ensures that any results that rely on randomness, e.g. subsampling or permutations, are reproducible.

Great job! Recording the operating system, R version, and package versions is critical for reproducibility.

Nice! There were no cached chunks for this analysis, so you can be confident that you successfully produced the results during this run.

Great job! Using relative paths to the files within your workflowr project makes it easier to run your code on other machines.

Great! You are using Git for version control. Tracking code development and connecting the code version to the results is critical for reproducibility.

The results in this page were generated with repository version 93afdd7. See the Past versions tab to see a history of the changes made to the R Markdown and HTML files.

Note that you need to be careful to ensure that all relevant files for the analysis have been committed to Git prior to generating the results (you can use wflow_publish or wflow_git_commit). workflowr only checks the R Markdown file, but you know if there are other scripts or data files that it depends on. Below is the status of the Git repository when the results were generated:


Ignored files:
    Ignored:    .Rproj.user/
    Ignored:    mapme.protectedareas.Rproj
    Ignored:    renv/library/
    Ignored:    renv/local/
    Ignored:    renv/staging/

Unstaged changes:
    Modified:   .DS_Store
    Modified:   analysis/carbon-flux.rmd
    Modified:   code/carbon-flux.R

Note that any generated files, e.g. HTML, png, CSS, etc., are not included in this status report because it is ok for generated content to have uncommitted changes.


These are the previous versions of the repository in which changes were made to the R Markdown (analysis/carbon-flux.rmd) and HTML (docs/carbon-flux.html) files. If you’ve configured a remote Git repository (see ?wflow_git_remote), click on the hyperlinks in the table below to view the files as they were in that past version.

File Version Author Date Message
Rmd 93afdd7 GitHub 2021-03-11 minor updates carbon flux rmd
Rmd 0640985 Ohm-Np 2021-03-11 update carbon flux rmd with wdpar
html 0640985 Ohm-Np 2021-03-11 update carbon flux rmd with wdpar
Rmd 611bd97 Ohm-Np 2021-03-05 create net carbon flux rmd
html 611bd97 Ohm-Np 2021-03-05 create net carbon flux rmd

knitr::opts_knit$set(root.dir = '../')
# load required libraries
library("sp")
library("raster")
library("sf")
library("wdpar")
library("dplyr")

Introduction

Forest Carbon Emissions are GHG emissions that originate from forest cover loss and subsequent Above Ground Biomass and Below Ground Biomass loss. Net forest carbon flux represents the net exchange of carbon between forests and the atmosphere. Forest act as both a Source and Sink for Carbon.

To calculate zonal statistics for net forest carbon flux that changed between 2001 to 2019, enlisted is the required processing routine:

  • Download raster data of the desired grid using function get_net_carbon_flux
  • Fetch country level wdpa data from library wdpar
  • Select desired wdpa polygon from wdpa data
  • Clean the data
  • Clip the carbon_flux raster by the selected polygon to its extent and mask layer
  • Rasterize the selected polygon area
  • Perform zonal statistics

Raster data preparation

At first you should link to the source functions to go through this routine.

source("code/carbon-flux.R")

How to use the function?

  • you can call the function get_net_carbon_flux by passing (lat, lon) arguments as string for eg. (“10S”, “050W”) or (“10N”, “020E”)
  • you should check the coordinates of your desired area and need to find out the grid under which interval of latitude and longitude does it fall
  • or simply visit the GFW Dataset Portal to verify chosen grid coordinates
  • Note: If in case you choose to compute zonal statistics for larger polygon level or for many polygon levels, then one raster data might not be enough for your computation. Then you must download multiple raster files so as to cover the polygon extent and merge them later simply using merge function.
options(timeout=180) # sets timeout for downloads to 180seconds
# call the function to download raster for a part of the country Brazil where we want to compute zonal statistics
# Note: raster value is 'Mg_CO2_ha-1'
myRaster <- 
  get_net_carbon_flux("00N", "060W")

After successfully running this function, you can see that the raster file is stored in the temporary directory of R, which we can see above within double quote. For the next step, simply pass the returned temporary file path from the ‘callFunction’ chunk to the ‘loadRaster’ chunk so as to load the downloaded raster file.

# load the raster, view and plot the data
# myRaster <- raster("/tmp/Rtmps0oMVx/carbon_flux_00N_060W.tif")
# view the data
myRaster
class      : RasterLayer 
dimensions : 40000, 40000, 1.6e+09  (nrow, ncol, ncell)
resolution : 0.00025, 0.00025  (x, y)
extent     : -60, -50, -10, 0  (xmin, xmax, ymin, ymax)
crs        : +proj=longlat +datum=WGS84 +no_defs 
source     : /private/var/folders/rd/b48j37f10t5d8hs74tbqdpnw0000gn/T/RtmpFfe6w2/carbon_flux_00N_060W.tif 
names      : carbon_flux_00N_060W 
# plot the raster
plot(myRaster)

Version Author Date
0640985 Ohm-Np 2021-03-11

Polygon data preparation

Since we already prepared raster data for our analysis. Now, we will try to get the country level polygon data from wdpar package. wdpar is a library to interface to the World Database on Protected Areas (WDPA). The library is used to monitor the performance of existing PAs and determine priority areas for the establishment of new PAs.

# fetch the raw data from wdpar of country Brazil - for other countries of your choice, simply provide the country name or the ISO name e.g. Gy for Guyana, COL for Colombia
br_raw_pa_data <- wdpa_fetch("Brazil") #can also use wdpa_fetch("BRA")

Since there are more than 3000 enlisted protected areas in Brazil, we want to compute zonal statistics only for the polygon data of: - Reserva Biologica Do Rio Trombetas - wdpaid 43, - Reserva Extrativista Rio Cajari - wdpaid 31776, and - Estacao Ecologica Do Jari - wdpaid 4891

For this, we have to subset the country level polygon data to the pa level.

# subset three wdpa polygons by their wdpa ids
bra<-
  br_raw_pa_data%>%
  filter(WDPAID %in% c(43,4891,31776))

The next immediate step would be to clean the fetched raw data. Cleaning is done so as to: - exclude protected areas that are not yet implemented - exclude protected areas with limited conservation value - replace missing data codes (e.g. “0”) with missing data values (i.e. NA) - replace protected areas represented as points with circular protected areas that correspond to their reported extent - repair any topological issues with the geometries - erase overlapping areas

# clean the data
brac <- wdpa_clean(bra)
# spatial 
brac_sp <- as(brac, "Spatial")

Crop the Carbon Flux Raster

As we completed raster and vector data preparation, the next step would be to clip the raster layer by the selected shapefile polygon both by its extent and mask layer.

# extent preparation
myExtent <- spTransform(brac_sp, CRS(proj4string(myRaster)))
# plot the extent that will be used to crop the raster layer
plot(myExtent)

Version Author Date
0640985 Ohm-Np 2021-03-11
# crop raster using polygon extent
myCrop <- crop(myRaster, myExtent)
# plot the data - shows the raster after getting cropped by the extent of polygon
plot(myCrop)

Version Author Date
0640985 Ohm-Np 2021-03-11
# crop raster using polygon mask
myMask <- mask(myCrop, myExtent)
# plot the data - shows the raster after getting cropped by the polygon mask
plot(myMask)

Version Author Date
0640985 Ohm-Np 2021-03-11

Rasterize the polygon layer

To compute the zonal statistics, it is necessary to rasterize the polygon layer. Doing so, values are transferred from the spatial objects to raster cells. We need to pass the extent layer and the mask layer to the rasterize function.

# rasterize
r <- rasterize(myExtent, myMask, myExtent$WDPAID, background=NA, update=FALSE, touches=is.lines(myExtent), cover=FALSE)

Compute zonal statistics

A zonal statistics operation is one that calculates statistics on cell values of a raster (a value raster) within the zones defined by another dataset [ArcGIS definition].

# zonal stats
zstats <- zonal(myMask, r, fun='sum', na.rm=T)
zstats
      zone        sum
[1,]    43 -192709050
[2,]  4891 -123947679
[3,] 31776 -136209414

By mathematical definition, net forest carbon flux is the difference between average annual gross emissions and average annual gross removals. Hence, positive result denotes forests as net sources of carbon and negative results denotes forests as net sinks of carbon.

For all the three polygons we considered, we got the negative result. That means forests in these three Protected Areas act as the net sinks of carbon.


sessionInfo()
R version 4.0.3 (2020-10-10)
Platform: x86_64-apple-darwin17.0 (64-bit)
Running under: macOS Big Sur 10.16

Matrix products: default
BLAS:   /Library/Frameworks/R.framework/Versions/4.0/Resources/lib/libRblas.dylib
LAPACK: /Library/Frameworks/R.framework/Versions/4.0/Resources/lib/libRlapack.dylib

locale:
[1] en_US.UTF-8/en_US.UTF-8/en_US.UTF-8/C/en_US.UTF-8/en_US.UTF-8

attached base packages:
[1] stats     graphics  grDevices utils     datasets  methods   base     

other attached packages:
[1] dplyr_1.0.5  wdpar_1.0.6  sf_0.9-7     raster_3.4-5 sp_1.4-5    

loaded via a namespace (and not attached):
 [1] Rcpp_1.0.6         pillar_1.4.7       compiler_4.0.3     later_1.1.0.1     
 [5] git2r_0.27.1       workflowr_1.6.2    class_7.3-17       tools_4.0.3       
 [9] digest_0.6.27      evaluate_0.14      lifecycle_1.0.0    tibble_3.0.4      
[13] lattice_0.20-41    pkgconfig_2.0.3    rlang_0.4.10       DBI_1.1.0         
[17] rstudioapi_0.13    curl_4.3           rgdal_1.5-23       yaml_2.2.1        
[21] xfun_0.19          e1071_1.7-4        httr_1.4.2         stringr_1.4.0     
[25] knitr_1.30         rappdirs_0.3.3     generics_0.1.0     fs_1.5.0          
[29] vctrs_0.3.6        tidyselect_1.1.0   classInt_0.4-3     rprojroot_2.0.2   
[33] grid_4.0.3         glue_1.4.2         R6_2.5.0           rmarkdown_2.5     
[37] purrr_0.3.4        magrittr_2.0.1     whisker_0.4        units_0.6-7       
[41] promises_1.1.1     codetools_0.2-16   ellipsis_0.3.1     htmltools_0.5.0   
[45] assertthat_0.2.1   countrycode_1.2.0  httpuv_1.5.4       KernSmooth_2.23-17
[49] stringi_1.5.3      lwgeom_0.2-5       crayon_1.3.4