From f2dffcdb13e087446d3e8abd893e26b5bec56291 Mon Sep 17 00:00:00 2001
From: Jari Oksanen <jhoksane@gmail.com>
Date: Thu, 9 Nov 2023 13:58:57 +0200
Subject: [PATCH] BCI: extend description, differences to survey & modern data

BCI data really has >10cm DBH subset of BCI plots, unlike the full
survey (>1cm DBH). Added pointer to sources of updated, upgraded,
extended modern data. Thanks to Pierre Legendre and Richard Condit.
---
 man/BCI.Rd | 47 +++++++++++++++++++++++++++++++++++------------
 1 file changed, 35 insertions(+), 12 deletions(-)

diff --git a/man/BCI.Rd b/man/BCI.Rd
index 01db4918e..690539e87 100644
--- a/man/BCI.Rd
+++ b/man/BCI.Rd
@@ -51,13 +51,22 @@ data(BCI.env)
 
  }
 \details{
-  Data give the numbers of trees at least 10 cm in
-  diameter at breast height (1.3 m above the ground) in each one hectare
-  square of forest. Within each one hectare square, all individuals of
-  all species were tallied and are recorded in this table.
+
+  Data give the numbers of trees at least 10 cm in diameter at breast
+  height (DBH) in each one hectare plot in the 1982 survey. Within
+  each plot, all individuals were tallied and are recorded in this
+  table. The full survey included smaller trees with DBH 1 cm or
+  larger, but the \code{BCI} dataset is a subset of larger trees as
+  compiled by Condit et al. (2002). The full data with thinner trees
+  has densities above 4000 stems per hectare, or about ten times more
+  stems than these data. The dataset \code{BCI} was provided (in 2003)
+  to illustrate analysis methods in \pkg{vegan}. For scientific
+  research on ecological issues we strongly recommend to access
+  complete and more modern data (Condit et al. 2019) with updated
+  taxonomy (Condit et al. 2020).
 
   The data frame contains only the Barro Colorado Island subset of the
-  original data.
+  full data table of Condit et al. (2002).
 
   The quadrats are located in a regular grid. See \code{BCI.env} for the
   coordinates.
@@ -69,8 +78,12 @@ data(BCI.env)
 
 }
 \source{
-  \url{https://www.science.org/doi/10.1126/science.1066854}
-  for community data and References for environmental data.
+
+  \url{https://www.science.org/doi/10.1126/science.1066854} for
+  community data and References for environmental data. For updated
+  complete data (incl. thinner trees down to 1 cm), see Condit et
+  al. (2019).
+
 }
 
 \seealso{
@@ -91,6 +104,15 @@ data(BCI.env)
   Beta-diversity in tropical forest trees. \emph{Science} 295,
   666--669.
 
+  Condit R., Pérez, R., Aguilar, S., Lao, S., Foster, R. & Hubbell,
+  S. (2019). Complete data from the Barro Colorado 50-ha plot: 423617
+  trees, 35 years [Dataset].  \emph{Dryad}.
+  \doi{https://doi.org/10.15146/5xcp-0d46}
+
+  Condit, R., Aguilar, S., Lao, S., Foster, R., Hubbell,
+  S. (2020). BCI 50-ha Plot Taxonomy [Dataset].  \emph{Dryad}.
+  \doi{https://doi.org/10.15146/R3FH61}
+
   Harms K.E., Condit R., Hubbell S.P. & Foster R.B. (2001) Habitat
   associations of trees and shrubs in a 50-ha neotropical forest
   plot. \emph{J. Ecol.} 89, 947--959.
@@ -100,6 +122,11 @@ data(BCI.env)
   phylogeny of a tropical forest dynamics plot in Panama. \emph{PNAS}
   106, 18621--18626.
 
+  Pyke, C. R., Condit, R., Aguilar, S., & Lao, S. (2001). Floristic
+  composition across a climatic gradient in a neotropical lowland
+  forest. \emph{Journal of Vegetation Science} 12, 553--566.
+  \doi{10.2307/3237007}
+
   Zanne A.E., Tank D.C., Cornwell, W.K., Eastman J.M., Smith, S.A.,
   FitzJohn, R.G., McGlinn, D.J., O’Meara, B.C., Moles, A.T., Reich,
   P.B., Royer, D.L., Soltis, D.E., Stevens, P.F., Westoby, M., Wright,
@@ -109,12 +136,8 @@ data(BCI.env)
   of angiosperms into freezing environments. \emph{Nature} 506,
   89--92.  \doi{10.1038/nature12872} (published online Dec 22, 2013).
 
-  Pyke, C. R., Condit, R., Aguilar, S., & Lao, S. (2001). Floristic
-  composition across a climatic gradient in a neotropical lowland
-  forest. \emph{Journal of Vegetation Science} 12, 553--566.
-  \doi{10.2307/3237007} 
-
 }
+
 \examples{
 data(BCI, BCI.env)
 head(BCI.env)