Alpha Calcualtions

[dgaylo]

Adds blobid.plic.get_alpha() to calculate

$$\alpha=\alpha(f,\vec{n})$$

and blobid.plic.get_void_fraction() to calculate

$$f=f(\alpha,\vec{n})$$

[github-actions]

Benchmark Results

--------------------------------------------------------------------------------- benchmark 'test_bench_Chan': 2 tests --------------------------------------------------------------------------------
Name (time in us)               Min                   Max                Mean             StdDev              Median                IQR            Outliers  OPS (Kops/s)            Rounds  Iterations
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
test_bench_Chan (head)     577.0100 (1.0)      1,067.8690 (1.06)     609.3472 (1.0)      31.0304 (1.37)     605.9840 (1.0)      19.0275 (1.01)        96;90        1.6411 (1.0)        1731           1
test_bench_Chan (base)     580.6150 (1.01)     1,004.5660 (1.0)      610.0288 (1.00)     22.5774 (1.0)      608.2170 (1.00)     18.8633 (1.0)        210;76        1.6393 (1.00)       1719           1
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

------------------------------------------------------------------------- benchmark 'test_bench_WY': 2 tests ------------------------------------------------------------------------
Name (time in ms)           Min               Max              Mean            StdDev            Median               IQR            Outliers       OPS            Rounds  Iterations
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
test_bench_WY (head)     3.4755 (1.0)      5.3596 (1.16)     3.5728 (1.0)      0.1592 (1.30)     3.5447 (1.0)      0.0463 (1.0)         13;31  279.8928 (1.0)         289           1
test_bench_WY (base)     3.5237 (1.01)     4.6222 (1.0)      3.6248 (1.01)     0.1221 (1.0)      3.5913 (1.01)     0.0878 (1.90)        24;17  275.8744 (0.99)        283           1
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

------------------------------------------------------------------------- benchmark 'test_bench_base': 2 tests ------------------------------------------------------------------------
Name (time in ms)             Min               Max              Mean            StdDev            Median               IQR            Outliers       OPS            Rounds  Iterations
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
test_bench_base (base)     1.9542 (1.0)      3.7938 (1.59)     2.0829 (1.04)     0.3419 (8.40)     1.9800 (1.0)      0.0259 (1.32)        36;75  480.0919 (0.96)        512           1
test_bench_base (head)     1.9649 (1.01)     2.3872 (1.0)      1.9997 (1.0)      0.0407 (1.0)      1.9888 (1.00)     0.0196 (1.0)         34;45  500.0860 (1.0)         507           1
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

--------------------------------------- benchmark 'test_bench_get_alpha': 1 tests ---------------------------------------
Name (time in ms)                   Min      Max     Mean  StdDev   Median     IQR  Outliers      OPS  Rounds  Iterations
-------------------------------------------------------------------------------------------------------------------------
test_bench_get_alpha (head)     58.4944  60.8292  58.9366  0.5221  58.8186  0.4682       1;1  16.9674      20           1
-------------------------------------------------------------------------------------------------------------------------

--------------------------------------- benchmark 'test_bench_get_void_fraction': 1 tests ---------------------------------------
Name (time in ms)                           Min      Max     Mean  StdDev   Median     IQR  Outliers      OPS  Rounds  Iterations
---------------------------------------------------------------------------------------------------------------------------------
test_bench_get_void_fraction (head)     33.0111  35.0089  33.4259  0.5985  33.1880  0.2135       4;5  29.9169      31           1
---------------------------------------------------------------------------------------------------------------------------------

------------------------------------------------------------------------------- benchmark 'test_bench_no_norm': 2 tests --------------------------------------------------------------------------------
Name (time in us)                  Min                 Max                Mean             StdDev              Median                IQR            Outliers  OPS (Kops/s)            Rounds  Iterations
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
test_bench_no_norm (base)     340.9770 (1.0)      740.6150 (1.07)     364.4827 (1.00)     30.1043 (1.02)     357.3780 (1.0)      19.6845 (1.0)       199;179        2.7436 (1.00)       2939           1
test_bench_no_norm (head)     342.1310 (1.00)     694.2810 (1.0)      364.3316 (1.0)      29.5434 (1.0)      358.8670 (1.00)     20.1825 (1.03)       112;86        2.7448 (1.0)        2932           1
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

Legend:
  Outliers: 1 Standard Deviation from Mean; 1.5 IQR (InterQuartile Range) from 1st Quartile and 3rd Quartile.
  OPS: Operations Per Second, computed as 1 / Mean

• base: 6a8a497
• head: 465ed9f