na-wau-layers

Usage

The na-wau-layers repository processes new B.C. geospatial layers and adds them into the WAU Biodiversity Layer. The process uses the most recent version of the WAU Biodiversity Layer, adds the new information, and re-writes a new version of the WAU Biodiversity Layer.

To process new layers, there are three options: 1. vector 2. vector to raster (rasterize) 3. raster

The option used will depend on the format of the input layer, the information you want to include in the WAU Biodiversity Layer, and the file size (processing time). Additional considerations are provided below.

Considerations

• The WAU Biodiversity Layer currently considers areas outside of current Parks and Protected Areas and Other Area-Based Conservation Measures (OECMs) current to 2021. New layers do not necessarily need to follow this standard, but users should be aware of the current data extent.
• Layers should be clean and ready to use prior to inclusion in the WAU Biodiversity Layer.This repository does not provide cleaning steps for data processing. It is assumed to be done by the user.
• There are processing options throughout for vector or raster files. It is up to the user to decide what type of file to use. Options are listed below in the order they are presented in the scripts:

1. Where multiple metrics are required (e.g. species number, species name) - processing should likely be done in vector format.
2. For area-only metrics - raster processing will be faster. The 01_load.R script ensures the raster is in Hectares BC format prior to processing.

Processing Steps

The first step in processing a new layer is to fill in the header.R file. An example is below using old-growth data.

Header Example

#update with file of interest
spatialOutDir <- "out/"
layer_file <- file.path("data/old-growth/old-growth.shp")
out_dir <- file.path("out/old-growth/")
dir.create(out_dir) #creates an output folder
#> Warning in dir.create(out_dir): 'out\old-growth' already exists
element <- 'priority_old_growth'  # use underscores only, used as a file name but also column name

After the header script is completed, there are 4 (or 5 for vector) scripts that need to be run in order:

• 01_load.R - options for vector or raster
• 02_intersect_wau.R - options for vector or raster
• 03_binning.R - same for both type of inputs
• 04_vector-metrics.R - only use for vector inputs
• 05_output.R

There is an optional .rmd script (layer-metadata.Rmd) that will produce a metadata file for the layer after is it processed.

Getting Help or Reporting an Issue

To report bugs/issues/feature requests, please file an issue.

How to Contribute

If you would like to contribute, please see our CONTRIBUTING guidelines.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

License

Copyright 2021 Province of British Columbia

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and limitations under the License.

---

This project was created using the bcgovr package.