Integration with Diversity.jl
EcoSISTEM is integrated with the Diversity package, so diversity measures can be calculated directly on an ecosystem - an Ecosystem is a Diversity metacommunity, with one subcommunity per grid cell.
See The basics of EcoSISTEM.jl for how to set one up; the example below builds a small one to measure.
Every grid cell is a subcommunity, including inactive ones - sea off a coastline, or a cell a Deactivate intervention has destroyed. That costs nothing for the metacommunity measures, which weight each subcommunity by its share of the total abundance and so give an empty cell zero weight; the partitioned results are identical whether or not the empty cells are there. But a subcommunity measure returns one row per cell, so on a small island in a large grid most of those rows describe empty sea, and an index of an empty community is not defined. Select the occupied cells before asking a per-cell question.
using Diversity
norm_sub_alpha(eco, 1.0) # subcommunity measures - one row per grid cell| Row | div_type | measure | q | type_level | type_name | partition_level | partition_name | diversity |
|---|---|---|---|---|---|---|---|---|
| String | String | Float64 | String | String | String | String | Float64 | |
| 1 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [0.0, 10.0) km | 9.87611 | |
| 2 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 9.89641 | |
| 3 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 9.95034 | |
| 4 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 9.89602 | |
| 5 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 9.90947 | |
| 6 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 9.87443 | |
| 7 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 9.91314 | |
| 8 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 9.96038 | |
| 9 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 9.93027 | |
| 10 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 9.91519 | |
| 11 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 9.94813 | |
| 12 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 9.94756 | |
| 13 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 9.86484 | |
| 14 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 9.95111 | |
| 15 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 9.95114 | |
| 16 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 9.89392 | |
| 17 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 9.96328 | |
| 18 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 9.94799 | |
| 19 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 9.95281 | |
| 20 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 9.9535 | |
| 21 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 9.94844 | |
| 22 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 9.80038 | |
| 23 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 9.96902 | |
| 24 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 9.88443 | |
| 25 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 9.91023 |
norm_meta_alpha(eco, 1.0) # or metacommunity measures - one row for the landscape| Row | div_type | measure | q | type_level | type_name | partition_level | partition_name | diversity |
|---|---|---|---|---|---|---|---|---|
| String | String | Float64 | String | String | String | String | Float64 | |
| 1 | Unique | NormalisedAlpha | 1.0 | types | metacommunity | 9.92081 |
Any measure takes several values of the viewpoint parameter q at once - 0 counts rare and common species alike, and larger values weight towards the commonest:
norm_sub_beta(eco, 0.0:3.0)| Row | div_type | measure | q | type_level | type_name | partition_level | partition_name | diversity |
|---|---|---|---|---|---|---|---|---|
| String | String | Float64 | String | String | String | String | Float64 | |
| 1 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [0.0, 10.0) × [0.0, 10.0) km | 1.0 | |
| 2 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 1.0 | |
| 3 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 1.0 | |
| 4 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 1.0 | |
| 5 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 1.0 | |
| 6 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 1.0 | |
| 7 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 1.0 | |
| 8 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 1.0 | |
| 9 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 1.0 | |
| 10 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 1.0 | |
| 11 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 1.0 | |
| 12 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 1.0 | |
| 13 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 1.0 | |
| 14 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 1.0 | |
| 15 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 1.0 | |
| 16 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 1.0 | |
| 17 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 1.0 | |
| 18 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 1.0 | |
| 19 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 1.0 | |
| 20 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 1.0 | |
| 21 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 1.0 | |
| 22 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 1.0 | |
| 23 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 1.0 | |
| 24 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 1.0 | |
| 25 | Unique | NormalisedBeta | 0.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 1.0 | |
| 26 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [0.0, 10.0) km | 1.01017 | |
| 27 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 1.01008 | |
| 28 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 1.00674 | |
| 29 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 1.00856 | |
| 30 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 1.00899 | |
| 31 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 1.01166 | |
| 32 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 1.00693 | |
| 33 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 1.00427 | |
| 34 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 1.00644 | |
| 35 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 1.00945 | |
| 36 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 1.00535 | |
| 37 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 1.00506 | |
| 38 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 1.01228 | |
| 39 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 1.00361 | |
| 40 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 1.0045 | |
| 41 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 1.00906 | |
| 42 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 1.00289 | |
| 43 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 1.00701 | |
| 44 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 1.00525 | |
| 45 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 1.00519 | |
| 46 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 1.00602 | |
| 47 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 1.02074 | |
| 48 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 1.00268 | |
| 49 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 1.01207 | |
| 50 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 1.00807 | |
| 51 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [0.0, 10.0) km | 1.02051 | |
| 52 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 1.02003 | |
| 53 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 1.01353 | |
| 54 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 1.0171 | |
| 55 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 1.01817 | |
| 56 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 1.02307 | |
| 57 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 1.01462 | |
| 58 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 1.00862 | |
| 59 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 1.01288 | |
| 60 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 1.01805 | |
| 61 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 1.01049 | |
| 62 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 1.01003 | |
| 63 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 1.02386 | |
| 64 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 1.00717 | |
| 65 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 1.00902 | |
| 66 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 1.01804 | |
| 67 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 1.00577 | |
| 68 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 1.0136 | |
| 69 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 1.01041 | |
| 70 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 1.01023 | |
| 71 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 1.01147 | |
| 72 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 1.04139 | |
| 73 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 1.0053 | |
| 74 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 1.0239 | |
| 75 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 1.01663 | |
| 76 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [0.0, 10.0) km | 1.03091 | |
| 77 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 1.02976 | |
| 78 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 1.02036 | |
| 79 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 1.0256 | |
| 80 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 1.02741 | |
| 81 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 1.03415 | |
| 82 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 1.02309 | |
| 83 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 1.01303 | |
| 84 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 1.01926 | |
| 85 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 1.02582 | |
| 86 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 1.01538 | |
| 87 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 1.0149 | |
| 88 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 1.03467 | |
| 89 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 1.01065 | |
| 90 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 1.01354 | |
| 91 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 1.02683 | |
| 92 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 1.00863 | |
| 93 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 1.01975 | |
| 94 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 1.01548 | |
| 95 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 1.01509 | |
| 96 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 1.01642 | |
| 97 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 1.06153 | |
| 98 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 1.00787 | |
| 99 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 1.03534 | |
| 100 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 1.02566 |