In the Species Trait Experiment you can analyse the effect of environmental variables on 1 or more species traits, and also test how traits differ among multiple species.

How to run an STM in the BCCVL

  • At the top of the page click on the Experiments tab. 
  • Under the primary experiments heading click on Species Trait Modelling Experiment

Step 1: Description tab

  • Enter the name for your experiment in the first box. 
  • (optional) You can also add a description of your experiment in the box below if you want to convey more information. Some researchers use this box to record their research question or hypotheses for later referral.
  • Click Next.

Step 2: Algorithms tab

You can run two different trait analyses in the BCCVL:

1. Test the effect of environmental variables on traits: this will run an additive model that will test how the selected species traits are affected by all selected environmental variables (e.g. trait 1 ~ env1 + env2 + env3).

2. Test the differences in traits among species: this will run a model that will test how the selected traits differ among species (e.g. trait 1 ~ species). NOTE: you need to have selected data for multiple species to run this test.

  • Select the algorithm/s you would like to use to calibrate your model. You can choose one or all to run your experiment.
  • (optional) Configuration options: these options can be changed by changing the value or make a different selection from the drop down menu. The configuration options are currently set to the standard default values of the R packages so you do not need to make changes. However, configuring the model to best fit your data might give a better result.
  • Click Next. 

Step 3: Input Datasets tab

  • Select your pre-loaded species trait dataset by clicking the Select A Dataset button. Note: If you click this and you have no loaded species trait datasets you will need to visit the dataset page and import or upload the required data.
  • In the pop-up box select the dataset you wish to use in your STM. Click Select

Step 4: Configuration tab

  • The first 5 rows of data will be shown in this tab. You can select which traits and/or environmental variables should be used in the analyses by using the drop down menus under each column. You need to indicate whether your trait data are continuous, nominal (categorical data with no order, such as colour) or ordinal (categorical data with an order, such as cover: low-medium-high), and whether your environmental variables are continuous or categorical. NOTE: you have to nominate at least a lat, lon, species and one trait variable. Environmental variables are optional here, as BCCVL-provided environmental data can be selected in the next tab.

  • NOTE: Here you can run an experiment either for individual trait measurements or for species-level trait measurements.
  • Click Next

Step 5: Climate & Environmental Data tab

NOTE: This tab is optional if you have selected environmental data in the Input Dataset. You can choose to add environmental layers from datasets provided by the BCCVL. If you have not selected any environmental variables in the Input Dataset, this tab is required.

  • Click the Select Available Datasets button.
  • In the pop-up box you can enter search terms to filter for required datasets or browse through by scrolling.
  • Once you have found the dataset/s you are looking for select them and click Select Layers
  • When back on the Climate & Environmental Data tab you can select/deselect data layers in the blue box.
  • (optional) You can visualise each of the data layers by clicking the green eye icon, and on the right hand side of the map you can toggle which data layer you want to visualise.
  • Once you have selected all your environmental and climate layers click Next.

Step 6: Constraints tab

This is an optional tab that allows you to train your model to a particular area or region (e.g. Queensland only). The default constraint is the convex hull (= smallest polygon around all occurrence records - blue on the map). The green box indicates the area of the selected environmental/climate variables. If this area is smaller than the convex hull, the model will only be trained in that area.If you do not want to change the geographic extent of your model simply click Next. If you do want to constrain your model, there are three options:

  • Constrain by a pre-defined region

    • Select one of the four region types that are currently available in the BCCVL: Australian States and Territories, Local Government Areas, National Resource Management Regions, IBRA 7 regions.
    • Find the region of your interest in the drop down menu.
    • Click Add To Map.
  • Constrain by drawing a bounding box on the map

    • Click Draw On Map to draw a rectangular bounding box on the map to which the model will be constrained.
  • Constrain by defining the coordinates of the bounding box 

    • Enter coordinates for the northern, eastern, southern and western limits respectively to define the bounding box.
    • Click Input Constraints to add the defined bounding box to the map.

Note that the model will be trained on the selected area, and the results will include a predicted distribution map for the constrained area, as well as a projection to the geographic extent of your environmental/climate layers.

Step 7: Run tab

  • Ensure you are happy with your experiment design.
  • If all tabs are green then your experiment is ready to go.
  • Click Start Experiment.
  • If any of your tabs are red, revisit it and ensure you have filled in each component correctly.