Skip to contents

Coerce a permutation test to a data frame

Usage

# S3 method for class 'dynet_significance'
as.data.frame(
  x,
  row.names = NULL,
  optional = FALSE,
  what = c("result", "null"),
  ...
)

Arguments

x

A dynet_significance from significance().

row.names

Passed to the data frame method.

optional

Passed to the data frame method.

what

"result", the default, for one row per tested cell; "null" for the null distribution, one row per cell and surrogate.

...

Ignored.

Value

A base data frame. Under what = "result", the columns significance() documents. Under what = "null", the key columns of the statistic (such as time, node, measure), then replicate (the surrogate) and value (the statistic on it, NA where the surrogate did not produce the cell).

Examples

dn <- dynet(school_contacts)
tested <- significance(dn, statistic = metrics, measure = "density",
                       n = 19, seed = 1)
as.data.frame(tested)
#>    time measure   observed  null_mean     null_sd    null_lo    null_hi
#> 1     0 density 0.05494505 0.05610179 0.004697703 0.04642857 0.06043956
#> 2     1 density 0.04395604 0.04251012 0.003087646 0.03543956 0.04395604
#> 3     2 density 0.05494505 0.05263158 0.002787128 0.04945055 0.05494505
#> 4     3 density 0.06593407 0.06275304 0.003335038 0.05741758 0.06593407
#> 5     4 density 0.07142857 0.07200694 0.004809127 0.06291209 0.07692308
#> 6     5 density 0.08791209 0.08155003 0.004583572 0.07390110 0.08791209
#> 7     6 density 0.15934066 0.15240023 0.006563349 0.14285714 0.16483516
#> 8     7 density 0.10439560 0.09745518 0.006814099 0.08489011 0.10439560
#> 9     8 density 0.09890110 0.10179294 0.005897442 0.09340659 0.10989011
#> 10    9 density 0.08791209 0.08617698 0.005197282 0.07692308 0.09340659
#> 11   10 density 0.10439560 0.09658762 0.006160980 0.08489011 0.10439560
#> 12   11 density 0.09890110 0.09716599 0.003687024 0.09038462 0.10192308
#> 13   12 density 0.09890110 0.10815500 0.006616928 0.09587912 0.11538462
#> 14   13 density 0.15934066 0.16599190 0.008104048 0.15384615 0.17884615
#> 15   14 density 0.16483516 0.16367843 0.007894378 0.15384615 0.17884615
#> 16   15 density 0.05494505 0.05668016 0.004863881 0.04642857 0.06043956
#> 17   16 density 0.05494505 0.05349913 0.002485791 0.04945055 0.05494505
#> 18   17 density 0.04395604 0.04279931 0.002941227 0.03543956 0.04395604
#> 19   18 density 0.03846154 0.03759398 0.002058430 0.03296703 0.03846154
#> 20   19 density 0.04945055 0.04858300 0.002058430 0.04395604 0.04945055
#> 21   20 density 0.09340659 0.08906883 0.003919135 0.08241758 0.09340659
#> 22   21 density 0.03296703 0.03238866 0.002521052 0.02692308 0.03296703
#>             z    p p_adj     p_mcse n_ties n_null
#> 1  -0.2462348 1.00     1 0.00000000      8     19
#> 2   0.4682929 1.00     1 0.00000000     15     19
#> 3   0.8300574 1.00     1 0.00000000     11     19
#> 4   0.9538210 0.55     1 0.11124298      9     19
#> 5  -0.1202649 1.00     1 0.00000000      8     19
#> 6   1.3880134 0.30     1 0.10246951      4     19
#> 7   1.0574523 0.40     1 0.10954451      2     19
#> 8   1.0185394 0.55     1 0.11124298      7     19
#> 9  -0.4903558 0.85     1 0.07984360      8     19
#> 10  0.3338489 1.00     1 0.00000000      7     19
#> 11  1.2673279 0.40     1 0.10954451      4     19
#> 12  0.4705983 1.00     1 0.00000000     12     19
#> 13 -1.3985197 0.20     1 0.08944272      2     19
#> 14 -0.8207310 0.45     1 0.11124298      1     19
#> 15  0.1465268 1.00     1 0.00000000      4     19
#> 16 -0.3567330 1.00     1 0.00000000      6     19
#> 17  0.5816751 1.00     1 0.00000000     14     19
#> 18  0.3932841 1.00     1 0.00000000     16     19
#> 19  0.4214636 1.00     1 0.00000000     16     19
#> 20  0.4214636 1.00     1 0.00000000     16     19
#> 21  1.1068177 0.55     1 0.11124298      7     19
#> 22  0.2294157 1.00     1 0.00000000     18     19
as.data.frame(tested, what = "null")
#>     time measure replicate      value
#> 1      0 density         1 0.06043956
#> 2      1 density         1 0.04395604
#> 3      2 density         1 0.05494505
#> 4      3 density         1 0.06043956
#> 5      4 density         1 0.07692308
#> 6      5 density         1 0.08241758
#> 7      6 density         1 0.14835165
#> 8      7 density         1 0.10439560
#> 9      8 density         1 0.10989011
#> 10     9 density         1 0.08791209
#> 11    10 density         1 0.09890110
#> 12    11 density         1 0.09340659
#> 13    12 density         1 0.10439560
#> 14    13 density         1 0.15384615
#> 15    14 density         1 0.17032967
#> 16    15 density         1 0.06043956
#> 17    16 density         1 0.04945055
#> 18    17 density         1 0.04395604
#> 19    18 density         1 0.03846154
#> 20    19 density         1 0.04945055
#> 21    20 density         1 0.08791209
#> 22    21 density         1 0.03296703
#> 23     0 density         2 0.05494505
#> 24     1 density         2 0.04395604
#> 25     2 density         2 0.05494505
#> 26     3 density         2 0.06593407
#> 27     4 density         2 0.06593407
#> 28     5 density         2 0.07692308
#> 29     6 density         2 0.15384615
#> 30     7 density         2 0.10439560
#> 31     8 density         2 0.09890110
#> 32     9 density         2 0.08791209
#> 33    10 density         2 0.10439560
#> 34    11 density         2 0.09890110
#> 35    12 density         2 0.09890110
#> 36    13 density         2 0.16483516
#> 37    14 density         2 0.17582418
#> 38    15 density         2 0.06043956
#> 39    16 density         2 0.05494505
#> 40    17 density         2 0.04395604
#> 41    18 density         2 0.03846154
#> 42    19 density         2 0.04395604
#> 43    20 density         2 0.09340659
#> 44    21 density         2 0.03296703
#> 45     0 density         3 0.06043956
#> 46     1 density         3 0.04395604
#> 47     2 density         3 0.05494505
#> 48     3 density         3 0.06043956
#> 49     4 density         3 0.07692308
#> 50     5 density         3 0.08791209
#> 51     6 density         3 0.15384615
#> 52     7 density         3 0.08791209
#> 53     8 density         3 0.10989011
#> 54     9 density         3 0.08791209
#> 55    10 density         3 0.09890110
#> 56    11 density         3 0.09890110
#> 57    12 density         3 0.10439560
#> 58    13 density         3 0.17032967
#> 59    14 density         3 0.15384615
#> 60    15 density         3 0.04395604
#> 61    16 density         3 0.04945055
#> 62    17 density         3 0.03846154
#> 63    18 density         3 0.03846154
#> 64    19 density         3 0.04945055
#> 65    20 density         3 0.08791209
#> 66    21 density         3 0.03296703
#> 67     0 density         4 0.05494505
#> 68     1 density         4 0.03846154
#> 69     2 density         4 0.05494505
#> 70     3 density         4 0.06593407
#> 71     4 density         4 0.07142857
#> 72     5 density         4 0.08241758
#> 73     6 density         4 0.15934066
#> 74     7 density         4 0.09890110
#> 75     8 density         4 0.09340659
#> 76     9 density         4 0.08791209
#> 77    10 density         4 0.10439560
#> 78    11 density         4 0.09890110
#> 79    12 density         4 0.10989011
#> 80    13 density         4 0.16483516
#> 81    14 density         4 0.18131868
#> 82    15 density         4 0.04945055
#> 83    16 density         4 0.05494505
#> 84    17 density         4 0.04395604
#> 85    18 density         4 0.03846154
#> 86    19 density         4 0.04945055
#> 87    20 density         4 0.09340659
#> 88    21 density         4 0.03296703
#> 89     0 density         5 0.06043956
#> 90     1 density         5 0.04395604
#> 91     2 density         5 0.05494505
#> 92     3 density         5 0.06043956
#> 93     4 density         5 0.07692308
#> 94     5 density         5 0.08241758
#> 95     6 density         5 0.14835165
#> 96     7 density         5 0.09340659
#> 97     8 density         5 0.10439560
#> 98     9 density         5 0.09340659
#> 99    10 density         5 0.09890110
#> 100   11 density         5 0.09890110
#> 101   12 density         5 0.11538462
#> 102   13 density         5 0.15384615
#> 103   14 density         5 0.15384615
#> 104   15 density         5 0.06043956
#> 105   16 density         5 0.05494505
#> 106   17 density         5 0.04395604
#> 107   18 density         5 0.03296703
#> 108   19 density         5 0.04945055
#> 109   20 density         5 0.08791209
#> 110   21 density         5 0.03296703
#> 111    0 density         6 0.06043956
#> 112    1 density         6 0.04395604
#> 113    2 density         6 0.05494505
#> 114    3 density         6 0.06593407
#> 115    4 density         6 0.07692308
#> 116    5 density         6 0.07692308
#> 117    6 density         6 0.16483516
#> 118    7 density         6 0.09890110
#> 119    8 density         6 0.09890110
#> 120    9 density         6 0.08241758
#> 121   10 density         6 0.08241758
#> 122   11 density         6 0.09890110
#> 123   12 density         6 0.11538462
#> 124   13 density         6 0.17032967
#> 125   14 density         6 0.16483516
#> 126   15 density         6 0.06043956
#> 127   16 density         6 0.05494505
#> 128   17 density         6 0.04395604
#> 129   18 density         6 0.03296703
#> 130   19 density         6 0.04945055
#> 131   20 density         6 0.09340659
#> 132   21 density         6 0.03296703
#> 133    0 density         7 0.05494505
#> 134    1 density         7 0.04395604
#> 135    2 density         7 0.05494505
#> 136    3 density         7 0.06043956
#> 137    4 density         7 0.07142857
#> 138    5 density         7 0.08241758
#> 139    6 density         7 0.14285714
#> 140    7 density         7 0.09340659
#> 141    8 density         7 0.09340659
#> 142    9 density         7 0.09340659
#> 143   10 density         7 0.09340659
#> 144   11 density         7 0.08791209
#> 145   12 density         7 0.09890110
#> 146   13 density         7 0.17032967
#> 147   14 density         7 0.17032967
#> 148   15 density         7 0.06043956
#> 149   16 density         7 0.04945055
#> 150   17 density         7 0.04395604
#> 151   18 density         7 0.03846154
#> 152   19 density         7 0.04945055
#> 153   20 density         7 0.08791209
#> 154   21 density         7 0.03296703
#> 155    0 density         8 0.04945055
#> 156    1 density         8 0.04395604
#> 157    2 density         8 0.04945055
#> 158    3 density         8 0.06043956
#> 159    4 density         8 0.07142857
#> 160    5 density         8 0.07692308
#> 161    6 density         8 0.14285714
#> 162    7 density         8 0.09340659
#> 163    8 density         8 0.09890110
#> 164    9 density         8 0.08241758
#> 165   10 density         8 0.09890110
#> 166   11 density         8 0.09890110
#> 167   12 density         8 0.11538462
#> 168   13 density         8 0.18131868
#> 169   14 density         8 0.17032967
#> 170   15 density         8 0.06043956
#> 171   16 density         8 0.05494505
#> 172   17 density         8 0.04395604
#> 173   18 density         8 0.03846154
#> 174   19 density         8 0.04945055
#> 175   20 density         8 0.08791209
#> 176   21 density         8 0.03296703
#> 177    0 density         9 0.05494505
#> 178    1 density         9 0.03846154
#> 179    2 density         9 0.04945055
#> 180    3 density         9 0.05494505
#> 181    4 density         9 0.07142857
#> 182    5 density         9 0.07142857
#> 183    6 density         9 0.14835165
#> 184    7 density         9 0.10439560
#> 185    8 density         9 0.09890110
#> 186    9 density         9 0.08241758
#> 187   10 density         9 0.09890110
#> 188   11 density         9 0.09890110
#> 189   12 density         9 0.10439560
#> 190   13 density         9 0.16483516
#> 191   14 density         9 0.15934066
#> 192   15 density         9 0.06043956
#> 193   16 density         9 0.05494505
#> 194   17 density         9 0.04395604
#> 195   18 density         9 0.03846154
#> 196   19 density         9 0.04945055
#> 197   20 density         9 0.08241758
#> 198   21 density         9 0.02197802
#> 199    0 density        10 0.06043956
#> 200    1 density        10 0.04395604
#> 201    2 density        10 0.05494505
#> 202    3 density        10 0.06593407
#> 203    4 density        10 0.07692308
#> 204    5 density        10 0.08241758
#> 205    6 density        10 0.15384615
#> 206    7 density        10 0.10439560
#> 207    8 density        10 0.10439560
#> 208    9 density        10 0.09340659
#> 209   10 density        10 0.09340659
#> 210   11 density        10 0.09890110
#> 211   12 density        10 0.10989011
#> 212   13 density        10 0.15384615
#> 213   14 density        10 0.15934066
#> 214   15 density        10 0.05494505
#> 215   16 density        10 0.04945055
#> 216   17 density        10 0.03296703
#> 217   18 density        10 0.03296703
#> 218   19 density        10 0.04945055
#> 219   20 density        10 0.08241758
#> 220   21 density        10 0.03296703
#> 221    0 density        11 0.06043956
#> 222    1 density        11 0.04395604
#> 223    2 density        11 0.05494505
#> 224    3 density        11 0.06043956
#> 225    4 density        11 0.07142857
#> 226    5 density        11 0.08241758
#> 227    6 density        11 0.15384615
#> 228    7 density        11 0.10439560
#> 229    8 density        11 0.10989011
#> 230    9 density        11 0.08241758
#> 231   10 density        11 0.08791209
#> 232   11 density        11 0.09340659
#> 233   12 density        11 0.10989011
#> 234   13 density        11 0.16483516
#> 235   14 density        11 0.15934066
#> 236   15 density        11 0.06043956
#> 237   16 density        11 0.05494505
#> 238   17 density        11 0.04395604
#> 239   18 density        11 0.03846154
#> 240   19 density        11 0.04945055
#> 241   20 density        11 0.08791209
#> 242   21 density        11 0.03296703
#> 243    0 density        12 0.06043956
#> 244    1 density        12 0.04395604
#> 245    2 density        12 0.04945055
#> 246    3 density        12 0.06043956
#> 247    4 density        12 0.06593407
#> 248    5 density        12 0.08241758
#> 249    6 density        12 0.14285714
#> 250    7 density        12 0.09340659
#> 251    8 density        12 0.10989011
#> 252    9 density        12 0.07692308
#> 253   10 density        12 0.09890110
#> 254   11 density        12 0.09340659
#> 255   12 density        12 0.11538462
#> 256   13 density        12 0.17582418
#> 257   14 density        12 0.16483516
#> 258   15 density        12 0.05494505
#> 259   16 density        12 0.05494505
#> 260   17 density        12 0.04395604
#> 261   18 density        12 0.03846154
#> 262   19 density        12 0.04395604
#> 263   20 density        12 0.08791209
#> 264   21 density        12 0.03296703
#> 265    0 density        13 0.04395604
#> 266    1 density        13 0.04395604
#> 267    2 density        13 0.05494505
#> 268    3 density        13 0.06043956
#> 269    4 density        13 0.06043956
#> 270    5 density        13 0.08241758
#> 271    6 density        13 0.14835165
#> 272    7 density        13 0.08791209
#> 273    8 density        13 0.09890110
#> 274    9 density        13 0.07692308
#> 275   10 density        13 0.09340659
#> 276   11 density        13 0.09890110
#> 277   12 density        13 0.10989011
#> 278   13 density        13 0.15934066
#> 279   14 density        13 0.15384615
#> 280   15 density        13 0.04945055
#> 281   16 density        13 0.05494505
#> 282   17 density        13 0.04395604
#> 283   18 density        13 0.03846154
#> 284   19 density        13 0.04945055
#> 285   20 density        13 0.08241758
#> 286   21 density        13 0.03296703
#> 287    0 density        14 0.06043956
#> 288    1 density        14 0.04395604
#> 289    2 density        14 0.04945055
#> 290    3 density        14 0.06593407
#> 291    4 density        14 0.07142857
#> 292    5 density        14 0.07692308
#> 293    6 density        14 0.15934066
#> 294    7 density        14 0.09340659
#> 295    8 density        14 0.09340659
#> 296    9 density        14 0.08791209
#> 297   10 density        14 0.09890110
#> 298   11 density        14 0.09890110
#> 299   12 density        14 0.11538462
#> 300   13 density        14 0.17032967
#> 301   14 density        14 0.16483516
#> 302   15 density        14 0.05494505
#> 303   16 density        14 0.05494505
#> 304   17 density        14 0.04395604
#> 305   18 density        14 0.03846154
#> 306   19 density        14 0.04945055
#> 307   20 density        14 0.09340659
#> 308   21 density        14 0.03296703
#> 309    0 density        15 0.05494505
#> 310    1 density        15 0.03846154
#> 311    2 density        15 0.05494505
#> 312    3 density        15 0.06593407
#> 313    4 density        15 0.06593407
#> 314    5 density        15 0.08791209
#> 315    6 density        15 0.14835165
#> 316    7 density        15 0.09890110
#> 317    8 density        15 0.10989011
#> 318    9 density        15 0.08791209
#> 319   10 density        15 0.10439560
#> 320   11 density        15 0.09890110
#> 321   12 density        15 0.10989011
#> 322   13 density        15 0.16483516
#> 323   14 density        15 0.15934066
#> 324   15 density        15 0.05494505
#> 325   16 density        15 0.05494505
#> 326   17 density        15 0.04395604
#> 327   18 density        15 0.03846154
#> 328   19 density        15 0.04395604
#> 329   20 density        15 0.08791209
#> 330   21 density        15 0.03296703
#> 331    0 density        16 0.04945055
#> 332    1 density        16 0.04395604
#> 333    2 density        16 0.04945055
#> 334    3 density        16 0.06593407
#> 335    4 density        16 0.07692308
#> 336    5 density        16 0.08241758
#> 337    6 density        16 0.15384615
#> 338    7 density        16 0.10439560
#> 339    8 density        16 0.09890110
#> 340    9 density        16 0.08241758
#> 341   10 density        16 0.09340659
#> 342   11 density        16 0.10439560
#> 343   12 density        16 0.10439560
#> 344   13 density        16 0.17032967
#> 345   14 density        16 0.16483516
#> 346   15 density        16 0.06043956
#> 347   16 density        16 0.04945055
#> 348   17 density        16 0.03846154
#> 349   18 density        16 0.03846154
#> 350   19 density        16 0.04945055
#> 351   20 density        16 0.09340659
#> 352   21 density        16 0.03296703
#> 353    0 density        17 0.05494505
#> 354    1 density        17 0.04395604
#> 355    2 density        17 0.04945055
#> 356    3 density        17 0.06043956
#> 357    4 density        17 0.07692308
#> 358    5 density        17 0.08791209
#> 359    6 density        17 0.16483516
#> 360    7 density        17 0.10439560
#> 361    8 density        17 0.10439560
#> 362    9 density        17 0.08791209
#> 363   10 density        17 0.10439560
#> 364   11 density        17 0.09340659
#> 365   12 density        17 0.11538462
#> 366   13 density        17 0.17032967
#> 367   14 density        17 0.15934066
#> 368   15 density        17 0.06043956
#> 369   16 density        17 0.05494505
#> 370   17 density        17 0.04395604
#> 371   18 density        17 0.03846154
#> 372   19 density        17 0.04945055
#> 373   20 density        17 0.09340659
#> 374   21 density        17 0.03296703
#> 375    0 density        18 0.05494505
#> 376    1 density        18 0.04395604
#> 377    2 density        18 0.04945055
#> 378    3 density        18 0.06593407
#> 379    4 density        18 0.07142857
#> 380    5 density        18 0.07692308
#> 381    6 density        18 0.15384615
#> 382    7 density        18 0.08241758
#> 383    8 density        18 0.09890110
#> 384    9 density        18 0.08241758
#> 385   10 density        18 0.09340659
#> 386   11 density        18 0.09340659
#> 387   12 density        18 0.10439560
#> 388   13 density        18 0.15384615
#> 389   14 density        18 0.17032967
#> 390   15 density        18 0.05494505
#> 391   16 density        18 0.05494505
#> 392   17 density        18 0.04395604
#> 393   18 density        18 0.03846154
#> 394   19 density        18 0.04945055
#> 395   20 density        18 0.08791209
#> 396   21 density        18 0.03296703
#> 397    0 density        19 0.05494505
#> 398    1 density        19 0.03296703
#> 399    2 density        19 0.04945055
#> 400    3 density        19 0.06593407
#> 401    4 density        19 0.07142857
#> 402    5 density        19 0.08791209
#> 403    6 density        19 0.15384615
#> 404    7 density        19 0.09890110
#> 405    8 density        19 0.09890110
#> 406    9 density        19 0.09340659
#> 407   10 density        19 0.08791209
#> 408   11 density        19 0.09890110
#> 409   12 density        19 0.09340659
#> 410   13 density        19 0.17582418
#> 411   14 density        19 0.15384615
#> 412   15 density        19 0.05494505
#> 413   16 density        19 0.05494505
#> 414   17 density        19 0.04395604
#> 415   18 density        19 0.03846154
#> 416   19 density        19 0.04945055
#> 417   20 density        19 0.09340659
#> 418   21 density        19 0.03296703