resolve #507

Author: jGaboardi

docs/_static/references.bib

@@ -1,5 +1,5 @@
 @article{assunccao2006efficient,
-  title={Efficient Regionalization Techniques for Socio-economic Geographical Units Using Minimum Spanning Trees},
+  title={{Efficient Regionalization Techniques for Socio-economic Geographical Units Using Minimum Spanning Trees}},
   author={Assunção, RM and Neves, MC and Câmara, G and da Costa Freitas, C},
   journal={{International Journal of Geographical Information Science}},
   volume={20},
@@ -13,9 +13,9 @@ @article{assunccao2006efficient
 
 @article{calik_labbé_yaman_2015, 
   author={Calik, H and Labbé, M and Yaman, H},
-  title={p-Center Problems}, 
+  title={{p-Center Problems}}, 
   journal={Location Science},
-  pages={79–92},
+  pages={79--92},
   year={2015},
   doi={10.1007/978-3-319-13111-5_4},
 }
@@ -26,36 +26,41 @@ @article{chen_murray_jiang_2021
   title={Open-source approaches for location cover models: capabilities and efficiency},
   journal={Journal of Geographical Systems},
   doi={10.1007/s10109-021-00350-w},
-  year={2021}
+  year={2021},
+  pages={361--380},
+  volume={23},
+  number={3},
 }
 
 
 @book{Church2009,
-  address = {Hoboken},
-  author = {Church, Richard L. and Murray, Alan T.},
-  publisher = {John Wiley {\&} Sons, Inc.},
-  title = {{Business Site Selection, Locational Analysis, and GIS}},
-  year = {2009}
+  address={Hoboken},
+  author={Church, Richard L. and Murray, Alan T.},
+  publisher={John Wiley {\&} Sons, Inc.},
+  title={{Business Site Selection, Locational Analysis, and GIS}},
+  year={2009},
+  doi={10.1002/9780470432761},
 }
 
 
 @article{church_2018,
-  author = {Richard L. Church},
-  title ={Tobler's Law and Spatial Optimization: Why Bakersfield?},
-  journal = {International Regional Science Review},
-  volume = {41},
-  number = {3},
-  pages = {287-310},
-  year = {2018},
-  doi = {10.1177/0160017616650612}
+  author={Richard L. Church},
+  title={{Tobler's Law and Spatial Optimization: Why Bakersfield?}},
+  journal={International Regional Science Review},
+  volume={41},
+  number={3},
+  pages={287--310},
+  year={2018},
+  doi={10.1177/0160017616650612},
 }
 
 
 @book{church_murray_2018, 
   author={Church, RL and Murray, AT},
-  title={Location covering models: history, applications and advancements}, 
+  title={{Location Covering Models: History, Applications and Advancements}}, 
   publisher={Springer},
   year={2018},
+  doi={10.1007/978-3-319-99846-6},
 }
 
 
@@ -68,30 +73,33 @@ @article{current1988capacitated
   pages={153--163},
   year={1988},
   publisher={SAGE Publications Sage UK: London, England},
-  doi={10.1068/b150153}
-  
+  doi={10.1068/b150153},
 }
 
 
 @article{daskin_stern_edmund_1981,
-author = {Daskin, MS and Stern, EH},
-title = {A Hierarchical Objective Set Covering Model for Emergency Medical Service Vehicle Deployment},
-journal = {Transportation Science},
-doi = {10.1287/trsc.15.2.137},
-year = {1981}
+  author={Daskin, MS and Stern, EH},
+  title={{A Hierarchical Objective Set Covering Model for Emergency Medical Service Vehicle Deployment}},
+  journal={Transportation Science},
+  doi={10.1287/trsc.15.2.137},
+  year={1981},
+  volume={15},
+  number={2},
+  pages={137--152},
 }
 
 
 @book{daskin_2013, 
   author={Daskin, MS},
-  title={Network and discrete location: models, algorithms, and applications}, 
-  publisher={John Wiley & Sons, Inc.}, 
+  title={{Network and Discrete Location: Models, Algorithms, and Applications}}, 
+  publisher={John Wiley \& Sons, Inc.}, 
   year={2013},
+  doi={10.1002/9781118537015},
 }
 
 
 @article{duque2011p,
-  title={The p-Regions Problem},
+  title={{The p-Regions Problem}},
   author={Duque, JC and Church, RL and Middleton, RS},
   journal={Geographical Analysis},
   volume={43},
@@ -105,70 +113,79 @@ @article{duque2011p
 
 @article{duque2012max,
   author={Duque, JC and Anselin, L and Rey, SJ},
-  title={THE MAX-P-REGIONS PROBLEM*},
+  title={{THE MAX-P-REGIONS PROBLEM*}},
   journal={Journal of Regional Science},
   volume={52},
   number={3},
   pages={397--419},
   doi={10.1111/j.1467-9787.2011.00743.x},
-  year={2012}
+  year={2012},
 }
 
 
 @article{hakimi_1964, 
   author={Hakimi, SL},
-  title={Optimum Locations of Switching Centers and the Absolute Centers and Medians of a Graph}, 
+  title={{Optimum Locations of Switching Centers and the Absolute Centers and Medians of a Graph}}, 
   journal={Operations Research},
   volume={12}, 
   number={3},
-  pages={450–459},
+  pages={450--459},
   year={1964},
   doi={10.1287/opre.12.3.450},
 }
 
+
 @article{hakimi_1965, 
   author={Hakimi, SL},
-  title={Optimum Distribution of Switching Centers in a Communication Network and Some Related Graph Theoretic Problems}, 
+  title={{Optimum Distribution of Switching Centers in a Communication Network and Some Related Graph Theoretic Problems}}, 
   journal={Operations Research},
   number={3},
   volume={13},
-  pages={462–475},
+  pages={462--475},
   year={1965},
   doi={10.1287/opre.13.3.462},
 }
 
 
 @article{kuby_1987,
-author = {Kuby, MJ},
-title = {Programming Models for Facility Dispersion: The p-Dispersion and Maxisum Dispersion Problems},
-journal = {Geographical Analysis},
-doi = {10.1111/j.1538-4632.1987.tb00133.x},
-year = {1987}
+  author={Kuby, MJ},
+  title={{Programming Models for Facility Dispersion: The p-Dispersion and Maxisum Dispersion Problems}},
+  journal={Geographical Analysis},
+  doi={10.1111/j.1538-4632.1987.tb00133.x},
+  year={1987},
+  volume={19},
+  number={4},
+  pages={315--329},
 }
 
 
 @article{MALISZEWSKI2012331,
-author = {Maliszewski, PJ and Kuby, MJ and Horner, MW},
-title = {A comparison of multi-objective spatial dispersion models for managing critical assets in urban areas},
-journal = {Computers, Environment and Urban Systems},
-doi = {10.1016/j.compenvurbsys.2011.12.006},
-year = {2012}
+  author={Maliszewski, PJ and Kuby, MJ and Horner, MW},
+  title={A comparison of multi-objective spatial dispersion models for managing critical assets in urban areas},
+  journal={Computers, Environment and Urban Systems},
+  doi={10.1016/j.compenvurbsys.2011.12.006},
+  year={2012},
+  volume={36},
+  number={4},
+  pages={331--341},
 }
 
 
 @article{openshaw1977geographical,
-  title={A Geographical Solution to Scale and Aggregation Problems in Region-building, Partitioning and Spatial Modelling},
+  title={{A Geographical Solution to Scale and Aggregation Problems in Region-building, Partitioning and Spatial Modelling}},
   author={Openshaw, S},
   journal={Transactions of the Institute of British Geographers},
   pages={459--472},
   year={1977},
+  volume={2},
+  number={4},
   publisher={JSTOR},
-  doi={doi.org/10.2307/622300},
+  doi={10.2307/622300},
 }
 
 
 @article{openshaw1995algorithms,
-  title={Algorithms for Reengineering 1991 Census Geography},
+  title={{Algorithms for Reengineering 1991 Census Geography}},
   author={Openshaw, S and Rao, L},
   journal={Environment and Planning A},
   volume={27},
@@ -194,11 +211,11 @@ @article{shi_malik_2000
 
 @article{toregas_swain_revelle_bergman_1971, 
   author={Toregas, Constantine and Swain, Ralph and Revelle, Charles and Bergman, Lawrence},
-  title={The Location of Emergency Service Facilities}, 
-  volume={19}, 
+  title={{The Location of Emergency Service Facilities}}, 
   journal={Operations Research}, 
-  number={6},
-  pages={1363–1373},
+  volume = {19},
+  number = {6},
+  pages={1363--1373},
   year={1971}, 
   doi={10.1287/opre.19.6.1363},
 }
@@ -218,11 +235,13 @@ @article{von2007tutorial
 
 
 @article{wei2020efficient,
-  title={Efficient Regionalization for Spatially Explicit Neighborhood Delineation},
+  title={Efficient regionalization for spatially explicit neighborhood delineation},
   author={Wei, R and Rey, SJ and Knaap, E},
   journal={International Journal of Geographical Information Science},
-  pages={1--17},
-  year={2020},
+   year={2020},
+  volume={35},
+  number={1},
+  pages={135--151},
   publisher={Taylor \& Francis},
   doi={10.1080/13658816.2020.1759806},
 }
@@ -240,22 +259,56 @@ @article{wolf2021
   author={Wolf, LJ},
   title={Spatially–encouraged spectral clustering: a technique for blending map typologies and regionalization},
   journal={International Journal of Geographical Information Science},
-  volume={0},
-  number={0},
-  pages={1-18},
+  volume={35},
+  number={11},
+  pages={2356--2373},
   year={2021},
   doi={10.1080/13658816.2021.1934475},
 }
 
 
 @inproceedings{yu_shi_2003,
   author={Yu, Stella X. and Shi, Jianbo},
-  booktitle={Proceedings Ninth IEEE International Conference on Computer Vision}, 
+  booktitle={{Proceedings Ninth IEEE International Conference on Computer Vision}}, 
   title={Multiclass spectral clustering}, 
   year={2003},
   volume={1},
-  pages={313-319},
+  pages={313--319},
   doi={10.1109/ICCV.2003.1238361}}
 
 
+@article{upchurch-kuby-lim-2009,
+    author={Upchurch, Christopher and Kuby, Michael and Lim, Seow},
+    title={{A Model for Location of Capacitated Alternative-Fuel Stations}},
+    journal={Geographical Analysis},
+    volume={41},
+    number={1},
+    pages={85--106},
+    doi={10.1111/j.1538-4632.2009.00744.x},
+    year={2009}
+}
+
+
+@article{hong-kuby-2016,
+  title={A threshold covering flow-based location model to build a critical mass of alternative-fuel stations},
+  journal={Journal of Transport Geography},
+  volume={56},
+  pages={128--137},
+  year={2016},
+  doi={10.1016/j.jtrangeo.2016.08.019},
+  author={Shuyao Hong and Michael Kuby},
+}
+
+
+@article{KUBY2005125,
+  title={The flow-refueling location problem for alternative-fuel vehicles},
+  journal={Socio-Economic Planning Sciences},
+  volume={39},
+  number={2},
+  pages={125--145},
+  year={2005},
+  doi={10.1016/j.seps.2004.03.001},
+  author={Michael Kuby and Seow Lim},
+}
+
 %======

docs/api.rst

@@ -40,3 +40,4 @@ Exact solution approaches to facility location modeling problems.
     locate.KNearestPMedian
     locate.PCenter
     locate.PDispersion
+    locate.FRLM

docs/tutorials.rst

@@ -31,3 +31,4 @@ Tutorials
     notebooks/facloc-real-world.ipynb
     notebooks/facloc-lscpb-real-world.ipynb
     notebooks/facloc-disperse-real-world.ipynb
+    notebooks/flow.ipynb

notebooks/flow.ipynb

@@ -892,9 +892,9 @@
     "$\\begin{array}{ll}\n",
     "\\textbf{Max } & Z = \\sum_{q \\in Q} \\sum_{\\substack{ h| b_{qh} = 1}} f_q y_{qh}   \\\\[0.5em]\n",
     "\\textbf{Subject to:}  &  \\sum_{q \\in Q} \\sum_{\\substack{h| b_{qh} = 1}} e_q g_{qhk} f_q y_{qh} \\leq c x_k \\quad \\forall k \\in K   \\\\[0.5em]\n",
-    " &  \\sum_{k \\in K} x_k = p   \\\\[0.5em]\n",
-    " &  \\sum_{\\substack{h|b_{qh} = 1}} y_{qh} \\leq 1 \\quad \\forall q \\in Q  \\\\[0.5em]\n",
-    " &  y_{qh} \\geq 0 \\quad \\forall q \\in Q, h \\in H \n",
+    "&  \\sum_{k \\in K} x_k = p   \\\\[0.5em]\n",
+    "&  \\sum_{\\substack{h|b_{qh} = 1}} y_{qh} \\leq 1 \\quad \\forall q \\in Q  \\\\[0.5em]\n",
+    "&  y_{qh} \\geq 0 \\quad \\forall q \\in Q, h \\in H \n",
     "\\\\[0.5em] \\end{array}$\n",
     "\n",
     "$\\begin{array}{ll}\n",
@@ -912,7 +912,7 @@
     "b_{qh} & \\text{1 if combination } h \\text{ can refuel OD pair } q  \\text{, 0 otherwise} \\\\\n",
     "e_q & \\text{Average fraction of round trips for OD pair } q \\text{ that require refueling} \\\\\n",
     "g_{qhk} & \\text{Average number of times a vehicle traveling on path } q \\text{ and being refueled by combination} h \\text{ stops at station } k \\text{ on each round trip that requires refueling} \\\\\n",
-    "\\\\ \\end{array}$"
+    "\\\\ \\end{array}$\n"
    ]
   },
   {
@@ -1277,7 +1277,7 @@
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "Python 3",
+   "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
   },
@@ -1291,7 +1291,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.9"
+   "version": "3.14.3"
   }
  },
  "nbformat": 4,