3 Data Entry Protocol
The COMPADRE Plant Matrix Database (COMPADRE hereafter) and the COMADRE Animal Matrix Database (COMADRE hereafter) are compiled from (mostly) published literature. The majority of this literature was published as peer-reviewed articles in academic journals, with a smaller number of data obtained from books, conference presentations, etc.
The data digitisation team carefully examine the literature and extract information in order to reconstruct the matrix population models analysed by the original researchers. The extracted data are entered into our web-based digitisation forms, which are then stored as structured SQL tables. Wherever there are doubts about aspects of the data source, the team attempts to contact the researchers to resolve them. There are three types of digitization forms in COMPADRE/COMADRE: (1) The PUBLICATION form which contains metadata on the publication, such as bibliographic and study level information; (2) The POPULATION form with metadata that allows for the interpretation of the matrix data, and it pertains to information at the species/population level; and (3) the MATRIX form which contains the matrix population models themselves, as well as information that is matrix-specific.
These data are compiled using a set of R scripts and released to the public as open access data via the website: www.compadre-db.org.
This document outlines the way that the digitisation team enters data into our website. It is primarily intended for internal use and, as such, it includes information on some variables which are not released into the public domain. Nevertheless, following our philosophy on open access, replicability and transparency, we provide open access to the document here. Users external to our team with questions can direct them at email@example.com. Specific questions can also be directed to Rob Salguero-Gómez (firstname.lastname@example.org) or Owen Jones (email@example.com).
3.2 General information
- If you find additional sources, always attach them and note them in “Additional Source” in the publication form. An additional source is a paper that references matrices from another source already in the database.
- Download the PDF attached to the publication form assigned to you, all pieces of information extracted from PDFs must be highlighted directly on the PDF in yellow. After completing your work, upload the PDF with highlights to the publication form after adding
_highlightsto the end of the document name.
- If a PDF contains matrices/data from other papers and/or studies, this must be noted as “Not primary source” in the “Additional Notes” field of the publication form. Double check that these matrices have not already been digitized into the database so as to avoid creating duplicate matrix entries.
- If additional publications are found with respect to a given species, these must be inspected for any additional matrix population models with different model assumptions (e.g. different stages) and/or different study years, populations and/or treatments. If the paper provides new information, it must be included in the database as a new publication.
- Authors must only be contacted from the official email: firstname.lastname@example.org. If you encounter technical difficulties when attempting to contact an author, contact your lead for additional instructions.
- Where matrices can be split, always include an “A” matrix as well as “U”, “F” & “C” matrices (for explanation, see here in the protocol for matrix form). Always split matrices when possible.
- There are also species that do not fall into the Kingdoms Plantae or Animalia. Fungi and algae should be included in COMPADRE with the plants. Any other species (e.g. bacteria and viruses) should be included in COMADRE.
3.3 Values used throughout the database
The following values are commonly used throughout the database.
NA- Not available - The information is not available either because the author does not have it or because the information is not recognized as “priority” (see below) for the digitisation.
AFI- Asked for it - The information is not yet in the database, but the digitiser has already contacted the author requesting it (i.e. the author has not yet replied).
NDY- Not digitised yet - The information has not yet been digitised. This is likely to occur when some priority information has been digitised for a given species, and the digitiser has moved onto another species without contacting an author for the missing information.
NC- Not calculated - Information was not calculated because its calculation is not sensible. For instance, latitudes and longitudes of various populations of the same species are not averaged and assigned to the grand-mean population matrix of the species. This is the same for ranges, where author provides a range of latitudes and longitudes for a given population. Ranges are instead noted in the observation column.
LAB- Laboratory - The author collected demographic data for the studied species in a laboratory or under greenhouse conditions. Controlled, typically indoor, conditions that mean the study population is not affected by the environmental conditions typical of the actual geographic location of the study.
FRANK- Frankenstein matrix - Frankenstein matrices are MPMs where the author parameterised their model using demographic data from 2+ other papers/sources; in other words, when the matrix values come from a source that was not affected by the same conditions as the rest of the matrix. These MPMs should be clearly indicated with “
FRANK” in the observation column. Furthermore, geographic location data, time information (start/end year, season etc.) should be recorded only if the author reports ONE main location for the matrix; if multiple locations are reported, then it should be recorded as
Simulation- A simulated matrix - The matrix model is a simulation, and perhaps only loosely based on a specific real species. Typically, these simulated matrices are used to explore the behaviour of a population in a theoretical way. In those cases, there is no geographic location, ecoregion etc. For these data we do not calculate averages or ranges for locations and time periods but instead enter
3.4 Important References
- Caswell, H. (2001) Matrix population models. Second Edition. Sunderland, MA: Sinauer Associates.
- Olson, D.M., Dinerstein, E., Wikramanayake, E.D., Burgess, N.D., Powell, G.V., Underwood, E.C., D’amico, J.A., Itoua, I., Strand, H.E. & Morrison, J.C. (2001) Terrestrial Ecoregions of the World: A New Map of Life on Earth A new global map of terrestrial ecoregions provides an innovative tool for conserving biodiversity. BioScience, 51, 933–938.
- Salguero-Gómez, R., Jones, O. R., Archer, C. R., Buckley, Y. M., Che-Castaldo, J., Caswell, H., Hodgson, D., Scheuerlein, A., Conde, D. A., Brinks, E., de Buhr, H., Farack, C., Gottschalk, F., Hartmann, A., Henning, A., Hoppe, G., Römer, G., Runge, J., Ruoff, T., Wille, J., Zeh, S., Davison, R., Vieregg, D., Baudisch, A., Altwegg, R., Colchero, F., Dong, M., de Kroon, H., Lebreton, J.-D., Metcalf, C. J. E., Neel, M. M., Parker, I. M., Takada, T., Valverde, T., Vélez-Espino, L. A., Wardle, G. M., Franco, M., Vaupel, J. W. (2015), The COMPADRE Plant Matrix Database: an open online repository for plant demography. Journal of Ecology, 103: 202–218. https://doi.org/10.1111/1365-2745.12334
- Kendall, B.E., Fujiwara, M., Diaz-Lopez, J., Schneider, S., Voigt, J., Wiesner, S. 2019. Persistent problems in the construction of matrix population models. Ecological Modelling 406, 33–43 https://doi.org/10.1016/j.ecolmodel.2019.03.011
3.5 Protocol for the publication form
This is the status for the publication. Please READ the website-status protocol to determine the status that should be assigned to the publication.
Assigned– the publication has been assigned to a node. The digitiser will get publications in this status. Once the digitiser has started working on the publication, it should be changed to “Digitizing”
Digitizing– digitiser is working/editing the population
Awaiting info– digitiser has determined more information is required to complete digitization
Review-Ready– the population is ready to be reviewed by a database curator
Released– population can be now seen by public users
Error– an error has been found in the population and needs to be corrected
3.5.2 Node Assignment
The node the publication has been assigned for. Only coordinators and admins edit this field.
3.5.3 Assigned to
The name of the digitiser that has claimed or has been assigned the publication.
The database to which the publication belongs to, either COMPADRE (plants, fungi, and algae) or COMADRE (animals, bacteria, and viruses). Usually determined by the database coordinator. When you are assigned a publication, always make sure the assigned database is correct.
Compadre(plants, fungi, and algae)
Comadre(animals, bacteria, and viruses)
3.5.5 Attach a Document
Attach all files used to digitise this publication. Include original journal article, additional sources, appendices, files from author communications, PDF copies of emails from the author if data are in the text of the email, Excel files with data, etc. Usually all proposed/assigned publications will have the original journal article attached.
Important: If you must calculate matrix entries from formulas/models and tables in the publication, do that work in an Excel file (or third party software such as Google Docs and save as an Excel file), and upload your work to the publication form.
The DOI of the journal article. If you have the DOI, you could automatically fill the bibliographic information fields. Check to make sure those fields were populated correctly.
3.5.8 Reference Type
Record the type of reference from which data were sourced.
- Book: Matrices are from a book
- Book Chapter: Matrices are from a single chapter in a book
- Journal Article: Matrices come from a Journal paper.
- Journal Name: Record the standard abbreviation of the journal using the BIOSIS format. For journal abbreviations, click “Full list of journal abbreviation” (https://images.webofknowledge.com/images/help/WOS/A_abrvjt.html). If no abbreviation is available in the list, search past records of the journal from the website or look for it in the left corner of the paper.
- Year: The year the paper was published.
- Thesis: Matrices are from a thesis such as PhD thesis, MSc thesis, etc.
- Thesis type: Select the correct option.
- Report: Matrices are from a report.
- Conference: Matrices are from a conference in forms such as a talk or a poster.
- Other: Matrices are from other sources including, but not limited to archives.
Select all that apply. Describes the purpose(s) of the study detailed in the manuscript. This information is usually obvious from the abstract and the last paragraph of the introduction. Several purposes are possible per study.
We have categorised the purposes as follows:
- Comparative demography - When the authors studied two or more species
- Spatial demography - When the authors studied the demography of two or more populations within the same species
- Abiotic impacts - When the authors studied the effects of abiotic factors (e.g fire, hurricanes, rain, fertilisers, droughts, etc)
- PVA - When the authors report a Population Viability Analysis of an endangered species
- Species dynamics description - When there is no actual treatment in the study (Unmanipulated). Instead, the goal was to describe the natural dynamics of a species
- Interspecific interactions - When the authors studied the interactions between different species (e.g herbivory, pollinators, inter-specific competition, predation, parasitism, etc)
- Management evaluation - When the authors explored the effects of a specific management plan (e.g. to eradicate an invasive species, to preserve an endangered species or assess effects of management on other species).
- Methodological advancement - When the novelty of the paper is not an ecological question, but mostly to introduce a new mathematical tool often using already published matrices.
If the author does not wish to make personally communicated data available, the data will be under embargo until this date. A week before that date, an automatic reminder will go out to the author instructing them to contact us if they wish to extend the embargo or remove the data from the database; otherwise, the data will be released and included in the next version update of the databases. Leave blank when there is no embargo.
3.5.11 Additional Source
Record all additional sources used to construct matrices or to obtain additional ancillary data. Additional sources should be formatted as “LastName Journal YearPublished DocumentTitle” (e.g. Godinez-Alvarez Bot Rev 2003, Schmidt J Ecol 2007 Appendix A1) both here and in the attached file names. Be sure to update both whenever changes are made to the data associated with the publication. Attach the necessary PDF/Excel files/documents to the “Attach a Document” field.
3.5.12 Additional Notes
This field is intended to record any important issues or general notes about the data for the use of the digitization team. These entries should only include sensible informative key points that others can understand. Use English only.
3.5.13 Missing Data
Data that is not yet available and thus not yet digitized for this publication. Update this information whenever changes are made to populations and matrices associated with this publication.
Record all treatment categories used in the study. Include both environmental and experimental treatments. Write “No” if nothing was manipulated.
3.5.15 Within Site Replication
Number of plots or transects sampled at each population and the size description of the plots. For example, 6(4x4m^2) means that in each population, there were 6 permanent plots of 4x4m2. If different populations have different plot sizes, record all of them separated by semicolon. (e.g. A: 2(15ha); B: 3(20ha))
3.5.16 Study Start (Year)/Study End (Year)
The start and end years of the surveys/censuses/experiments in the study. Record
Simulation if data are from a simulation and not associated with any real-world surveys/censuses/experiments. An alert will appear if the start year is greater than the end year, or if the year recorded is greater than the current year.
3.5.17 Release Version
The Version number of the database where the data were released (no longer applies). Do not enter anything here.
3.5.18 Database source
The institute that collated the data together in a mini database before COMPADRE and COMADRE were developed. Do not enter anything here.
3.5.21 Date Contacted
Record the date(s) when the publication author was contacted asking for information in US date format (mm/dd/yyyy). Authors should always be contacted from the email@example.com email address rather than a personal email address. If you encounter technical difficulties when attempting to contact an author, contact your lead for additional instructions.
Procedure for lack of response depends on the Year of Publication of the source:
- For papers older than 1990: When the corresponding author does not reply to your third email, or you cannot find their email address (e.g. in old publication) or reach their coauthors, then change the publication status from “Digitizing” to “Review-ready.”
- For more recent papers (published after 1990): If the authors (and coauthors) do not reply after the third time you have contacted them, please pass the email address that you have sent them, together with a brief summary of the information you are after and the attached PDF to Owen and Rob. If they do not make successful contact with the authors, they will change the publication status from “Digitizing” to “Review-ready.”
If you were not able to find an email address of any of the authors of a paper (and also Rob and Owen don’t know one), but that paper has a matrix population model that can be digitised – enter the matrix and all information that are available from the paper. All missing information get an NA and we list the species as “Review-Ready”, still enter the missing information into Missing Data field.
3.5.22 Date Contacted Again
Date(s) of the other attempts to contact this corresponding author. (mm/dd/yyyy; mm/dd/yyyy). Make another attempt to contact the author again if there has not been a response in 3 months.
3.5.23 Sent Email Content
This records the information that was requested from the author. Use the same format as for “Missing Data” above. If multiple pieces of information are requested, separate with “;”. If the author has been asked for something other than the standard missing information, a short note should be left, e.g. “is the species clonal?”
3.6 Protocol for the Population form
This is the status for the population. Please READ the website-status protocol to determine the status that should be assigned to the population.
Digitizing – digitiser is working/editing the population
Awaiting info – digitiser has determined more information is required to complete digitization
Review-Ready – the population is ready to be reviewed by a database curator
Released – population can be now seen by public users
Error – an error has been found in the population and needs to be corrected
3.6.2 Species Accepted
Currently accepted Latin binomial or trinomial name for the species.
- Search for the correct species name. This might be different from the Latin name the author used (e.g. author used an old Latin name for the species). If you cannot find the correct species name in this field, contact a website administrator.
3.6.4 Population Name
The name of the population where the data for the matrix was recorded. Usually given by the author. When no name provided, use other characteristic information, such as a brief geographic location (e.g. Monterey Bay, Gifford Pinchot Southeast, etc.). If there are multiple populations in the study and their names are not pertinent/available, sequential names in alphabetical order are assigned for each population in the study (e.g. Population A, Population B, etc.).
3.6.5 Species Common Name
The common name for the species. This is pulled automatically from the selected species but can be overwritten if desired/needed.
Description of the Ecoregion associated with the population. Follow the link to obtain the ecoregion for the set of coordinates the population is located in: https://patrickbarks.shinyapps.io/biomes/
The options are:
TMBtropical and subtropical moist broadleaf forests
TDBtropical and subtropical dry broadleaf forests
TSCtropical and subtropical coniferous forests
TBMtemperate broadleaf and mixed forests
TCFtemperate coniferous forests
BORboreal forests/ taiga
TGVtropical and subtropical grasslands, savannas and shrublands
TGStemperate grasslands, savannas, and shrublands
FGSflooded grasslands and savannas
MONmontane grasslands and shrublands
MEDMediterranean forests, woodlands and scrubs
DESdeserts and xeric shrublands
LRElarge river ecosystems
LRHlarge river headwater ecosystems
LRDlarge river delta ecosystems
SREsmall river ecosystems
SLEsmall lake ecosystems
LLElarge lake ecosystems
XBExeric basin ecosystems
TSStemperate shelf and seas ecosystems
For a more inclusive description of water ecoregions, see http://worldwildlife.org/biomes
Choose the ISO 3 Country Code(s) of where the population is located. You can search by the country’s name or the country’s code. Enter
NA for populations only studied in international waters (see
Population Nautical Miles below).
3.6.8 Population Nautical Miles
For oceanic studies, this is the distance in nautical miles from the closest land mass. If the population was studied both in French and Spanish waters 8 miles from land the country code field would be FRA; SPA and the nautical miles field would be NODC-8. If it was only studied in international waters (normally defined as 12 nautical miles from land) then you would record it as NODC-22 in this field and
Continent where the population is located. Select the appropriate one:
N America(includes Canada, USA and Mexico)
S America(incluces the rest of the countries in the Americas not outlined in “
Oceania(various definitions for Oceania exist, but here we opted for this one: https://en.wikipedia.org/wiki/List_of_Oceanian_countries_by_population)
3.6.10 Matrix Criteria Size
Records whether the matrix model is based on size (e.g. stem length/number, body length/mass, etc).
Yes- The matrix population model contains at least one stage based on size.
No- The matrix population model is not based on size.
3.6.11 Matrix Criteria Ontogeny
Records whether the matrix model is based on ontogenetic stage (e.g. seedbank, reproductive, vegetative, dormant, etc).
Yes- The matrix population model contains at least one class that is based on development/ontogeny (e.g. seedbank, reproductive, vegetative, dormant, etc).
No- Matrix population model is not based on ontogeny.
3.6.12 Matrix Criteria Age
Records whether the matrix model is based on age.
Yes- The matrix population model contains at least one class that is based on age (e.g. individuals of 0 year old)
No- The matrix population model is not based on age
3.6.13 Coordinates and Altitude
Get coordinates from https://www.gps-coordinates.net/
Estimate the geographic coordinates to the nearest location possible. Check if they reasonably fit the location of the study by looking them up on Google Maps or Google Earth. If the terrestrial plant or animal has aquatic coordinates, obtain the coordinates by estimating them from the study site provided by the authors.
When geographic coordinates are not attainable, select an option that corresponds with the study situation. The possible options are
NC(Not Calculated): When the matrices are built from mean or pooled data of multiple populations with different study locations. Record each geographic coordinate in the
Observationsfield of the matrix form.
LAB(Laboratory): When the study was carried out in a laboratory or under greenhouse conditions where study populations were not affected by the environmental conditions of the actual geographic location.
FRANK(Frankenstein matrix): When the matrices are constructed from two or more sources that were in different conditions. Enter the main geographic coordinates when available. For FRANK studies, specify that it is a FRANK study in the
Observationsfield of the matrix form with a brief summary of the methods. (e.g. FRANK; Survival rates estimated from the field study, but fecundity values obtained from a greenhouse study).
Simulation: Theoretic studies that are not or are loosely based on a real population.
AFI(Asked for it): contacted the author for the information but the author hasn’t replied yet.
3.6.14 Coordinates Format
Select the adequate format for the coordinates of the population. Options include:
Degrees, minutes and seconds (DMS)
3.6.15 Latitude Degrees / Latitude Minutes / Latitude Seconds
Record the degree (0-90), minute (0-60) and second (0-60) values of the locations of the matrix.
Note: if there are no seconds (or minutes) given, you should record as NA rather than 0.
3.6.16 Latitude N or S
N - North
S - South
Note: Cardinal direction might be given with a “+” or “-” whereat “+” means North and “-” means South.
3.6.17 Longitude Degrees / Longitude Minutes / Longitude Seconds
Records the degree (0-90), minute (0-60) and second (0-60) values of the locations of the matrix.
3.6.18 Longitude W or E
W - West
E - East
Note: Cardinal direction might be given with a “+” or “-” wherby “+” means East and “-” means West.
The following link is useful for converting between different ways of presenting lat/long information: http://www.earthpoint.us/Convert.aspx
Altitude of studied population in meters (m). Height above or below sea level of specific population (e.g.
1677 (without “m”)).
Note: Altitude is either given in the paper, by author communication, or we look it up with Google Maps. If you enter the coordinates into Google Maps you’ll see the altitude at the bottom right corner of the window. Note: If you scroll around in Google Maps with your mouse the altitude will change, so pay attention that you read the altitude directly after entering the coordinates without scrolling around!
3.6.20 General notes on location information:
If you don’t have a detailed description of the geolocation-coordinates, enter the following sentence into the
Observations field of the matrix form: The GPS coordinates were approximated to the closest geographic location described in the reference.
Sometimes the latitude and longitude given in the paper DO NOT match the study area. In this case enter the following in the
Observations field of the matrix form: GPS coordinates cited exactly as reported in original paper. These do not match written study site description.
Pay attention to the means: We do not calculate ranges for mean matrices. In that case, choose the option
NC for “not calculated” in the “
Coordinates Format” field.
3.7 Protocol for the Matrix Metadata (New Matrix Set) form
Indicates the type of matrix population model.
Individual- single population studied over a single time period, for example, over one year
Mean- a mean matrix was calculated by averaging across more than one population studied over a single time period, for example, over one year
Pooled- a matrix was calculated by pooling data across more than one population studied over a single time period, for example, over one year
NDY- not digitised yet / unset
A matrix population that does not describe a full annual transition, but rather a seasonal transition.
- Specify the seasons in the “Start Season” and “End Season” fields of the matrix form.
A matrix can be seasonal even if it is constructed over several years (e.g. spring in years 2000-2012). Make sure you detail that there are multiple years data in the
Observations field of the matrix form.
This figure is a schematic showing how mean population matrix models are derived from all available population matrix models in a study. A. For annual population matrix models (those that follow population dynamics from one year to the next, or sometimes more – some tree species are studied with a 5-year interval), element-by-element means are first calculated across the population matrix models describing the population dynamics for time periods within each population. Then the grand element-by-element mean is calculated across the matrix population models for the different populations. This procedure is repeated for models describing dynamics under each imposed treatment (pink matrices below) and for those describing the dynamics of unmanipulated populations (gray). Note that mean population matrix models are only calculated from population matrix models that share the same treatment (or absence of treatment). B. For seasonal or periodic population matrix models (e.g. for annual species), the mean seasonal population matrix model is calculated within populations and then across populations, both for matrices describing treated populations and for those describing populations with no imposed treatment (i.e. unmanipulated).
Select the dimension of the matrix.
- Expand the drop-down menu and type in the number to navigate faster.
3.7.5 Class Organized
We standardise all stages in a given population matrix model to one of three stages (prop, active, dorm) to facilitate analyses.
- prop - Propagule (seed). This applies to every stage defined by the author as seed bank or seed. Users are encouraged to carefully examine matrices with these stages and to implement the appropriate calculations to avoid a spurious additional year being added when no seedbank exists in the study species, as explained by Caswell (2001, p. 60).
- active - This includes stages that can neither be placed in the “prop” nor “dorm” (see below) stages.
- dorm - A stage that is vegetatively dormant after having germinated and becoming established.
3.7.6 Start Year
First year of the matrix. Year t in matrix population model that describes population dynamics from time t to t+1 (e.g.
3.7.7 End Year
Last year of the matrix. Year t+1 in matrix population model that describes population dynamics from time t to t+1 (e.g.
3.7.8 Start Month/End Month
Record the start and end months if provided.
- For monthly transition matrices, record the start month and end month (m to m+1).
- If demographic information was collected during a period of time, please state the period separated by a hyphen (e.g.
6-8for June through August) in the
Observationsfield in the matrix form.
3.7.9 Start Season/End Season
Record the start season and end season for the seasonal matrices.
3.7.10 Census Type
Choose the type of sampling census the authors use (see Kendall et al. 2019 for additional details). The authors may have specified if they sampled before or after reproductive events. If this is not provided in the publication, please contact the corresponding author.
Prebreeding- Population was censused before a birth pulse
Postbreeding- Population was censused after a birth pulse
Intermediate- Population was censused between successive birth pulses (e.g. bears give birth while hidden in winter dens, which makes pre- or post-breeding censuses impractical
Birth-flow- Population for which reproduction occurs continually over an interval (e.g. humans)
3.7.11 Projection Interval
The time step (periodicity) of the transition matrix. Be aware this is NOT equal to sampling frequency. If a matrix has 6-month projection interval, it would be
0.5 since it is 0.5 years. In the same way, if a matrix has 5-year projection interval, it would be
Divisible if enough information is given to divide the survival and reproductive portions of the matrix. The matrix is divisible when there is no reproductive portion in the A matrix. Usually, indivisible matrices contain mixed cells in A matrix that cannot be divided into U, F, and C matrices due to insufficient information.
- An A matrix should ALWAYS be recorded, even if no reproduction data was available.
Divided- The matrix population model A has successfully been divided into the process-based sub matrices U, F and C.
Indivisible- The matrix population model A has not been divided into the process-based sub-matrices U, F and C (see Figure below for further details) because insufficient information is available to classify the various demographic processes for each sub-matrix. In indivisible matrices, only A (see below) is presented
This is how a divided matrix could look like (species: Troglodytes troglodytes):
This is how an indivisible matrix could look like (species: Syngonanthus nitens):
The diagram below shows the life cycle of two hypothetical plant populations based on age (A) and size (B), with their corresponding matrix population models. A, and underlying basic demographic processes of survival (U sub-matrix; solid arrows), sexual reproduction (F sub-matrix; dashed arrows) and clonal reproduction (C sub-matrix; dotted arrows). This model includes “retrogression” or shrinkage in addition to “progression” or growth. In the Leslie matrix model example (A), the division of sub-matrices is more straightforward than in the Lefkovitch matrix model example (B). In the latter imaginary example, individuals can transition into the same stage as they can contribute with sexual and/or clonal offspring (e.g. small stage). In these cases, splitting A into sub-matrices U, F and C is only feasible when sufficient information is provided by the authors (see variable Split).
This records whether fecundity was measured at all for this matrix model. This will help distinguish whether a 0 in the fecundity transition(s) indicates no fecundity or fecundity was not measured. We include fecundity, recruitment, or sexual reproduction here ignoring the technical differences.
The rationale for this is that a fecundity (in the F matrix) may be recorded as 0 either because it was not measured, or because reproduction was estimated to be zero. As a general rule, if any values for fecundity (e.g. in the F matrix) are non-zero, then Fec should be recorded as ‘Yes’. If all values are zero, then you should check the paper carefully to check whether this is because no fecundity was detected, or whether no attempt was made to measure fecundity. There are some technical differences between fecundity, sexual reproduction, and recruitment. For the purposes of Fec these differences do not matter - if estimates fecundity, recruitment or sexual reproduction are collected, Fec = “
Yes- fecundity was measured for the matrix
No- fecundity was not measured for the matrix
NA- it is not known whether fecundity was measured for the matrix
A brief description of experimental treatments of the population intentionally imposed by humans.
- Write “Unmanipulated” if no experimental, human-imposed treatment was applied. Natural events of non-intentional occurrence should be recorded in the treatment in the publication form and in observations column here, especially if they are used as an explanatory factor in the study.
- For example, population dynamics could be compared in disturbed vs. undisturbed areas. In these cases MatrixTreatment should be recorded as “Unmanipulated”, a note should be added in Observation and the name of the population should include a clear indication of the conditions. e.g. “Population 1 - disturbed”, “Population 2 - undisturbed”.
Select the following options:
W– Wild: Studied in natural conditions
C– Captive: studied for most part of the life cycle of the species in a botanical garden, greenhouse, laboratory, etc.
CW– Captured from wild: if the species was taken from a wild population but studied in labs or garden.
C;W– Mixed studies that incorporate vital rates from both captive and wild populations
3.7.16 Studied Sex
Indication of the sex(es) considered when constructing the matrix population model.
M- Studied only males
F- Studied only females
M/F- Males and females separately in the same population matrix model
A- All sexes together
NA- There are no distinct sexes (e.g. a virus)
Where the data was obtained to construct the matrix. If the data is from an appendix that is attached at the end of the original publication, record it as “Paper” and NOT as “Online Appendix”. “Online Appendix” is only for appendices that are in separate documents. Reselect the option to unselect it. If sources other than those below are used, a short but useful description should be given. The aim of this field is that everybody can find the related information ASAP e.g. if something needs to be fixed.
- Altered - the original published matrix was altered for accuracy. Include specific reason(s) for why the changes were made (e.g., seed bank issue, typo corrected through author communications, recalculating from pre-breeding to post-breeding, etc.) and information on how you calculated the matrix in the observation field.
- Author communication - Matrices derived from personal communication with author.
- Book: Matrices come from a book or book chapter
- Calculated - digitiser self-calculated the matrix from a life table or other data sources. Include what the original data type is (e.g. life table, integral projection model, individual-based model, etc.) and information on how you calculated the matrix in the observation field.
- Database - Matrices derived from one of the various databases that have been merged into COMPADRE/COMADRE see Database above.
- Old matrices - Matrices derived from an old matrices file (no more detailed description is available)
- Online appendix - The matrices come from an online appendix that is not attached at the end of the original publication. Must be a separate document.
- Other sources - The matrices came from a source not listed here. Include more details in the
Observationsfield of the matrix form.
- Paper - Matrices derived from a published manuscript.
Add any useful information about the population matrix. (e.g. geographic coordinates of pooled populations, unusual estimations or treatments, etc.)
Some standardised sentences:
- The GPS coordinates were approximated to the closest geographic location described in the reference. (see Geolocation)
- GPS co-ordinates cited exactly as reported in original paper. These do not match written study site description. (see Geolocation)
- Geolocation / Altitude from descriptor: (if no matrices are entered yet but a geolocation information are available)
- Matrix is calculated with stochastic model
- X years since last fire
- Calculated with demographic data from Author JournalName YearPublished
- Data is from a greenhouse experiment
- Matrix Class Author is not clarified
3.7.19 Create/Edit Matrix
After saving the “New Matrix Set” form, the matrices can be added from the population form under the “Population Matrices” tab. These are the population matrix models. Including the overall matrix (A) and, where possible, the sub-matrices U (survival), F (fecundity), C (clonality). A range of numeric values is possible in each element of the matrix. Sometimes only a U matrix is available because data on reproduction were not collected. In these cases the U matrix should be used as the A matrix, and a note recorded in
- The A matrix - The overall matrix including all processes. The A matrix can usually be “split” into consituent processes represented by the U, F and C sub-matrices such that A = U + F + C. Transition probabilities are constrained between 0 and 1. Reproductive values are always positive but have no upper bound.
- The U matrix - The population sub-matrix model U (a sub-matrix of A), describes the survival-dependent dynamics of a population under the conditions described above. Values are constrained to be between 0 and 1. These include only survival-dependent vital rates (no sexual or clonal reproduction). If only the U matrix is available, it should also be used as the A matrix (see “The F matrix” below).
- The F matrix - The population sub-matrix model F (a sub-matrix of A), which describes the sexual-reproduction dynamics of a population under the conditions described above. A range of numeric values possible, but are constrained to be positive. These include only estimates of sexual reproduction (no clonal reproduction). Sometimes sexual reproduction is not recorded (e.g. because it was not the focus of the study). This should be noted in observations and recorded using Fec (see elsewhere in this guide). Where possible, the “known unknowns” should be recorded as NA. For example, if you know that the “adult class” reproduces sexually, but simply was not estimated you should record NA for that element’s fecundity, and “No” for Fec.
- The C matrix - The population sub-matrix model C (a sub-matrix of A), which describes the clonal-reproduction dynamics of a population under the conditions described above. A range of numeric values are possible, but these are constrained to be positive. These include only estimates of clonal reproduction. Where there is no clonality, this matrix should be included, but will be all 0 values.
The values for the U, F and C matrices are only digitised for “Divided” matrices (indicated in the field
3.7.20 Notes for matrix construction:
- Each cell represents transition from the column stage to the row stage.
- You may enter a number or NA (Not Available).
- For survival rates, the values are restricted between 0 and 1. The sum of the survival rates from a single stage (column) should not exceed one. An popup alert will be generated when this happens.
- Reproductive values do not have upper bounds but should not be a negative number. This also applies to compound cells where survival rates and reproductive values are combined.
- “0” should not be colored.
- Values across the U, F, and C matrices should add up to the A matrix. If there is not enough information to divide compound cells in A matrix, the matrix should be marked “Indivisible” and only A matrix should be recorded.