{"Package":"LAGOSNE","Title":"Interface to the Lake Multi-Scaled Geospatial and Temporal\nDatabase","Version":"1.1.0","Authors@R":"c(\nperson(\"Joseph\", \"Stachelek\",\nemail = \"stachel2@msu.edu\",\nrole = c(\"aut\", \"cre\"),\ncomment = c(ORCID = c(\"0000-0002-5924-2464\"))),\nperson(\"Samantha\",\"Oliver\",\nrole = c(\"aut\"),\ncomment = c(ORCID = c(\"0000-0001-5668-1165\"))),\nperson(\"Farzan\",\"Masrour\", role = c(\"aut\"))\n)","URL":"https://github.com/cont-limno/LAGOSNE","BugReports":"https://github.com/cont-limno/LAGOSNE/issues","Description":"Client for programmatic access to the Lake\nMulti-scaled Geospatial and Temporal database , with functions\nfor accessing lake water quality and ecological context data for the US.","Depends":"R (>= 3.3.1)","Imports":"dplyr (>= 0.7.0), rappdirs (>= 0.3.1), lazyeval (>= 0.2),\npurrr (>= 0.2.2.2), magrittr (>= 1.5), sf, curl (>= 2.7.0),\nstringr (>= 1.2.0)","Suggests":"testthat, knitr, rmarkdown, devtools, prettydoc, R.rsp","License":"GPL","Encoding":"UTF-8","LazyData":"true","RoxygenNote":"6.0.1","VignetteBuilder":"R.rsp, knitr","NeedsCompilation":"no","Packaged":"2017-12-13 01:56:29 UTC; jose","Author":"Joseph Stachelek [aut, cre] (0000-0002-5924-2464),\nSamantha Oliver [aut] (0000-0001-5668-1165),\nFarzan Masrour [aut]","Maintainer":"Joseph Stachelek ","Repository":"CRAN","Date/Publication":"2017-12-13 04:12:32 UTC","repoType":"cran","tarballUrl":"ftp://cran.r-project.org/pub/R/src/contrib/LAGOSNE_1.1.0.tar.gz","jsonAuthors":[{"name":"Joseph Stachelek","email":"stachel2@msu.edu","maintainer":true},{"name":"Samantha Oliver","email":null,"maintainer":false},{"name":"Farzan Masrour","email":null,"maintainer":false}],"readme":"\n\n

\n\n[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active) [![Travis-CI Build Status](https://travis-ci.org/cont-limno/LAGOSNE.svg?branch=master)](https://travis-ci.org/cont-limno/LAGOSNE) [![CRAN\\_Status\\_Badge](http://www.r-pkg.org/badges/version/LAGOSNE)](https://cran.r-project.org/package=LAGOSNE) [![CRAN RStudio mirror downloads](http://cranlogs.r-pkg.org/badges/LAGOSNE)](https://cran.r-project.org/package=LAGOSNE)\n\nThe `LAGOSNE` package provides an R interface to download LAGOS-NE data from remote databases, store this data locally, and perform a variety of filtering and subsetting operations.\n\nInstallation\n------------\n\n``` r\n# install stable version from CRAN\ninstall.packages(\"LAGOSNE\")\n\n# install development version from Github\n# install devtools if not found - install.packages(\"devtools\")\n# devtools::install_github(\"cont-limno/LAGOSNE\", update_dependencies = TRUE)\n```\n\n### Data\n\nThe `lagosne_get` function downloads the LAGOSNE files corresponding to the specified version from the [EDI data repository](https://portal.edirepository.org/nis/home.jsp). Files are stored in a temporary directory before being \"compiled\" to an `R` data format in the location returned by `rappdirs::user_data_dir()`. Data only needs to be downloaded one time per version per machine. **The latest version of the `LAGOSNE` dataset is `1.087.1`.**\n\n``` r\nlibrary(LAGOSNE)\nlagosne_get(\"1.087.1\")\n```\n\nUsage\n-----\n\n### Load Package\n\n``` r\nlibrary(LAGOSNE)\n```\n\n### Load data\n\nThe `lagosne_load` function returns a named list of `data.frame` objects. Use the `names()` function to see a list of available `data.frame`s.\n\n``` r\ndt <- lagosne_load(version = \"1.087.1\")\nnames(dt)\n#> [1] \"county\" \"county.chag\" \"county.conn\" \n#> [4] \"county.lulc\" \"edu\" \"edu.chag\" \n#> [7] \"edu.conn\" \"edu.lulc\" \"hu4\" \n#> [10] \"hu4.chag\" \"hu4.conn\" \"hu4.lulc\" \n#> [13] \"hu8\" \"hu8.chag\" \"hu8.conn\" \n#> [16] \"hu8.lulc\" \"hu12\" \"hu12.chag\" \n#> [19] \"hu12.conn\" \"hu12.lulc\" \"iws\" \n#> [22] \"iws.conn\" \"iws.lulc\" \"state\" \n#> [25] \"state.chag\" \"state.conn\" \"state.lulc\" \n#> [28] \"buffer100m\" \"buffer100m.lulc\" \"buffer500m\" \n#> [31] \"buffer500m.conn\" \"buffer500m.lulc\" \"lakes.geo\" \n#> [34] \"epi_nutr\" \"lakes_limno\" \"secchi\" \n#> [37] \"lagos_source_program\" \"locus\"\n```\n\n#### Preview a table\n\n``` r\nhead(dt$county)\n#> county_state county_name county_ha_in_nwi county_ha county_zoneid\n#> 1 CT Fairfield County 167421.8 168044.3 County_1\n#> 2 IL Ford County 125912.3 125912.3 County_10\n#> 3 IL Stark County 74682.0 74682.0 County_100\n#> 4 IL Stephenson County 146269.3 146269.3 County_101\n#> 5 IL Tazewell County 170204.0 170204.0 County_102\n#> 6 IL Vermilion County 233543.6 233543.6 County_103\n#> county_pct_in_nwi county_lat conty_long\n#> 1 100 41.27225 -73.38940\n#> 2 100 40.59720 -88.22340\n#> 3 100 41.09336 -89.79749\n#> 4 100 42.35175 -89.66246\n#> 5 100 40.50731 -89.51343\n#> 6 100 40.18342 -87.73293\n```\n\n#### Read table metadata\n\n``` r\nhelp.search(\"datasets\", package = \"LAGOSNE\")\n```\n\n| Package | Topic | Title |\n|:--------|:----------------|:-----------------------------------------|\n| LAGOSNE | chag | CHAG Datasets |\n| LAGOSNE | classifications | LAGOSNE Spatial Classifications Metadata |\n| LAGOSNE | conn | Connectivity Datasets |\n| LAGOSNE | epi\\_nutr | Epilimnion Water Quality Data |\n| LAGOSNE | lagoslakes | Lake Geospatial Metadata |\n| LAGOSNE | lakes\\_limno | Metadata for Lakes with Water Quality |\n| LAGOSNE | lg\\_subset | LAGOSNE subset |\n| LAGOSNE | locus | Metadata for all lakes > 1ha |\n| LAGOSNE | lulc | Land Use Land Cover (LULC) Data Frames |\n| LAGOSNE | secchi | Secchi (Water Clarity) Data |\n| LAGOSNE | source | LAGOSNE sources |\n\n### Select data\n\n`lagosne_select` is a convenience function whose primary purpose is to provide users with the ability to select subsets of LAGOS tables that correspond to specific keywords (see `LAGOS:::keyword_partial_key()`). See [here](http://adv-r.had.co.nz/Subsetting.html) for a comprehensive tutorial on generic `data.frame` subsetting.\n\n``` r\n# specific variables\n head(lagosne_select(table = \"epi_nutr\", vars = c(\"tp\", \"tn\")))\n#> tp tn\n#> 1 30 NA\n#> 2 10 NA\n#> 3 5 NA\n#> 4 9 NA\n#> 5 5 NA\n#> 6 27 NA\n head(lagosne_select(table = \"iws.lulc\", vars = c(\"iws_nlcd2011_pct_95\")))\n#> iws_nlcd2011_pct_95\n#> 1 2.77\n#> 2 2.97\n#> 3 0.27\n#> 4 0.00\n#> 5 0.00\n#> 6 0.00\n\n# categories\nhead(lagosne_select(table = \"epi_nutr\", categories = \"waterquality\"))\n#> chla colora colort dkn doc nh4 no2 no2no3 srp tdn tdp tkn tn toc ton tp\n#> 1 NA NA NA NA NA 20 NA 20 NA NA NA NA NA NA NA 30\n#> 2 NA NA NA NA NA 20 NA 20 NA NA NA NA NA NA NA 10\n#> 3 3.9 NA 15 NA NA NA NA NA NA NA NA NA NA NA NA 5\n#> 4 4.8 NA 15 NA NA NA NA NA NA NA NA NA NA NA NA 9\n#> 5 2.1 NA NA NA NA NA NA NA NA NA NA NA NA NA NA 5\n#> 6 6.6 15 NA NA NA NA NA NA NA NA NA NA NA NA NA 27\n#> secchi\n#> 1 NA\n#> 2 NA\n#> 3 6.5\n#> 4 5.8\n#> 5 6.1\n#> 6 2.4\nhead(lagosne_select(table = \"county.chag\", categories = \"hydrology\"))\n#> county_baseflowindex_min county_baseflowindex_max\n#> 1 45 55\n#> 2 30 35\n#> 3 28 35\n#> 4 34 66\n#> 5 22 40\n#> 6 28 37\n#> county_baseflowindex_mean county_baseflowindex_std\n#> 1 48.3755 1.8683\n#> 2 32.6106 1.4480\n#> 3 31.5548 1.3772\n#> 4 53.1078 4.6081\n#> 5 32.4689 4.1342\n#> 6 34.4157 1.1100\nhead(lagosne_select(table = \"hu4.chag\", categories = \"deposition\")[,1:4])\n#> hu4_dep_no3_1985_min hu4_dep_no3_1985_max hu4_dep_no3_1985_mean\n#> 1 7.2171 10.0448 7.9366\n#> 2 9.5538 21.1791 15.5290\n#> 3 15.5222 22.8936 19.6234\n#> 4 8.5831 31.3832 17.2809\n#> 5 15.6669 24.2653 19.0625\n#> 6 12.6550 26.8946 18.1940\n#> hu4_dep_no3_1985_std\n#> 1 0.3868\n#> 2 2.2330\n#> 3 1.3634\n#> 4 3.2954\n#> 5 1.5500\n#> 6 1.8389\n\n# mix of specific variables and categories\nhead(lagosne_select(table = \"epi_nutr\", vars = \"lagoslakeid\", categories = c(\"waterquality\")))\n#> lagoslakeid chla colora colort dkn doc nh4 no2 no2no3 srp tdn tdp tkn tn\n#> 1 2 NA NA NA NA NA 20 NA 20 NA NA NA NA NA\n#> 2 2 NA NA NA NA NA 20 NA 20 NA NA NA NA NA\n#> 3 2 3.9 NA 15 NA NA NA NA NA NA NA NA NA NA\n#> 4 2 4.8 NA 15 NA NA NA NA NA NA NA NA NA NA\n#> 5 2 2.1 NA NA NA NA NA NA NA NA NA NA NA NA\n#> 6 3 6.6 15 NA NA NA NA NA NA NA NA NA NA NA\n#> toc ton tp secchi\n#> 1 NA NA 30 NA\n#> 2 NA NA 10 NA\n#> 3 NA NA 5 6.5\n#> 4 NA NA 9 5.8\n#> 5 NA NA 5 6.1\n#> 6 NA NA 27 2.4\n```\n\nPublished LAGOSNE subsets\n-------------------------\n\n``` r\n# Oliver et al. 2015\nlagos_get_oliver_2015()\n```\n\n``` r\ndt <- lagos_load_oliver_2015()\nhead(dt)\n#> lagoslakeid nhdid hu4id lat_decimal long_decimal area zmaxobs\n#> 1 1 50524769 202 42.54739 -73.17425 114.95 2.7\n#> 2 2 123632625 108 42.18409 -73.04728 24.87 6.1\n#> 3 3 50524793 202 42.53081 -73.19155 75.41 1.8\n#> 4 4 135695054 109 42.45435 -71.14079 9.26 5.2\n#> 5 5 135693974 109 42.60405 -70.82267 14.00 3.4\n#> 6 6 122373608 110 42.14209 -72.11992 80.29 13.7\n#> zmaxpredict\n#> 1 10.6\n#> 2 7.1\n#> 3 8.6\n#> 4 3.7\n#> 5 5.4\n#> 6 10.1\n```\n\nLegacy Versions\n---------------\n\n### R Package\n\nTo install versions of `LAGOSNE` compatible with older versions of LAGOS-NE run the following command where `ref` is set to the desired version (in the example, it is version 1.054.1):\n\n``` r\n# install devtools if not found\n# install.packages(\"devtools\")\ndevtools::install_github(\"cont-limno/LAGOSNE\", ref = \"v1.054.1\")\n```\n\n### Data\n\nUntil older datasets have been made available in a public repository, LAGOSNE users will need to use the `lagosne_compile` function (not `lagosne_get`) and supply the path to their local `locus`, `limno` and `geo` data folders. Replace the paths in the example below with the path to each respective folder on your system. Most people will have access to these folders through Dropbox. For example, the `limno_folder` would be assigned to something like: `C:/Users/FWL/Dropbox/CSI_LAGOS-exports/LAGOS-NE-LIMNO-EXPORT`\n\n``` r\nlibrary(LAGOSNE)\nlagosne_compile(\"1.054.1\", format = \"rds\",\n limno_folder = \"~/Downloads/LAGOS-NE-LIMNO-EXPORT\",\n geo_folder = \"~/Downloads/LAGOS-NE-GEO-EXPORT\",\n locus_folder = \"~/Downloads/LAGOS-NE-LOCUS-EXPORT\")\n```\n\nReferences\n----------\n\nOliver, SK, PA Soranno, CE Fergus, T Wagner, K Webster, CE Scott, LA Winslow, J Downing, and EH Stanley. 2015. “LAGOS - Predicted and Observed Maximum Depth Values for Lakes in a 17-State Region of the U.S.” .\n\nSoranno, P.A., Bacon, L.C., Beauchene, M., Bednar, K.E., Bissell, E.G., Boudreau, C.K., Boyer, M.G., Bremigan, M.T., Carpenter, S.R., Carr, J.W. Cheruvelil, K.S., and ... , 2017. LAGOS-NE: A multi-scaled geospatial and temporal database of lake ecological context and water quality for thousands of US lakes. GigaScience, \n\nSoranno, PA, EG Bissell, KS Cheruvelil, ST Christel, SM Collins, CE Fergus, CT Filstrup, et al. 2015. “Building a Multi-Scaled Geospatial Temporal Ecology Database from Disparate Data Sources: Fostering Open Science and Data Reuse.” Gigascience 4 (1). .\n\nStachelek, J, and SK Oliver. 2017. LAGOSNE: Interface to the Lake Multi-Scaled Geospatial and Temporal Database. .","jobInfo":{"package":"LAGOSNE","version":"1.1.0","parsingStatus":"success","parserVersion":1,"parsedAt":"2019-01-22T22:29:50+0000"}}

Description

Arguments