Skip to content

NCEAS/vegbank-web

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

859 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VegBank Web: A Shiny Web App for Vegetation Plot Data

Citation

Darian Gill, Jim Regetz, Matthew B. Jones, Michael T. Lee, Matthew Brooke, Robert K. Peet (2026) VegBank Web: A Shiny Web App for Vegetation Plot Data. Version 1.0.0. VegBank. doi:10.82902/J1H59R

Overview

This package is a web access point for VegBank, the vegetation plot database of the Ecological Society of America's Panel on Vegetation Classification, hosted by the National Center for Ecological Analysis and Synthesis (NCEAS). You can find it running at vegbank.org.

VegBank contains vegetation plot and community data that supports the development of the U.S. National Vegetation Classification. As a VegBank API client, the 'vegbankweb' package supports browsing, searching, and inspecting vegetation plot records and other supporting information in the VegBank database.

VegBank in general, and the vegbankweb package in particular, are open source, community projects. We welcome contributions in many forms, including code, data, documentation, bug reports, testing, etc. Use the VegBank Discussions, or email help@vegbank.org to discuss these contributions with us.

The data shown in vegbankweb are also available for access with R via the vegbankr R package, and in other languages via the VegBank REST API. To upload data, request contributor permissions from the ESA Vegetation Classification Panel. Once your contributor role is granted, you will be able to upload new plot data with the vegbankr R package.

Running Locally

This is a Shiny App built using the Shiny R package.

The app is currently configured to use the vegbankr package and underlying vegbank2 api for data.

To run the app locally, you'll need to install R and download this repository.

By default the app uses the inst/config.yml bundled with the package (sourced via system.file). To override this, create a .Renviron file in the root directory of the repository and set the R_CONFIG_FILE environment variable to the absolute path of a valid config.yml file. You can also select a named configuration block by setting the R_CONFIG_ACTIVE environment variable (defaults to "default" if not set).

For example, to select the production configuration in a custom config file, add something like:

# vegbank-web/.Renviron
R_CONFIG_FILE="/Users/yourUserName/git/vegbank-web/inst/config.yml"
R_CONFIG_ACTIVE="production"

Finally run the following commands in your IDE terminal:

~ % R

# or use `devtools::load_all()` if you prefer
~ remotes::install_github("NCEAS/vegbank-web")

~ % vegbankweb::run_app()

Current Contributors

License

Copyright [2026] [Regents of the University of California]

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

https://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.

Acknowledgements

Work on this package was supported by:

  • California Department of Fish and Wildlife
  • The ESA Panel on Vegetation Classification

Additional support was provided for collaboration by the National Center for Ecological Analysis and Synthesis, a Center funded by the University of California, Santa Barbara, and the State of California.

nceas_footer