Skip to contents

Calculate the euclidean distance between a set of environmental predictor variables and mutliple taxa

Usage

calc_distance(
  predictors,
  taxa = elements::ModelledTaxaCodes,
  vars = elements::VariableNames,
  method = "median",
  append = "ids"
)

Arguments

predictors

A data frame of predictors. Must include the following columns: L, M, N, R, S, SD, GP, tmax_sm, tmin_wt, prec_wt, prec_sm, and optionally taxon

taxa

A vector of strings containing one or more taxa to calculate distances for. See elements::ModelledTaxaCodes.

vars

A vector of variable names, one or more of elements::VariableNames.

method

One of "median" or "mean" indicating whether to measure the euclidean distance from the predictor variables to the median or mean values.

append

A string, one of "all", "predictors", or "ids" representing which columns from the predictors data frame to return with the results.

Value

A data frame containing the euclidean distance for each taxon.

Examples

elements::calc_distance(predictors = elements::ExampleScenarios)
#>       scenario_code scenario_stage climate_scenario timeslice  scenario_name
#> 1.1             a.i       baseline       historical      2007 Climate Change
#> 1.2             a.i       baseline       historical      2007 Climate Change
#> 1.3             a.i       baseline       historical      2007 Climate Change
#> 1.4             a.i       baseline       historical      2007 Climate Change
#> 1.5             a.i       baseline       historical      2007 Climate Change
#> 1.6             a.i       baseline       historical      2007 Climate Change
#> 1.7             a.i       baseline       historical      2007 Climate Change
#> 1.8             a.i       baseline       historical      2007 Climate Change
#> 1.9             a.i       baseline       historical      2007 Climate Change
#> 1.10            a.i       baseline       historical      2007 Climate Change
#> 1.11            a.i       baseline       historical      2007 Climate Change
#> 1.12            a.i       baseline       historical      2007 Climate Change
#> 1.13            a.i       baseline       historical      2007 Climate Change
#> 1.14            a.i       baseline       historical      2007 Climate Change
#> 1.15            a.i       baseline       historical      2007 Climate Change
#> 1.16            a.i       baseline       historical      2007 Climate Change
#> 1.17            a.i       baseline       historical      2007 Climate Change
#> 1.18            a.i       baseline       historical      2007 Climate Change
#> 1.19            a.i       baseline       historical      2007 Climate Change
#> 1.20            a.i       baseline       historical      2007 Climate Change
#> 1.21            a.i       baseline       historical      2007 Climate Change
#> 1.22            a.i       baseline       historical      2007 Climate Change
#> 1.23            a.i       baseline       historical      2007 Climate Change
#> 1.24            a.i       baseline       historical      2007 Climate Change
#> 1.25            a.i       baseline       historical      2007 Climate Change
#> 1.26            a.i       baseline       historical      2007 Climate Change
#> 1.27            a.i       baseline       historical      2007 Climate Change
#> 1.28            a.i       baseline       historical      2007 Climate Change
#> 1.29            a.i       baseline       historical      2007 Climate Change
#> 1.30            a.i       baseline       historical      2007 Climate Change
#> 1.31            a.i       baseline       historical      2007 Climate Change
#> 1.32            a.i       baseline       historical      2007 Climate Change
#> 1.33            a.i       baseline       historical      2007 Climate Change
#> 1.34            a.i       baseline       historical      2007 Climate Change
#> 1.35            a.i       baseline       historical      2007 Climate Change
#> 1.36            a.i       baseline       historical      2007 Climate Change
#> 1.37            a.i       baseline       historical      2007 Climate Change
#> 1.38            a.i       baseline       historical      2007 Climate Change
#> 1.39            a.i       baseline       historical      2007 Climate Change
#> 1.40            a.i       baseline       historical      2007 Climate Change
#> 1.41            a.i       baseline       historical      2007 Climate Change
#> 1.42            a.i       baseline       historical      2007 Climate Change
#> 1.43            a.i       baseline       historical      2007 Climate Change
#> 1.44            a.i       baseline       historical      2007 Climate Change
#> 1.45            a.i       baseline       historical      2007 Climate Change
#> 1.46            a.i       baseline       historical      2007 Climate Change
#> 1.47            a.i       baseline       historical      2007 Climate Change
#> 1.48            a.i       baseline       historical      2007 Climate Change
#> 1.49            a.i       baseline       historical      2007 Climate Change
#> 1.50            a.i       baseline       historical      2007 Climate Change
#> 1.51            a.i       baseline       historical      2007 Climate Change
#> 1.52            a.i       baseline       historical      2007 Climate Change
#> 1.53            a.i       baseline       historical      2007 Climate Change
#> 1.54            a.i       baseline       historical      2007 Climate Change
#> 1.55            a.i       baseline       historical      2007 Climate Change
#> 1.56            a.i       baseline       historical      2007 Climate Change
#> 1.57            a.i       baseline       historical      2007 Climate Change
#> 1.58            a.i       baseline       historical      2007 Climate Change
#> 1.59            a.i       baseline       historical      2007 Climate Change
#> 1.60            a.i       baseline       historical      2007 Climate Change
#> 1.61            a.i       baseline       historical      2007 Climate Change
#> 1.62            a.i       baseline       historical      2007 Climate Change
#> 1.63            a.i       baseline       historical      2007 Climate Change
#> 1.64            a.i       baseline       historical      2007 Climate Change
#> 1.65            a.i       baseline       historical      2007 Climate Change
#> 1.66            a.i       baseline       historical      2007 Climate Change
#> 1.67            a.i       baseline       historical      2007 Climate Change
#> 1.68            a.i       baseline       historical      2007 Climate Change
#> 1.69            a.i       baseline       historical      2007 Climate Change
#> 1.70            a.i       baseline       historical      2007 Climate Change
#> 1.71            a.i       baseline       historical      2007 Climate Change
#> 1.72            a.i       baseline       historical      2007 Climate Change
#> 1.73            a.i       baseline       historical      2007 Climate Change
#> 1.74            a.i       baseline       historical      2007 Climate Change
#> 1.75            a.i       baseline       historical      2007 Climate Change
#> 1.76            a.i       baseline       historical      2007 Climate Change
#> 1.77            a.i       baseline       historical      2007 Climate Change
#> 1.78            a.i       baseline       historical      2007 Climate Change
#> 1.79            a.i       baseline       historical      2007 Climate Change
#> 1.80            a.i       baseline       historical      2007 Climate Change
#> 1.81            a.i       baseline       historical      2007 Climate Change
#> 1.82            a.i       baseline       historical      2007 Climate Change
#> 1.83            a.i       baseline       historical      2007 Climate Change
#> 1.84            a.i       baseline       historical      2007 Climate Change
#> 1.85            a.i       baseline       historical      2007 Climate Change
#> 1.86            a.i       baseline       historical      2007 Climate Change
#> 1.87            a.i       baseline       historical      2007 Climate Change
#> 1.88            a.i       baseline       historical      2007 Climate Change
#> 1.89            a.i       baseline       historical      2007 Climate Change
#> 1.90            a.i       baseline       historical      2007 Climate Change
#> 1.91            a.i       baseline       historical      2007 Climate Change
#> 1.92            a.i       baseline       historical      2007 Climate Change
#> 1.93            a.i       baseline       historical      2007 Climate Change
#> 1.94            a.i       baseline       historical      2007 Climate Change
#> 1.95            a.i       baseline       historical      2007 Climate Change
#> 1.96            a.i       baseline       historical      2007 Climate Change
#> 1.97            a.i       baseline       historical      2007 Climate Change
#> 1.98            a.i       baseline       historical      2007 Climate Change
#> 1.99            a.i       baseline       historical      2007 Climate Change
#> 1.100           a.i       baseline       historical      2007 Climate Change
#> 1.101           a.i       baseline       historical      2007 Climate Change
#> 1.102           a.i       baseline       historical      2007 Climate Change
#> 1.103           a.i       baseline       historical      2007 Climate Change
#> 1.104           a.i       baseline       historical      2007 Climate Change
#> 1.105           a.i       baseline       historical      2007 Climate Change
#> 1.106           a.i       baseline       historical      2007 Climate Change
#> 1.107           a.i       baseline       historical      2007 Climate Change
#> 1.108           a.i       baseline       historical      2007 Climate Change
#> 1.109           a.i       baseline       historical      2007 Climate Change
#> 1.110           a.i       baseline       historical      2007 Climate Change
#> 1.111           a.i       baseline       historical      2007 Climate Change
#> 1.112           a.i       baseline       historical      2007 Climate Change
#> 1.113           a.i       baseline       historical      2007 Climate Change
#> 1.114           a.i       baseline       historical      2007 Climate Change
#> 1.115           a.i       baseline       historical      2007 Climate Change
#> 1.116           a.i       baseline       historical      2007 Climate Change
#> 1.117           a.i       baseline       historical      2007 Climate Change
#> 1.118           a.i       baseline       historical      2007 Climate Change
#> 1.119           a.i       baseline       historical      2007 Climate Change
#> 1.120           a.i       baseline       historical      2007 Climate Change
#> 1.121           a.i       baseline       historical      2007 Climate Change
#> 1.122           a.i       baseline       historical      2007 Climate Change
#> 1.123           a.i       baseline       historical      2007 Climate Change
#> 1.124           a.i       baseline       historical      2007 Climate Change
#> 1.125           a.i       baseline       historical      2007 Climate Change
#> 1.126           a.i       baseline       historical      2007 Climate Change
#> 1.127           a.i       baseline       historical      2007 Climate Change
#> 1.128           a.i       baseline       historical      2007 Climate Change
#> 1.129           a.i       baseline       historical      2007 Climate Change
#> 1.130           a.i       baseline       historical      2007 Climate Change
#> 1.131           a.i       baseline       historical      2007 Climate Change
#> 1.132           a.i       baseline       historical      2007 Climate Change
#> 1.133           a.i       baseline       historical      2007 Climate Change
#> 1.134           a.i       baseline       historical      2007 Climate Change
#> 1.135           a.i       baseline       historical      2007 Climate Change
#> 1.136           a.i       baseline       historical      2007 Climate Change
#> 1.137           a.i       baseline       historical      2007 Climate Change
#> 1.138           a.i       baseline       historical      2007 Climate Change
#> 1.139           a.i       baseline       historical      2007 Climate Change
#> 1.140           a.i       baseline       historical      2007 Climate Change
#> 1.141           a.i       baseline       historical      2007 Climate Change
#> 1.142           a.i       baseline       historical      2007 Climate Change
#>                                        taxon_code distance
#> 1.1                                    abies_alba 3.290727
#> 1.2                           abies_borisii-regis 3.203137
#> 1.3                             abies_cephalonica 3.383786
#> 1.4                abies_cilicica_subsp._isaurica 3.328743
#> 1.5                                 abies_grandis 2.559653
#> 1.6                            abies_nordmanniana 2.444428
#> 1.7        abies_nordmanniana_subsp._equi-trojani 2.789854
#> 1.8        abies_nordmanniana_subsp._nordmanniana 3.352738
#> 1.9                                 abies_procera 2.446669
#> 1.10                         abietinella_abietina 2.608063
#> 1.11                         abutilon_theophrasti 2.991759
#> 1.12                              acacia_dealbata 2.835607
#> 1.13                               acacia_saligna 3.033461
#> 1.14                           acalypha_virginica 3.038219
#> 1.15                        acantholimon_acerosum 2.877894
#> 1.16  acantholimon_acerosum_subsp._brachystachyum 2.815904
#> 1.17                         acantholimon_echinus 2.942183
#> 1.18                       acantholimon_puberulum 2.751694
#> 1.19        acantholimon_puberulum_var._puberulum 2.988561
#> 1.20                        acantholimon_ulicinum 3.360145
#> 1.21        acantholimon_ulicinum_subsp._ulicinum 3.255066
#> 1.22                        acantholimon_venestum 2.901526
#> 1.23                        acantholimon_venustum 2.934785
#> 1.24          acantholimon_venustum_var._venustum 3.499293
#> 1.25                            acanthus_hirsutus 2.825348
#> 1.26                          acanthus_hungaricus 2.455483
#> 1.27                              acanthus_mollis 3.183755
#> 1.28                acanthus_mollis_subsp._mollis 2.631565
#> 1.29                            acanthus_spinosus 2.621390
#> 1.30                           acarospora_fuscata 2.555449
#> 1.31                               acer_campestre 2.959782
#> 1.32              acer_campestre_subsp._campestre 2.707919
#> 1.33                            acer_cappadocicum 3.426917
#> 1.34                             acer_heldreichii 3.362432
#> 1.35                                acer_hyrcanum 2.894737
#> 1.36                                 acer_lobelii 3.600290
#> 1.37                          acer_monspessulanum 2.663544
#> 1.38      acer_monspessulanum_subsp._microphyllum 3.386163
#> 1.39    acer_monspessulanum_subsp._monspessulanum 2.987290
#> 1.40                                 acer_negundo 2.945201
#> 1.41                               acer_obtusatum 3.170468
#> 1.42                                  acer_opalus 2.918517
#> 1.43                             acer_platanoides 3.234520
#> 1.44                          acer_pseudoplatanus 3.176335
#> 1.45                            acer_sempervirens 3.409572
#> 1.46                               acer_tataricum 2.702094
#> 1.47                            acer_trautvetteri 3.405717
#> 1.48                        achillea_abrotanoides 2.626071
#> 1.49                        achillea_ageratifolia 3.045371
#> 1.50                            achillea_ageratum 3.089178
#> 1.51            achillea_aleppica_subsp._aleppica 3.044897
#> 1.52         achillea_aleppica_subsp._zederbaueri 3.265013
#> 1.53                             achillea_arabica 2.796634
#> 1.54                       achillea_aspleniifolia 2.324600
#> 1.55                              achillea_atrata 2.401211
#> 1.56       achillea_barrelieri_subsp._mucronulata 3.841817
#> 1.57                           achillea_clavennae 2.544495
#> 1.58                            achillea_clusiana 2.362763
#> 1.59                          achillea_clypeolata 2.713711
#> 1.60                           achillea_coarctata 2.950071
#> 1.61                             achillea_collina 2.525134
#> 1.62                        achillea_crithmifolia 2.600154
#> 1.63                             achillea_distans 2.381165
#> 1.64              achillea_distans_subsp._stricta 2.505953
#> 1.65        achillea_distans_subsp._tanacetifolia 2.392164
#> 1.66          achillea_erba-rotta_subsp._moschata 2.647539
#> 1.67                              achillea_euxina 2.706652
#> 1.68                             achillea_falcata 2.674280
#> 1.69                             achillea_fraasii 3.412639
#> 1.70                         achillea_grandifolia 2.873950
#> 1.71                         achillea_holosericea 3.327259
#> 1.72                            achillea_inundata 2.764236
#> 1.73            achillea_kotschyi_subsp._kotschyi 3.630286
#> 1.74                         achillea_leptophylla 2.983601
#> 1.75                           achillea_ligustica 3.120215
#> 1.76                           achillea_lingulata 2.464730
#> 1.77                         achillea_macrophylla 3.499823
#> 1.78                            achillea_maritima 3.017395
#> 1.79            achillea_maritima_subsp._maritima 3.274271
#> 1.80                           achillea_micrantha 2.948348
#> 1.81                         achillea_millefolium 2.424338
#> 1.82                    achillea_millefolium_aggr 2.507676
#> 1.83      achillea_millefolium_subsp._millefolium 2.461473
#> 1.84         achillea_millefolium_subsp._sudetica 2.491517
#> 1.85                                achillea_nana 2.843504
#> 1.86                             achillea_nobilis 2.650581
#> 1.87          achillea_nobilis_subsp._neilreichii 2.691049
#> 1.88              achillea_nobilis_subsp._nobilis 2.883282
#> 1.89                          achillea_ochroleuca 3.021631
#> 1.90                             achillea_odorata 3.311568
#> 1.91                             achillea_oxyloba 2.556651
#> 1.92              achillea_oxyloba_subsp._schurii 2.215693
#> 1.93                           achillea_pannonica 2.618875
#> 1.94                             achillea_phrygia 2.789143
#> 1.95                           achillea_pratensis 2.566658
#> 1.96                            achillea_ptarmica 2.312536
#> 1.97                           achillea_pyrenaica 2.568272
#> 1.98                           achillea_roseoalba 2.808413
#> 1.99                         achillea_salicifolia 2.609699
#> 1.100    achillea_santolinoides_subsp._wilhelmsii 3.186791
#> 1.101                            achillea_setacea 2.673112
#> 1.102                         achillea_sintenisii 3.293599
#> 1.103                           achillea_styriaca 2.973419
#> 1.104                        achillea_teretifolia 2.815730
#> 1.105                          achillea_tomentosa 2.970291
#> 1.106                          achillea_virescens 2.545221
#> 1.107           achillea_virescens_subsp._tenorei 3.738573
#> 1.108                       achnatherum_bromoides 3.056308
#> 1.109                   achnatherum_calamagrostis 2.541247
#> 1.110                      aconitum_angustifolium 2.570210
#> 1.111                            aconitum_anthora 2.566946
#> 1.112                            aconitum_degenii 3.212914
#> 1.113                             aconitum_firmum 2.536360
#> 1.114                         aconitum_lycoctonum 3.172342
#> 1.115       aconitum_lycoctonum_subsp._lycoctonum 3.159415
#> 1.116     aconitum_lycoctonum_subsp._neapolitanum 2.598042
#> 1.117         aconitum_lycoctonum_subsp._vulparia 3.476391
#> 1.118                         aconitum_moldavicum 3.332661
#> 1.119                           aconitum_napellus 2.636463
#> 1.120                      aconitum_napellus_aggr 3.044166
#> 1.121            aconitum_napellus_subsp._vulgare 3.149239
#> 1.122                           aconitum_plicatum 2.681721
#> 1.123                           aconitum_tauricum 2.347740
#> 1.124                            aconitum_toxicum 2.609242
#> 1.125                         aconitum_variegatum 2.936283
#> 1.126                    aconitum_variegatum_aggr 2.996366
#> 1.127          aconitum_variegatum_subsp._nasutum 3.088891
#> 1.128                          aconogonon_alpinum 2.468692
#> 1.129                              acorus_calamus 2.715531
#> 1.130                  acrocarpe_mossen_(overige) 2.445630
#> 1.131                             actaea_europaea 3.080377
#> 1.132                              actaea_spicata 3.446216
#> 1.133                     adenocarpus_complicatus 2.411959
#> 1.134                       adenophora_liliifolia 2.420457
#> 1.135                       adenostyles_alliariae 3.052103
#> 1.136      adenostyles_alliariae_subsp._alliariae 3.466476
#> 1.137                          adenostyles_alpina 3.018982
#> 1.138            adenostyles_alpina_subsp._alpina 3.202158
#> 1.139            adenostyles_glabra_subsp._glabra 3.906979
#> 1.140                     adenostyles_leucophylla 2.699815
#> 1.141                   adiantum_capillus-veneris 2.769876
#> 1.142                           adonis_aestivalis 2.604191
#>  [ reached 'max' / getOption("max.print") -- omitted 341462 rows ]