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.89801 | |
| 2 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 9.93625 | |
| 3 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 9.9641 | |
| 4 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 9.89108 | |
| 5 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 9.88269 | |
| 6 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 9.9448 | |
| 7 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 9.96516 | |
| 8 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 9.96071 | |
| 9 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 9.93265 | |
| 10 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 9.92121 | |
| 11 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 9.92047 | |
| 12 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 9.96118 | |
| 13 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 9.9087 | |
| 14 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 9.95041 | |
| 15 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 9.93696 | |
| 16 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 9.84087 | |
| 17 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 9.91192 | |
| 18 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 9.92677 | |
| 19 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 9.96532 | |
| 20 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 9.96222 | |
| 21 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 9.92376 | |
| 22 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 9.82651 | |
| 23 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 9.96422 | |
| 24 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 9.91624 | |
| 25 | Unique | NormalisedAlpha | 1.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 9.89983 |
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.92518 |
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.00792 | |
| 27 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 1.00584 | |
| 28 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 1.00466 | |
| 29 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 1.00885 | |
| 30 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 1.01249 | |
| 31 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 1.00518 | |
| 32 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 1.00199 | |
| 33 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 1.00365 | |
| 34 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 1.00666 | |
| 35 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 1.00909 | |
| 36 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 1.00723 | |
| 37 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 1.00346 | |
| 38 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 1.00777 | |
| 39 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 1.00398 | |
| 40 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 1.00573 | |
| 41 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 1.01439 | |
| 42 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 1.00667 | |
| 43 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 1.01039 | |
| 44 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 1.00413 | |
| 45 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 1.004 | |
| 46 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 1.00788 | |
| 47 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 1.01586 | |
| 48 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 1.0033 | |
| 49 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 1.00841 | |
| 50 | Unique | NormalisedBeta | 1.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 1.00911 | |
| 51 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [0.0, 10.0) km | 1.01576 | |
| 52 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 1.01184 | |
| 53 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 1.00966 | |
| 54 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 1.01782 | |
| 55 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 1.02445 | |
| 56 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 1.01001 | |
| 57 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 1.00398 | |
| 58 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 1.00736 | |
| 59 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 1.01354 | |
| 60 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 1.01756 | |
| 61 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 1.01429 | |
| 62 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 1.00687 | |
| 63 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 1.01504 | |
| 64 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 1.00793 | |
| 65 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 1.01161 | |
| 66 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 1.0292 | |
| 67 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 1.01322 | |
| 68 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 1.01998 | |
| 69 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 1.00819 | |
| 70 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 1.00807 | |
| 71 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 1.01536 | |
| 72 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 1.0307 | |
| 73 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 1.00656 | |
| 74 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 1.01646 | |
| 75 | Unique | NormalisedBeta | 2.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 1.01879 | |
| 76 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [0.0, 10.0) km | 1.02348 | |
| 77 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [0.0, 10.0) km | 1.01796 | |
| 78 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [0.0, 10.0) km | 1.015 | |
| 79 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [0.0, 10.0) km | 1.02687 | |
| 80 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [0.0, 10.0) km | 1.03574 | |
| 81 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [10.0, 20.0) km | 1.01449 | |
| 82 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [10.0, 20.0) km | 1.00596 | |
| 83 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [10.0, 20.0) km | 1.01111 | |
| 84 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [10.0, 20.0) km | 1.02059 | |
| 85 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [10.0, 20.0) km | 1.02538 | |
| 86 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [20.0, 30.0) km | 1.0211 | |
| 87 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [20.0, 30.0) km | 1.01023 | |
| 88 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [20.0, 30.0) km | 1.02186 | |
| 89 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [20.0, 30.0) km | 1.01183 | |
| 90 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [20.0, 30.0) km | 1.01762 | |
| 91 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [30.0, 40.0) km | 1.04416 | |
| 92 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [30.0, 40.0) km | 1.01963 | |
| 93 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [30.0, 40.0) km | 1.02874 | |
| 94 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [30.0, 40.0) km | 1.01219 | |
| 95 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [30.0, 40.0) km | 1.01218 | |
| 96 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [0.0, 10.0) × [40.0, 50.0) km | 1.02243 | |
| 97 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [10.0, 20.0) × [40.0, 50.0) km | 1.04428 | |
| 98 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [20.0, 30.0) × [40.0, 50.0) km | 1.00979 | |
| 99 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [30.0, 40.0) × [40.0, 50.0) km | 1.02415 | |
| 100 | Unique | NormalisedBeta | 3.0 | types | subcommunity | [40.0, 50.0) × [40.0, 50.0) km | 1.02902 |