Merge pull request #295 from jorenham/mkdocs-bibtex

BibTex for references

.editorconfig

@@ -12,5 +12,5 @@ trim_trailing_whitespace = true
 max_line_length = 79
 
 # 2 space indentation
-[{*.json,*.jsonc,*.yaml,*.yml}]
+[{*.bib, *.json,*.jsonc,*.yaml,*.yml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - master
+      - dev
   pull_request:
   workflow_dispatch:
 
@@ -79,7 +80,15 @@ jobs:
     steps:
       - name: install scipy deps
         if: ${{ matrix.python-version == '3.13-dev' }}
-        run: sudo apt-get install libopenblas-dev
+        # run: sudo apt-get install libopenblas-dev
+        run: >
+          sudo apt-get install
+          gcc
+          g++
+          gfortran
+          libopenblas-dev
+          liblapack-dev
+          pkg-config
 
       - uses: actions/checkout@v4.1.7
 

docs/bib/refs.bib

@@ -0,0 +1,247 @@
+# Special functions
+@book{abramowitz1968,
+  title     = {Handbook of mathematical functions with formulas, graphs, and mathematical tables},
+  author    = {Abramowitz, Milton and Stegun, Irene A},
+  volume    = {55},
+  year      = {1964},
+  publisher = {US Government printing office},
+}
+
+# PWM's
+@article{greenwood1979,
+  title     = {Probability weighted moments: definition and relation to parameters of several distributions expressable in inverse form},
+  author    = {Greenwood, J Arthur and Landwehr, J Maciunas and Matalas, Nicolas C and Wallis, James R},
+  journal   = {Water resources research},
+  volume    = {15},
+  number    = {5},
+  pages     = {1049--1054},
+  year      = {1979},
+  publisher = {Wiley Online Library},
+}
+
+# Order Statistics
+@article{stigler1969,
+  title     = {Linear functions of order statistics},
+  author    = {Stigler, Stephen Mack},
+  journal   = {The Annals of Mathematical Statistics},
+  volume    = {40},
+  number    = {3},
+  pages     = {770--788},
+  year      = {1969},
+  publisher = {Institute of Mathematical Statistics},
+}
+@book{david2004,
+  title     = {Order statistics},
+  author    = {David, Herbert A and Nagaraja, Haikady N},
+  year      = {2004},
+  publisher = {John Wiley \& Sons},
+}
+
+# L-moments
+@article{hosking1990,
+  title     = {L-moments: analysis and estimation of distributions using linear combinations of order statistics},
+  author    = {Hosking, Jonathan RM},
+  journal   = {Journal of the Royal Statistical Society Series B: Statistical Methodology},
+  volume    = {52},
+  number    = {1},
+  pages     = {105--124},
+  year      = {1990},
+  publisher = {Oxford University Press},
+}
+@article{hosking2015,
+  title     = {A uniqueness result for L-estimators, with applications to L-moments},
+  author    = {Hosking, JRM and Balakrishnan, N},
+  journal   = {Statistical Methodology},
+  volume    = {24},
+  pages     = {69--80},
+  year      = {2015},
+  publisher = {Elsevier},
+}
+
+## LH-moments
+@article{wang1997,
+  title     = {LH moments for statistical analysis of extreme events},
+  author    = {Wang, Qi J},
+  journal   = {Water Resources Research},
+  volume    = {33},
+  number    = {12},
+  pages     = {2841--2848},
+  year      = {1997},
+  publisher = {Wiley Online Library},
+}
+
+## LL-moments
+@article{bayazit2002,
+  title     = {LL-moments for estimating low flow quantiles},
+  author    = {Bayazit, Mehmetcik and {\"O}n{\"o}z, Bihrat},
+  journal   = {Hydrological sciences journal},
+  volume    = {47},
+  number    = {5},
+  pages     = {707--720},
+  year      = {2002},
+  publisher = {Taylor \& Francis},
+}
+
+## TL-moments
+@article{elamir2003,
+  title     = {Trimmed L-moments},
+  author    = {Elamir, Elsayed AH and Seheult, Allan H},
+  journal   = {Computational Statistics \& Data Analysis},
+  volume    = {43},
+  number    = {3},
+  pages     = {299--314},
+  year      = {2003},
+  publisher = {Elsevier},
+}
+@article{hosking2007,
+  title     = {Some theory and practical uses of trimmed L-moments},
+  author    = {Hosking, JRM},
+  journal   = {Journal of Statistical Planning and Inference},
+  volume    = {137},
+  number    = {9},
+  pages     = {3024--3039},
+  year      = {2007},
+  publisher = {Elsevier},
+}
+
+## L-comoments
+@article{serfling2007,
+  title     = {A contribution to multivariate L-moments: L-comoment matrices},
+  author    = {Serfling, Robert and Xiao, Peng},
+  journal   = {Journal of Multivariate Analysis},
+  volume    = {98},
+  number    = {9},
+  pages     = {1765--1781},
+  year      = {2007},
+  publisher = {Elsevier},
+}
+@article{simkova2017,
+  title   = {Statistical Inference Based on L-Moments.},
+  author  = {{\v{S}}imkov{\'a}, Tereza},
+  journal = {Statistika: Statistics \& Economy Journal},
+  volume  = {97},
+  number  = {1},
+  year    = {2017},
+}
+
+## Parametric Inference
+@article{alvarez2022,
+  title   = {Inference in parametric models with many L-moments},
+  author  = {Alvarez, Luis and Chiann, Chang and Morettin, Pedro},
+  journal = {arXiv preprint arXiv:2210.04146},
+  year    = {2022},
+}
+
+
+# Probability Distributions
+
+## Gompertz
+@inproceedings{gompertz1833,
+  title        = {On the nature of the function expressive of the law of human mortality, and on a new mode of determining the value of life contingencies. In a letter to Francis Baily, Esq. FRS \&c. By Benjamin Gompertz, Esq. FR S},
+  author       = {Gompertz, Benjamin},
+  booktitle    = {Abstracts of the Papers Printed in the Philosophical Transactions of the Royal Society of London},
+  number       = {2},
+  pages        = {252--253},
+  year         = {1833},
+  organization = {The Royal Society London},
+}
+
+## Bernoulli
+@article{uspensky1937,
+  title     = {Introduction to mathematical probability},
+  author    = {Uspensky, James Victor},
+  year      = {1937},
+  publisher = {McGraw-Hill},
+  journal   = {},
+}
+
+# Burr
+@article{burr1942,
+  title     = {Cumulative frequency functions},
+  author    = {Burr, Irving W},
+  journal   = {The Annals of mathematical statistics},
+  volume    = {13},
+  number    = {2},
+  pages     = {215--232},
+  year      = {1942},
+  publisher = {JSTOR},
+}
+
+## GEV
+@article{jenkinson1955,
+  title     = {The frequency distribution of the annual maximum (or minimum) values of meteorological elements},
+  author    = {Jenkinson, Arthur F},
+  journal   = {Quarterly Journal of the Royal meteorological society},
+  volume    = {81},
+  number    = {348},
+  pages     = {158--171},
+  year      = {1955},
+  publisher = {Wiley},
+}
+
+# GLD
+@article{ramberg1974,
+  title     = {An approximate method for generating asymmetric random variables},
+  author    = {Ramberg, John S and Schmeiser, Bruce W},
+  journal   = {Communications of the ACM},
+  volume    = {17},
+  number    = {2},
+  pages     = {78--82},
+  year      = {1974},
+  publisher = {ACM New York, NY, USA},
+}
+
+# Wakeby
+@article{houghton1978,
+  title     = {Birth of a parent: The Wakeby distribution for modeling flood flows},
+  author    = {Houghton, John C},
+  journal   = {Water Resources Research},
+  volume    = {14},
+  number    = {6},
+  pages     = {1105--1109},
+  year      = {1978},
+  publisher = {Wiley Online Library},
+}
+
+# Kumaraswamy
+@article{kumaraswamy1980,
+  title     = {A generalized probability density function for double-bounded random processes},
+  author    = {Kumaraswamy, Ponnambalam},
+  journal   = {Journal of hydrology},
+  volume    = {46},
+  number    = {1-2},
+  pages     = {79--88},
+  year      = {1980},
+  publisher = {Elsevier},
+}
+@article{jones2009,
+  title     = {Kumaraswamy’s distribution: A beta-type distribution with some tractability advantages},
+  author    = {Jones, MC},
+  journal   = {Statistical methodology},
+  volume    = {6},
+  number    = {1},
+  pages     = {70--81},
+  year      = {2009},
+  publisher = {Elsevier},
+}
+
+## GLO
+@book{hosking1986,
+  title        = {The theory of probability weighted moments},
+  author       = {Hosking, Jonathan RM},
+  year         = {1986},
+  publisher    = {IBM Research Division, TJ Watson Research Center New York, USA},
+  url = {https://dominoweb.draco.res.ibm.com/reports/RC12210.pdf},
+}
+
+# GPD
+@article{hosking1987,
+  title     = {Parameter and quantile estimation for the generalized Pareto distribution},
+  author    = {Hosking, Jonathan RM and Wallis, James R},
+  journal   = {Technometrics},
+  volume    = {29},
+  number    = {3},
+  pages     = {339--349},
+  year      = {1987},
+  publisher = {Taylor \& Francis},
+}

docs/contributing.md

@@ -63,6 +63,10 @@ preview:
 poetry run mkdocs serve
 ```
 
+This will require `pandoc` and `pandoc-citeproc` to be installed on your
+system (e.g. using the conda-forge `pypandoc` package, on
+`apt-get install pandoc pandoc-citeproc` on Ubuntu).
+
 This will make the site available at `http://127.0.0.1:8000/`.
 It automatically reloads when changes are made to the source code or the
 documentation.