Merge pull request #23 from boshek/master

Adding wsc_drainages

Author: stephhazlitt

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: bcmaps
 Title: Map layers for British Columbia
-Version: 0.11.0
+Version: 0.12.0
 Authors@R: c(person("Andy", "Teucher", email = "andy.teucher@gov.bc.ca",
   role = c("aut", "cre")), person("Stephanie", "Hazlitt", email = "stephanie.hazlitt@gov.bc.ca",
   role = "aut"), person("Sam", "Albers", email = "sam.albers@gov.bc.ca", role = "aut"),

NEWS.md

@@ -1,3 +1,7 @@
+# bcmaps 0.12.0
+
+* Added `wsc_drainages`
+
 # bcmaps 0.11.0
 
 * Added `hydrozones` dataset.

R/wsc_drainages.R

@@ -0,0 +1,34 @@
+# Copyright 2017 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.
+#'
+#' For use in showing the 4th level drainages (sub-sub-drainages) in the national Drainage Area Framework and
+#' for use in determining the Water Survey of Canada alphanumeric codes that are used in hydrometric station numbering.
+#'
+#' Atlas of Canada 1,000,000 National Frameworks Data, Hydrology - Drainage Areas (WSC sub-sub drainage areas)
+#' from the Natural Resources Canada GeoGratis website. The dataset has been clipped to drainage areas within
+#' or adjacent to B.C.
+#'
+#'
+#'
+#' @format Water Survey of Canada Sub-Sub-Drainage Areas
+#'
+#' @details Downloaded from Natural Resources Canada GeoGratis website (http://geogratis.gc.ca/api/en/nrcan-rncan/ess-sst/30b33615-6dda-51a5-a9dd-308802714a28.html)
+#' and clipped to the area around B.C, then re-projected to BC Albers projection. Some attribute fields were removed, and other
+#' attribute field names were changed.
+#'
+#'
+#' @source Original data from
+#'   \href{https://catalogue.data.gov.bc.ca/dataset/water-survey-of-canada-sub-sub-drainage-areas}{DataBC},
+#'    under the
+#'   \href{http://open.canada.ca/en/open-government-licence-canada}{Open Government License - Canada} version 2.0.
+
+"wsc_drainages"

README.Rmd

@@ -47,7 +47,7 @@ install_github("bcgov/bcmaps", build_vignettes = TRUE)
 
 ### Usage
 
-At the moment, there are fifteen layers available:
+At the moment, there are sixteen layers available:
 
 - `bc_bound`: Coarse provincial boundary of British Columbia (1:7.5M scale).
 
@@ -83,6 +83,8 @@ At the moment, there are fifteen layers available:
 
 - `hydrozones`: Hydrologic Zone Boundaries of British Columbia.
 
+- `wsc_drainages`: Water Survey of Canada Sub-Sub-Drainage Areas
+
 To load any of them, simply type `data(layer_name)`, where `layer_name` is the 
 name of the layer of interest. Then you can use the data as you would any `sp`
 object. 
@@ -177,5 +179,7 @@ The data and code in this repository is licensed under multiple licenses.
 
 - Source data in `/data-raw/gw_aquifers`, `/data-raw/water_districts` and `/data-raw/water_precincts` is licensed under the [Open Government License - British Columbia version 2.0](http://www2.gov.bc.ca/gov/content?id=A519A56BC2BF44E4A008B33FCF527F61). See LICENSE.OGL-vbc2.0.pdf in the appropriate directory.
 
+- Source data in `/data-raw/wsc_drainages` is licensed under the [Open Government License - Canada version 2.0](http://open.canada.ca/en/open-government-licence-canada). See LICENSE.Canada-OGL-2.0 in the appropriate directory.
+
 
 This repository is maintained by [Environmental Reporting BC](http://www2.gov.bc.ca/gov/content?id=FF80E0B985F245CEA62808414D78C41B). Click [here](https://github.com/bcgov/EnvReportBC-RepoList) for a complete list of our repositories on GitHub.

README.md

@@ -27,7 +27,7 @@ install_github("bcgov/bcmaps", build_vignettes = TRUE)
 
 ### Usage
 
-At the moment, there are fifteen layers available:
+At the moment, there are sixteen layers available:
 
 -   `bc_bound`: Coarse provincial boundary of British Columbia (1:7.5M scale).
 
@@ -63,6 +63,8 @@ At the moment, there are fifteen layers available:
 
 -   `hydrozones`: Hydrologic Zone Boundaries of British Columbia.
 
+-   `wsc_drainages`: Water Survey of Canada Sub-Sub-Drainage Areas
+
 To load any of them, simply type `data(layer_name)`, where `layer_name` is the name of the layer of interest. Then you can use the data as you would any `sp` object.
 
 A couple of simple examples:
@@ -169,4 +171,6 @@ The data and code in this repository is licensed under multiple licenses.
 
 -   Source data in `/data-raw/gw_aquifers`, `/data-raw/water_districts` and `/data-raw/water_precincts` is licensed under the [Open Government License - British Columbia version 2.0](http://www2.gov.bc.ca/gov/content?id=A519A56BC2BF44E4A008B33FCF527F61). See LICENSE.OGL-vbc2.0.pdf in the appropriate directory.
 
+-   Source data in `/data-raw/wsc_drainages` is licensed under the [Open Government License - Canada version 2.0](http://open.canada.ca/en/open-government-licence-canada). See LICENSE.Canada-OGL-2.0 in the appropriate directory.
+
 This repository is maintained by [Environmental Reporting BC](http://www2.gov.bc.ca/gov/content?id=FF80E0B985F245CEA62808414D78C41B). Click [here](https://github.com/bcgov/EnvReportBC-RepoList) for a complete list of our repositories on GitHub.

data-raw/process_wsc_drainages.R

@@ -0,0 +1,29 @@
+# Copyright 2016 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.
+
+library("sp")
+library("rgdal")
+library("devtools")
+
+wsc_drainages_zip <- "data-raw/wsc_drainages/wsc_drainages.zip"
+
+unzip(wsc_drainages_zip, exdir = "data-raw/wsc_drainages")
+
+wsc_drainages <- readOGR(dsn = "data-raw/wsc_drainages/SSDA",
+                        layer = "SSDA_polygon", stringsAsFactors = FALSE)
+
+wsc_drainages <- spTransform(wsc_drainages, "+init=epsg:3005")
+
+## deal with a non ASCII character in the data
+wsc_drainages$WSCSSDA_EN <- iconv(wsc_drainages$WSCSSDA_EN, "UTF-8", sub = "")
+
+use_data(wsc_drainages, overwrite = TRUE, compress = "xz")

data-raw/wsc_drainages/.gitignore

@@ -0,0 +1,5 @@
+SSDA
+README.txt
+contents_of_order.txt
+licence.txt
+SSDA.html

data-raw/wsc_drainages/LICENSE.OGL-CAN-2.0

@@ -0,0 +1,65 @@
+http://open.canada.ca/en/open-government-licence-canada
+
+Open Government Licence - Canada
+
+You are encouraged to use the Information that is available under this licence with only a few conditions.
+Using Information under this licence
+
+    Use of any Information indicates your acceptance of the terms below.
+    The Information Provider grants you a worldwide, royalty-free, perpetual, non-exclusive licence to use the Information, including for commercial purposes, subject to the terms below.
+
+You are free to:
+
+    Copy, modify, publish, translate, adapt, distribute or otherwise use the Information in any medium, mode or format for any lawful purpose.
+
+You must, where you do any of the above:
+
+    Acknowledge the source of the Information by including any attribution statement specified by the Information Provider(s) and, where possible, provide a link to this licence.
+    If the Information Provider does not provide a specific attribution statement, or if you are using Information from several information providers and multiple attributions are not practical for your product or application, you must use the following attribution statement:
+
+Contains information licensed under the Open Government Licence – Canada.
+
+The terms of this licence are important, and if you fail to comply with any of them, the rights granted to you under this licence, or any similar licence granted by the Information Provider, will end automatically.
+Exemptions
+
+This licence does not grant you any right to use:
+
+    Personal Information;
+    third party rights the Information Provider is not authorized to license;
+    the names, crests, logos, or other official symbols of the Information Provider; and
+    Information subject to other intellectual property rights, including patents, trade-marks and official marks.
+
+Non-endorsement
+
+This licence does not grant you any right to use the Information in a way that suggests any official status or that the Information Provider endorses you or your use of the Information.
+No Warranty
+
+The Information is licensed “as is”, and the Information Provider excludes all representations, warranties, obligations, and liabilities, whether express or implied, to the maximum extent permitted by law.
+
+The Information Provider is not liable for any errors or omissions in the Information, and will not under any circumstances be liable for any direct, indirect, special, incidental, consequential, or other loss, injury or damage caused by its use or otherwise arising in connection with this licence or the Information, even if specifically advised of the possibility of such loss, injury or damage.
+Governing Law
+
+This licence is governed by the laws of the province of Ontario and the applicable laws of Canada.
+
+Legal proceedings related to this licence may only be brought in the courts of Ontario or the Federal Court of Canada.
+Definitions
+
+In this licence, the terms below have the following meanings:
+
+"Information"
+    means information resources protected by copyright or other information that is offered for use under the terms of this licence.
+"Information Provider"
+    means Her Majesty the Queen in right of Canada.
+“Personal Information”
+    means “personal information” as defined in section 3 of the Privacy Act, R.S.C. 1985, c. P-21.
+"You"
+    means the natural or legal person, or body of persons corporate or incorporate, acquiring rights under this licence.
+
+Versioning
+
+This is version 2.0 of the Open Government Licence – Canada. The Information Provider may make changes to the terms of this licence from time to time and issue a new version of the licence. Your use of the Information will be governed by the terms of the licence in force as of the date you accessed the information.
+
+Date modified:
+    2015-03-11
+
+

data-raw/wsc_drainages/README.md

@@ -0,0 +1,3 @@
+## Water Survey of Canada Sub-Sub-Drainage Areas
+
+The file `wsc_drainages.zip` contains the Water Survey of Canada Sub-Sub-Drainage Areas, downloaded from [DataBC](https://catalogue.data.gov.bc.ca/dataset/water-survey-of-canada-sub-sub-drainage-areas) under the ([Open Government License - Canada](http://open.canada.ca/en/open-government-licence-canada)).