stoufferlab / driver-species

A rigorous application of structural controllability to ecological networks

Home Page:https://doi.org/10.1111/1365-2745.13147

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Keystoness, centrality and the structural controllability of pollination networks

Fernando Cagua, Kate Wooton, and Daniel Stouffer

Download PDF DOI:10.1111/1365-2745.13147 GNU v3.0 license

We apply structural controllability to pollination networks and are able to identify a set of species that are critical to changing the state of the community and underpin the stable coexistence of species in their communities.


Graphical abstract explaining the structural controllability of networks


This project has been published as a peer-reviewed article at the Journal of Ecology. Please cite as "Cagua EF, Wootton KL, Stouffer DB. Keystoneness, centrality, and the structural controllability of ecological networks. J Ecol. 2019. doi: 10.1111/1365-2745.13147."

You can download a copy of the paper from the publisher page (paywalled) or, alternatively, download the latest non-copyedited version of the paper from this repo.

Summary

  1. An important dimension of a species' role is its ability to alter the state and maintain the diversity of its community. Centrality metrics have often been used to identify these species, which are sometimes referred to as "keystone" species. However, the relationship between centrality and keystoneness is largely phenomenological and based mostly on our intuition regarding what constitutes an important species. While centrality is useful when predicting which species' extinctions could cause the largest change in a community, it says little about how these species could be used to attain or preserve a particular community state.

  2. Here we introduce structural controllability, an approach that allows us to quantify the extent to which network topology can be harnessed to achieve a desired state. It also allows us to quantify a species' control capacity—its relative importance—and identify the set of species that are critical in this context because they have the largest possible control capacity. We illustrate the application of structural controllability with ten pairs of uninvaded and invaded plant-pollinator communities.

  3. We found that the controllability of a community is not dependent on its invasion status, but on the asymmetric nature of its mutual dependences. While central species were also likely to have a large control capacity, centrality fails to identify species that, despite being less connected, were critical in their communities. Interestingly, this set of critical species was mostly composed of plants and included every invasive species in our dataset. We also found that species with high control capacity, and in particular critical species, contribute the most to the stable coexistence of their community. This result was true, even when controlling for the species' degree, abundance/interaction strength, and the relative dependence of their partners.

  4. Synthesis: Structural controllability is strongly related to the stability of a network and measures the difficulty of managing an ecological community. It also identifies species that are critical to sustain biodiversity and to change or maintain the state of their community and are therefore likely to be very relevant for management and conservation.

Keywords: Invasive species, keystone species, management interventions, mutualism, network control theory, plant population and community dynamics, species' importance, control capacity, structural stability

Reproduce the results

1. Check requirements

Make sure that the software and hardware requirements (below) have been met. All code was tested on an x86_64-apple-darwin15.6.0 (64-bit) platform but should everywhere that runs docker:

  • Docker 18.09 (might work on other versions but has not been tested)
  • 32GB RAM or more

2. Run the docker container

There are a couple alternatives here. The easiest one is using the following commands:

docker build -t driver-species .
docker run -d -e DISABLE_AUTH=true -p 8787:8787 -v $PWD:/home/rstudio/driver-species driver-species-container driver-species

This script will build the container image and run it for you. In some systems you will need sudo rights.

3. Run analyses

Just run the makefile in the project directory:

docker exec driver-species-container make -C /home/rstudio/driver-species

And now wait... it takes a several of hours to perform all analysis. It's OK to interrupt the process though, I use drake to manage the data analysis workflow. This means, that next time you attempt to run the results (using make) it will continue where it was left.

About

A rigorous application of structural controllability to ecological networks

https://doi.org/10.1111/1365-2745.13147

License:GNU General Public License v3.0


Languages

Language:R 75.5%Language:TeX 23.6%Language:Dockerfile 0.9%Language:Makefile 0.1%