| Title: | Biodiversity Index Calculation and Bootstrap Confidence Interval Estimation | 
| Version: | 1.0.4 | 
| Description: | Provides tools for the calculation of common biodiversity indices from count data. Additionally, it incorporates bootstrapping techniques to generate multiple samples, facilitating the estimation of confidence intervals around these indices. Furthermore, the package allows for the exploration of how variation in these indices changes with differing numbers of sites, making it a useful tool with which to begin an ecological analysis. Methods are based on the following references: Chao et al. (2014) <doi:10.1890/13-0133.1>, Chao and Colwell (2022) <doi:10.1002/9781119902911.ch2>, Hsieh, Ma,' and Chao (2016) <doi:10.1111/2041-210X.12613>. | 
| License: | MIT + file LICENSE | 
| Encoding: | UTF-8 | 
| RoxygenNote: | 7.2.3 | 
| Imports: | ggplot2, stats | 
| Suggests: | knitr, rmarkdown, testthat (≥ 3.0.0), vegan | 
| Depends: | R (≥ 2.10) | 
| LazyData: | true | 
| Config/testthat/edition: | 3 | 
| VignetteBuilder: | knitr | 
| URL: | https://github.com/csim063/biosampleR | 
| BugReports: | https://github.com/csim063/biosampleR/issues | 
| NeedsCompilation: | no | 
| Packaged: | 2023-09-13 03:36:49 UTC; simpk | 
| Author: | Craig Eric Simpkins
     | 
| Maintainer: | Craig Eric Simpkins <simpkinscraig063@gmail.com> | 
| Repository: | CRAN | 
| Date/Publication: | 2023-09-13 18:30:02 UTC | 
Barro-Colorado Island Tree Counts
Description
This dataset contains tree counts from Barro-Colorado Island. It has 50 rows each representing the counts taken from a separate one hectare plot for each of the 225 species (columns)
Usage
BCI
Format
A data frame with 50 rows and 225 columns:
- Abarema.macradenia
 Count for Abarema.macradenia
- Vachellia.melanoceras
 Count for Vachellia.melanoceras
- Acalypha.diversifolia
 Count for Acalypha.diversifolia
- Acalypha.macrostachya
 Count for Acalypha.macrostachya
- Adelia.triloba
 Count for Adelia.triloba
- Aegiphila.panamensis
 Count for Aegiphila.panamensis
- Alchornea.costaricensis
 Count for Alchornea.costaricensis
- Alchornea.latifolia
 Count for Alchornea.latifolia
- Alibertia.edulis
 Count for Alibertia.edulis
- Allophylus.psilospermus
 Count for Allophylus.psilospermus
- Alseis.blackiana
 Count for Alseis.blackiana
- Amaioua.corymbosa
 Count for Amaioua.corymbosa
- Anacardium.excelsum
 Count for Anacardium.excelsum
- Andira.inermis
 Count for Andira.inermis
- Annona.spraguei
 Count for Annona.spraguei
- Apeiba.glabra
 Count for Apeiba.glabra
- Apeiba.tibourbou
 Count for Apeiba.tibourbou
- Aspidosperma.desmanthum
 Count for Aspidosperma.desmanthum
- Astrocaryum.standleyanum
 Count for Astrocaryum.standleyanum
- Astronium.graveolens
 Count for Astronium.graveolens
- Attalea.butyracea
 Count for Attalea.butyracea
- Banara.guianensis
 Count for Banara.guianensis
- Beilschmiedia.pendula
 Count for Beilschmiedia.pendula
- Brosimum.alicastrum
 Count for Brosimum.alicastrum
- Brosimum.guianense
 Count for Brosimum.guianense
- Calophyllum.longifolium
 Count for Calophyllum.longifolium
- Casearia.aculeata
 Count for Casearia.aculeata
- Casearia.arborea
 Count for Casearia.arborea
- Casearia.commersoniana
 Count for Casearia.commersoniana
- Casearia.guianensis
 Count for Casearia.guianensis
- Casearia.sylvestris
 Count for Casearia.sylvestris
- Cassipourea.guianensis
 Count for Cassipourea.guianensis
- Cavanillesia.platanifolia
 Count for Cavanillesia.platanifolia
- Cecropia.insignis
 Count for Cecropia.insignis
- Cecropia.obtusifolia
 Count for Cecropia.obtusifolia
- Cedrela.odorata
 Count for Cedrela.odorata
- Ceiba.pentandra
 Count for Ceiba.pentandra
- Celtis.schippii
 Count for Celtis.schippii
- Cespedesia.spathulata
 Count for Cespedesia.spathulata
- Chamguava.schippii
 Count for Chamguava.schippii
- Chimarrhis.parviflora
 Count for Chimarrhis.parviflora
- Maclura.tinctoria
 Count for Maclura.tinctoria
- Chrysochlamys.eclipes
 Count for Chrysochlamys.eclipes
- Chrysophyllum.argenteum
 Count for Chrysophyllum.argenteum
- Chrysophyllum.cainito
 Count for Chrysophyllum.cainito
- Coccoloba.coronata
 Count for Coccoloba.coronata
- Coccoloba.manzinellensis
 Count for Coccoloba.manzinellensis
- Colubrina.glandulosa
 Count for Colubrina.glandulosa
- Cordia.alliodora
 Count for Cordia.alliodora
- Cordia.bicolor
 Count for Cordia.bicolor
- Cordia.lasiocalyx
 Count for Cordia.lasiocalyx
- Coussarea.curvigemma
 Count for Coussarea.curvigemma
- Croton.billbergianus
 Count for Croton.billbergianus
- Cupania.cinerea
 Count for Cupania.cinerea
- Cupania.latifolia
 Count for Cupania.latifolia
- Cupania.rufescens
 Count for Cupania.rufescens
- Cupania.seemannii
 Count for Cupania.seemannii
- Dendropanax.arboreus
 Count for Dendropanax.arboreus
- Desmopsis.panamensis
 Count for Desmopsis.panamensis
- Diospyros.artanthifolia
 Count for Diospyros.artanthifolia
- Dipteryx.oleifera
 Count for Dipteryx.oleifera
- Drypetes.standleyi
 Count for Drypetes.standleyi
- Elaeis.oleifera
 Count for Elaeis.oleifera
- Enterolobium.schomburgkii
 Count for Enterolobium.schomburgkii
- Erythrina.costaricensis
 Count for Erythrina.costaricensis
- Erythroxylum.macrophyllum
 Count for Erythroxylum.macrophyllum
- Eugenia.florida
 Count for Eugenia.florida
- Eugenia.galalonensis
 Count for Eugenia.galalonensis
- Eugenia.nesiotica
 Count for Eugenia.nesiotica
- Eugenia.oerstediana
 Count for Eugenia.oerstediana
- Faramea.occidentalis
 Count for Faramea.occidentalis
- Ficus.colubrinae
 Count for Ficus.colubrinae
- Ficus.costaricana
 Count for Ficus.costaricana
- Ficus.insipida
 Count for Ficus.insipida
- Ficus.maxima
 Count for Ficus.maxima
- Ficus.obtusifolia
 Count for Ficus.obtusifolia
- Ficus.popenoei
 Count for Ficus.popenoei
- Ficus.tonduzii
 Count for Ficus.tonduzii
- Ficus.trigonata
 Count for Ficus.trigonata
- Ficus.yoponensis
 Count for Ficus.yoponensis
- Garcinia.intermedia
 Count for Garcinia.intermedia
- Garcinia.madruno
 Count for Garcinia.madruno
- Genipa.americana
 Count for Genipa.americana
- Guapira.myrtiflora
 Count for Guapira.myrtiflora
- Guarea.fuzzy
 Count for Guarea.fuzzy
- Guarea.grandifolia
 Count for Guarea.grandifolia
- Guarea.guidonia
 Count for Guarea.guidonia
- Guatteria.dumetorum
 Count for Guatteria.dumetorum
- Guazuma.ulmifolia
 Count for Guazuma.ulmifolia
- Guettarda.foliacea
 Count for Guettarda.foliacea
- Gustavia.superba
 Count for Gustavia.superba
- Hampea.appendiculata
 Count for Hampea.appendiculata
- Hasseltia.floribunda
 Count for Hasseltia.floribunda
- Heisteria.acuminata
 Count for Heisteria.acuminata
- Heisteria.concinna
 Count for Heisteria.concinna
- Hirtella.americana
 Count for Hirtella.americana
- Hirtella.triandra
 Count for Hirtella.triandra
- Hura.crepitans
 Count for Hura.crepitans
- Hieronyma.alchorneoides
 Count for Hieronyma.alchorneoides
- Inga.acuminata
 Count for Inga.acuminata
- Inga.cocleensis
 Count for Inga.cocleensis
- Inga.goldmanii
 Count for Inga.goldmanii
- Inga.laurina
 Count for Inga.laurina
- Inga.semialata
 Count for Inga.semialata
- Inga.nobilis
 Count for Inga.nobilis
- Inga.oerstediana
 Count for Inga.oerstediana
- Inga.pezizifera
 Count for Inga.pezizifera
- Inga.punctata
 Count for Inga.punctata
- Inga.ruiziana
 Count for Inga.ruiziana
- Inga.sapindoides
 Count for Inga.sapindoides
- Inga.spectabilis
 Count for Inga.spectabilis
- Inga.umbellifera
 Count for Inga.umbellifera
- Jacaranda.copaia
 Count for Jacaranda.copaia
- Lacistema.aggregatum
 Count for Lacistema.aggregatum
- Lacmellea.panamensis
 Count for Lacmellea.panamensis
- Laetia.procera
 Count for Laetia.procera
- Laetia.thamnia
 Count for Laetia.thamnia
- Lafoensia.punicifolia
 Count for Lafoensia.punicifolia
- Licania.hypoleuca
 Count for Licania.hypoleuca
- Licania.platypus
 Count for Licania.platypus
- Lindackeria.laurina
 Count for Lindackeria.laurina
- Lonchocarpus.heptaphyllus
 Count for Lonchocarpus.heptaphyllus
- Luehea.seemannii
 Count for Luehea.seemannii
- Macrocnemum.roseum
 Count for Macrocnemum.roseum
- Maquira.guianensis.costaricana
 Count for Maquira.guianensis.costaricana
- Margaritaria.nobilis
 Count for Margaritaria.nobilis
- Marila.laxiflora
 Count for Marila.laxiflora
- Maytenus.schippii
 Count for Maytenus.schippii
- Miconia.affinis
 Count for Miconia.affinis
- Miconia.argentea
 Count for Miconia.argentea
- Miconia.elata
 Count for Miconia.elata
- Miconia.hondurensis
 Count for Miconia.hondurensis
- Mosannona.garwoodii
 Count for Mosannona.garwoodii
- Myrcia.gatunensis
 Count for Myrcia.gatunensis
- Myrospermum.frutescens
 Count for Myrospermum.frutescens
- Nectandra.cissiflora
 Count for Nectandra.cissiflora
- Nectandra.lineata
 Count for Nectandra.lineata
- Nectandra.purpurea
 Count for Nectandra.purpurea
- Ochroma.pyramidale
 Count for Ochroma.pyramidale
- Ocotea.cernua
 Count for Ocotea.cernua
- Ocotea.oblonga
 Count for Ocotea.oblonga
- Ocotea.puberula
 Count for Ocotea.puberula
- Ocotea.whitei
 Count for Ocotea.whitei
- Oenocarpus.mapora
 Count for Oenocarpus.mapora
- Ormosia.amazonica
 Count for Ormosia.amazonica
- Ormosia.coccinea
 Count for Ormosia.coccinea
- Ormosia.macrocalyx
 Count for Ormosia.macrocalyx
- Pachira.quinata
 Count for Pachira.quinata
- Pachira.sessilis
 Count for Pachira.sessilis
- Perebea.xanthochyma
 Count for Perebea.xanthochyma
- Cinnamomum.triplinerve
 Count for Cinnamomum.triplinerve
- Picramnia.latifolia
 Count for Picramnia.latifolia
- Piper.reticulatum
 Count for Piper.reticulatum
- Platymiscium.pinnatum
 Count for Platymiscium.pinnatum
- Platypodium.elegans
 Count for Platypodium.elegans
- Posoqueria.latifolia
 Count for Posoqueria.latifolia
- Poulsenia.armata
 Count for Poulsenia.armata
- Pourouma.bicolor
 Count for Pourouma.bicolor
- Pouteria.fossicola
 Count for Pouteria.fossicola
- Pouteria.reticulata
 Count for Pouteria.reticulata
- Pouteria.stipitata
 Count for Pouteria.stipitata
- Prioria.copaifera
 Count for Prioria.copaifera
- Protium.costaricense
 Count for Protium.costaricense
- Protium.panamense
 Count for Protium.panamense
- Protium.tenuifolium
 Count for Protium.tenuifolium
- Pseudobombax.septenatum
 Count for Pseudobombax.septenatum
- Psidium.friedrichsthalianum
 Count for Psidium.friedrichsthalianum
- Psychotria.grandis
 Count for Psychotria.grandis
- Pterocarpus.rohrii
 Count for Pterocarpus.rohrii
- Quararibea.asterolepis
 Count for Quararibea.asterolepis
- Quassia.amara
 Count for Quassia.amara
- Randia.armata
 Count for Randia.armata
- Sapium.broadleaf
 Count for Sapium.broadleaf
- Sapium.glandulosum
 Count for Sapium.glandulosum
- Schizolobium.parahyba
 Count for Schizolobium.parahyba
- Senna.dariensis
 Count for Senna.dariensis
- Simarouba.amara
 Count for Simarouba.amara
- Siparuna.guianensis
 Count for Siparuna.guianensis
- Siparuna.pauciflora
 Count for Siparuna.pauciflora
- Sloanea.terniflora
 Count for Sloanea.terniflora
- Socratea.exorrhiza
 Count for Socratea.exorrhiza
- Solanum.hayesii
 Count for Solanum.hayesii
- Sorocea.affinis
 Count for Sorocea.affinis
- Spachea.membranacea
 Count for Spachea.membranacea
- Spondias.mombin
 Count for Spondias.mombin
- Spondias.radlkoferi
 Count for Spondias.radlkoferi
- Sterculia.apetala
 Count for Sterculia.apetala
- Swartzia.simplex.var.grandiflora
 Count for Swartzia.simplex.var.grandiflora
- Swartzia.simplex.continentalis
 Count for Swartzia.simplex.continentalis
- Symphonia.globulifera
 Count for Symphonia.globulifera
- Handroanthus.guayacan
 Count for Handroanthus.guayacan
- Tabebuia.rosea
 Count for Tabebuia.rosea
- Tabernaemontana.arborea
 Count for Tabernaemontana.arborea
- Tachigali.versicolor
 Count for Tachigali.versicolor
- Talisia.nervosa
 Count for Talisia.nervosa
- Talisia.princeps
 Count for Talisia.princeps
- Terminalia.amazonia
 Count for Terminalia.amazonia
- Terminalia.oblonga
 Count for Terminalia.oblonga
- Tetragastris.panamensis
 Count for Tetragastris.panamensis
- Tetrathylacium.johansenii
 Count for Tetrathylacium.johansenii
- Theobroma.cacao
 Count for Theobroma.cacao
- Thevetia.ahouai
 Count for Thevetia.ahouai
- Tocoyena.pittieri
 Count for Tocoyena.pittieri
- Trattinnickia.aspera
 Count for Trattinnickia.aspera
- Trema.micrantha
 Count for Trema.micrantha
- Trichanthera.gigantea
 Count for Trichanthera.gigantea
- Trichilia.pallida
 Count for Trichilia.pallida
- Trichilia.tuberculata
 Count for Trichilia.tuberculata
- Trichospermum.galeottii
 Count for Trichospermum.galeottii
- Triplaris.cumingiana
 Count for Triplaris.cumingiana
- Trophis.caucana
 Count for Trophis.caucana
- Trophis.racemosa
 Count for Trophis.racemosa
- Turpinia.occidentalis
 Count for Turpinia.occidentalis
- Unonopsis.pittieri
 Count for Unonopsis.pittieri
- Virola.multiflora
 Count for Virola.multiflora
- Virola.sebifera
 Count for Virola.sebifera
- Virola.surinamensis
 Count for Virola.surinamensis
- Vismia.baccifera
 Count for Vismia.baccifera
- Vochysia.ferruginea
 Count for Vochysia.ferruginea
- Xylopia.macrantha
 Count for Xylopia.macrantha
- Zanthoxylum.ekmanii
 Count for Zanthoxylum.ekmanii
- Zanthoxylum.juniperinum
 Count for Zanthoxylum.juniperinum
- Zanthoxylum.panamense
 Count for Zanthoxylum.panamense
- Zanthoxylum.setulosum
 Count for Zanthoxylum.setulosum
- Zuelania.guidonia
 Count for Zuelania.guidonia
Source
https://www.science.org/doi/10.1126/science.1066854
Calculate the change in variance with increasing number of sites
Description
Calculate the change in variance with increasing number of sites
Usage
calc_delta_var(
  data,
  col_name,
  site_name = "num_sites",
  rep_name = "rep",
  visualize = FALSE
)
Arguments
data | 
 A data frame containing the biodiversity indices to analyze, for a different number of sites over multiple repetitions.  | 
col_name | 
 The name of the column containing the biodiversity index to analyze.  | 
site_name | 
 The name of the column containing the number of sites.  | 
rep_name | 
 The name of the column containing the repetition number.  | 
visualize | 
 A logical indicating whether to visualize the results.  | 
Value
A data frame with the number of sites and the variance and standard deviation of the mean of the biodiversity index for each number of sites.
Examples
ss <- generate_subsamples(BCI,
                         min_sites = 1,
                        max_sites = 5,
                       step = 1,
                     reps = 5)
data <- ss
data  <- unlist(data, recursive = FALSE)
data <- do.call(rbind, data)
calc_delta_var(data,
             col_name = "richness",
           site_name = "num_sites",
        rep_name = "rep",
     visualize = TRUE)
Calculate biodiversity summary indices from count data
Description
Calculate biodiversity summary indices from count data
Usage
calc_diversity_indices(data)
Arguments
data | 
 A data frame of count data, with sites as rows and species as columns.  | 
Value
A data frame with sites as rows and diversity indices as columns. The columns are: abundance, species richness, Shannon diveristy index, Simpson diversity index, Chao1, Difference between Choa1 and species richness.
Examples
ind <- calc_diversity_indices(BCI)
Create multiple resamples of a data set.
Description
Create multiple resamples of a data set.
Usage
create_resample(data, reps = 100, summary = TRUE, seed = sample(0:9999, 1))
Arguments
data | 
 A data frame of count data, with sites as rows and species as columns.  | 
reps | 
 The number of resamples to create.  | 
summary | 
 A logical indicating whether to calculate summary indices
using   | 
seed | 
 A random seed to use for reproducibility.  | 
Value
A list of data frames, if summary = FALSE, each data frame
is a resample of the original data set. If summary = TRUE,
each data frame is a resample of the original data set with
diversity indices calculated using
calc_diversity_indices.
Examples
rs <- create_resample(BCI, reps = 10, summary = TRUE)
Generate subsamples of a data frame with a number of sites between a minimum and maximum value.
Description
Generate subsamples of a data frame with a number of sites between a minimum and maximum value.
Usage
generate_subsamples(
  data,
  min_sites = 1,
  max_sites = nrow(data),
  step = 1,
  reps = 100,
  summary = TRUE,
  seed = sample(0:9999, 1)
)
Arguments
data | 
 A data frame of count data, with sites as rows and species as columns.  | 
min_sites | 
 The minimum number of sites to include in a subsample.  | 
max_sites | 
 The maximum number of sites to include in a subsample. Defaults to the number of sites in the original data set.  | 
step | 
 The number of sites to increase by at each iteration.  | 
reps | 
 The number of subsamples with a given number of sites to create.  | 
summary | 
 A logical indicating whether to calculate summary indices
using   | 
seed | 
 A random seed to use for reproducibility.  | 
Value
A list of lists of data frames, if summary = FALSE, each data
frame is a subsample of the original data set. If summary =
      TRUE, each data frame is a subsample of the original data set with
diversity indices calculated using
calc_diversity_indices.
Examples
ss <- generate_subsamples(BCI,
                          min_sites = 1,
                          max_sites = 5,
                          step = 1,
                          reps = 2)
Calculate biodiversity measures and summary statistics for a data set using repeated sampling
Description
Calculate biodiversity measures and summary statistics for a data set using repeated sampling
Usage
get_sample_stats(data, sites_col = 1, reps = 100, indices = "all")
Arguments
data | 
 A data frame of count data, with sites as rows and species as columns.  | 
sites_col | 
 The column number of column containing site IDs.  | 
reps | 
 The number of resamples to create.  | 
indices | 
 A vector of indices to calculate. Use "all" to calculate all indices. Available indices are: abundance, richness, shannon, simpson, chao1, and chao_diff.  | 
Value
A list of two data frames. The first data frame contains site specific data with sites as rows and summary statistics as columns. The second contains an overall summary of the data.
Examples
stats <- get_sample_stats(BCI, reps = 5)