huff 1.2.0__py3-none-any.whl → 1.3.1__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (12) hide show
  1. huff/gistools.py +123 -3
  2. huff/models.py +134 -30
  3. huff/ors.py +23 -18
  4. huff/osm.py +250 -0
  5. huff/tests/data/Haslach.qmd +43 -43
  6. huff/tests/data/Haslach_supermarkets.qmd +43 -43
  7. huff/tests/tests_huff.py +126 -19
  8. huff-1.3.1.dist-info/METADATA +78 -0
  9. {huff-1.2.0.dist-info → huff-1.3.1.dist-info}/RECORD +11 -10
  10. huff-1.2.0.dist-info/METADATA +0 -59
  11. {huff-1.2.0.dist-info → huff-1.3.1.dist-info}/WHEEL +0 -0
  12. {huff-1.2.0.dist-info → huff-1.3.1.dist-info}/top_level.txt +0 -0
huff-1.3.1.dist-info/METADATA ADDED
@@ -0,0 +1,78 @@
1
+ Metadata-Version: 2.1
2
+ Name: huff
3
+ Version: 1.3.1
4
+ Summary: huff: Huff Model Market Area Analysis
5
+ Author: Thomas Wieland
6
+ Author-email: geowieland@googlemail.com
7
+ Description-Content-Type: text/markdown
8
+ Requires-Dist: geopandas
9
+ Requires-Dist: pandas
10
+ Requires-Dist: numpy
11
+ Requires-Dist: statsmodels
12
+ Requires-Dist: shapely
13
+ Requires-Dist: requests
14
+ Requires-Dist: matplotlib
15
+ Requires-Dist: pillow
16
+ Requires-Dist: contextily
17
+ Requires-Dist: openpyxl
18
+
19
+ # huff: Huff Model Market Area Analysis
20
+
21
+ This Python library is designed for performing market area analyses with the Huff Model (Huff 1962, 1964) and/or the Multiplicative Competitive Interaction (MCI) Model (Nakanishi and Cooper 1974, 1982). Users may load point shapefiles (or CSV, XLSX) of customer origins and supply locations and conduct a market area analysis step by step. The package also includes supplementary GIS functions, including clients for OpenRouteService(1) for network analysis (e.g., transport cost matrix) and OpenStreetMap(2) for simple maps. See Huff and McCallum (2008) or Wieland (2017) for a description of the models and their practical application.
22
+
23
+
24
+ ## Author
25
+
26
+ Thomas Wieland [ORCID](https://orcid.org/0000-0001-5168-9846) [EMail](mailto:geowieland@googlemail.com)
27
+
28
+ See the /tests directory for usage examples of most of the included functions.
29
+
30
+
31
+ ## Features
32
+
33
+ - **Huff Model**:
34
+ - Defining origins and destinations with weightings
35
+ - Creating interaction matrix from origins and destinations
36
+ - Market simulation with basic Huff Model
37
+ - **Multiplicative Competitive Interaction Model**:
38
+ - Log-centering transformation of interaction matrix
39
+ - Fitting MCI model with >= 2 independent variables
40
+ - MCI model market simulation
41
+ - **GIS tools**:
42
+ - OpenRouteService(1) Client:
43
+ - Creating transport costs matrix from origins and destinations
44
+ - Creating isochrones from origins and destinations
45
+ - OpenStreetMap(2) Client:
46
+ - Creating simple maps with OSM basemap
47
+ - Other GIS tools:
48
+ - Creating buffers from geodata
49
+ - Spatial join with with statistics
50
+ - Creating euclidean distance matrix from origins and destinations
51
+ - Overlay-difference analysis of polygons
52
+ - **Data management tools**:
53
+ - Loading own interaction matrix for analysis
54
+ - Creating origins/destinations objects from point geodata
55
+
56
+ (1) © openrouteservice.org by HeiGIT | Map data © OpenStreetMap contributors | https://openrouteservice.org/
57
+
58
+ (2) © OpenStreetMap contributors | available under the Open Database License | https://www.openstreetmap.org/
59
+
60
+
61
+ ## Literature
62
+ - Huff DL (1962) *Determination of Intra-Urban Retail Trade Areas*.
63
+ - Huff DL (1964) Defining and estimating a trading area. *Journal of Marketing* 28(4): 34–38. [10.2307/1249154](https://doi.org/10.2307/1249154)
64
+ - Huff DL, McCallum BM (2008) Calibrating the Huff Model using ArcGIS Business Analyst. ESRI White Paper, September 2008. https://www.esri.com/library/whitepapers/pdfs/calibrating-huff-model.pdf.
65
+ - De Beule M, Van den Poel D, Van de Weghe N (2014) An extended Huff-model for robustly benchmarking and predicting retail network performance. *Applied Geography* 46(1): 80–89. [10.1016/j.apgeog.2013.09.026](https://doi.org/10.1016/j.apgeog.2013.09.026)
66
+ - Nakanishi M, Cooper LG (1974) Parameter estimation for a Multiplicative Competitive Interaction Model: Least squares approach. *Journal of Marketing Research* 11(3): 303–311. [10.2307/3151146](https://doi.org/10.2307/3151146).
67
+ - Nakanishi M, Cooper LG (1982) Technical Note — Simplified Estimation Procedures for MCI Models. *Marketing Science* 1(3): 314-322. [10.1287/mksc.1.3.314](https://doi.org/10.1287/mksc.1.3.314)
68
+ - Wieland T (2017) Market Area Analysis for Retail and Service Locations with MCI. *R Journal* 9(1): 298-323. [10.32614/RJ-2017-020](https://doi.org/10.32614/RJ-2017-020)
69
+ - Wieland T (2018) A Hurdle Model Approach of Store Choice and Market Area Analysis in Grocery Retailing. *Papers in Applied Geography* 4(4): 370-389. [10.1080/23754931.2018.1519458](https://doi.org/10.1080/23754931.2018.1519458)
70
+ - Wieland T (2023) Spatial shopping behavior during the Corona pandemic: insights from a micro-econometric store choice model for consumer electronics and furniture retailing in Germany. *Journal of Geographical Systems* 25(2): 291–326. [10.1007/s10109-023-00408-x](https://doi.org/10.1007/s10109-023-00408-x)
71
+
72
+
73
+ ## Installation
74
+
75
+ To install the package, use `pip`:
76
+
77
+ ```bash
78
+ pip install huff
{huff-1.2.0.dist-info → huff-1.3.1.dist-info}/RECORD RENAMED
@@ -1,23 +1,24 @@
1
1
  huff/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
2
- huff/gistools.py,sha256=hfTP8zEQwlPMp505IgEl9uT5nJczBABxVsQ5MVE8fIU,2721
3
- huff/models.py,sha256=ilDSe9jdpOz75GJ3m8fKl2JOUpIOXv1pM2HVgj5_TTs,57180
4
- huff/ors.py,sha256=fyh-82nddvwCVpn1nZ3J0pZa6VrshUDeZSxm0aXvSiI,11467
2
+ huff/gistools.py,sha256=LfMhalPk6rNTQSfT1U9UyJgZP1OWdlnv1MSDfP_c0Ik,6857
3
+ huff/models.py,sha256=xpXBM1rTF_HxW5c7-EELs3-sMXBcYo7-X2kSjKbe12k,60856
4
+ huff/ors.py,sha256=DmzeSYgYekXNposD7PH3Sgw8Jpw3KePYeO8DZMKMhl0,11929
5
+ huff/osm.py,sha256=zYAB3EhijfSl1H5bsGxYnPMd-8t_MDKKXTlzA1XWQ5U,6858
5
6
  huff/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
6
- huff/tests/tests_huff.py,sha256=hsB81I9aJGuBT-NHYrV62U6UB6lWAV13WbOM3tSRvu4,4039
7
+ huff/tests/tests_huff.py,sha256=7C1sIzHVNBD8kv7DJkrUERuxDnNDJUpmqzA1KozQbtk,7207
7
8
  huff/tests/data/Haslach.cpg,sha256=OtMDH1UDpEBK-CUmLugjLMBNTqZoPULF3QovKiesmCQ,5
8
9
  huff/tests/data/Haslach.dbf,sha256=GVPIt05OzDO7UrRDcsMhiYWvyXAPg6Z-qkiysFzj-fc,506
9
10
  huff/tests/data/Haslach.prj,sha256=2Jy1Vlzh7UxQ1MXpZ9UYLs2SxfrObj2xkEkZyLqmGTY,437
10
- huff/tests/data/Haslach.qmd,sha256=j9i4_Pz7ZMSG2UDSb3nuhJpw0KWXIRhiiDymqJP6_Fo,2479
11
+ huff/tests/data/Haslach.qmd,sha256=JlcOYzG4vI1NH1IuOpxwIPnJsCyC-pDRAI00TzEvNf0,2522
11
12
  huff/tests/data/Haslach.shp,sha256=s7ks-ukOIKMJCD5x6m0MO6pwkg1USvhudQKTg74ib1E,212
12
13
  huff/tests/data/Haslach.shx,sha256=VEMghRPP_HUYIuGoxR7X0eHQe9LnO4s8JP4twfzKyyk,132
13
14
  huff/tests/data/Haslach_supermarkets.cpg,sha256=OtMDH1UDpEBK-CUmLugjLMBNTqZoPULF3QovKiesmCQ,5
14
15
  huff/tests/data/Haslach_supermarkets.dbf,sha256=4fTBxntDvQ8qFPdGK82ywJd2Xq_9nApDyi3h5_KPFSc,21282
15
16
  huff/tests/data/Haslach_supermarkets.prj,sha256=2Jy1Vlzh7UxQ1MXpZ9UYLs2SxfrObj2xkEkZyLqmGTY,437
16
- huff/tests/data/Haslach_supermarkets.qmd,sha256=j9i4_Pz7ZMSG2UDSb3nuhJpw0KWXIRhiiDymqJP6_Fo,2479
17
+ huff/tests/data/Haslach_supermarkets.qmd,sha256=JlcOYzG4vI1NH1IuOpxwIPnJsCyC-pDRAI00TzEvNf0,2522
17
18
  huff/tests/data/Haslach_supermarkets.shp,sha256=X7QbQ0BTMag_B-bDRbpr-go2BQIXo3Y8zMAKpYZmlps,324
18
19
  huff/tests/data/Haslach_supermarkets.shx,sha256=j23QHX-SmdAeN04rw0x8nUOran-OCg_T6r_LvzzEPWs,164
19
20
  huff/tests/data/Wieland2015.xlsx,sha256=SaVM-Hi5dBTmf2bzszMnZ2Ec8NUE05S_5F2lQj0ayS0,19641
20
- huff-1.2.0.dist-info/METADATA,sha256=U79cQVxYruPuRBCeQ8sZ9Xysf3sTnOJY8WtZt4qxL6k,2793
21
- huff-1.2.0.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
22
- huff-1.2.0.dist-info/top_level.txt,sha256=nlzX-PxZNFmIxANIJMySuIFPihd6qOBkRlhIC28NEsQ,5
23
- huff-1.2.0.dist-info/RECORD,,
21
+ huff-1.3.1.dist-info/METADATA,sha256=cTxd7O_4ey6N3X-dgVrLhIgiPdJiucQqaSKcGlIfyzw,4530
22
+ huff-1.3.1.dist-info/WHEEL,sha256=tZoeGjtWxWRfdplE7E3d45VPlLNQnvbKiYnx7gwAy8A,92
23
+ huff-1.3.1.dist-info/top_level.txt,sha256=nlzX-PxZNFmIxANIJMySuIFPihd6qOBkRlhIC28NEsQ,5
24
+ huff-1.3.1.dist-info/RECORD,,
huff-1.2.0.dist-info/METADATA DELETED
@@ -1,59 +0,0 @@
1
- Metadata-Version: 2.1
2
- Name: huff
3
- Version: 1.2.0
4
- Summary: huff: Huff Model Market Area Analysis
5
- Author: Thomas Wieland
6
- Author-email: geowieland@googlemail.com
7
- Description-Content-Type: text/markdown
8
- Requires-Dist: geopandas
9
- Requires-Dist: pandas
10
- Requires-Dist: numpy
11
- Requires-Dist: time
12
- Requires-Dist: statsmodels
13
- Requires-Dist: shapely
14
- Requires-Dist: request
15
-
16
- # huff: Huff Model Market Area Analysis
17
-
18
- ## Author
19
-
20
- Thomas Wieland [ORCID](https://orcid.org/0000-0001-5168-9846) [EMail](mailto:geowieland@googlemail.com)
21
-
22
- See the /tests directory for usage examples of most of the included functions.
23
-
24
-
25
- ## Features
26
-
27
- - **Huff Model**:
28
- - Defining origins and destinations with weightings
29
- - Creating interaction matrix from origins and destinations
30
- - Calculating basic Huff Model
31
- - **Multiplicative Competitive Interaction Model**:
32
- - Log-centering transformation
33
- - Fitting MCI model with >= independent variables
34
- - **OpenRouteService Client** (1) (Tools via API):
35
- - Creating transport costs matrix from origins and destinations
36
- - Creating isochrones from destinations
37
- - **Tools**:
38
- - Loading own interaction matrix for analysis
39
- - GIS tools for preparing geodata
40
-
41
- (1) Attribution of OpenRouteService:
42
- © openrouteservice.org by HeiGIT | Map data © OpenStreetMap contributors | https://openrouteservice.org/
43
-
44
- ## Literature
45
- - Huff DL (1962) *Determination of Intra-Urban Retail Trade Areas*.
46
- - Huff DL (1964) Defining and estimating a trading area. *Journal of Marketing* 28(4): 34–38. [10.2307/1249154](https://doi.org/10.2307/1249154)
47
- - Huff DL, McCallum BM (2008) Calibrating the Huff Model using ArcGIS Business Analyst. ESRI White Paper, September 2008. https://www.esri.com/library/whitepapers/pdfs/calibrating-huff-model.pdf.
48
- - De Beule M, Van den Poel D, Van de Weghe N (2014) An extended Huff-model for robustly benchmarking and predicting retail network performance. *Applied Geography*,* 46(1): 80–89. [10.1016/j.apgeog.2013.09.026](https://doi.org/10.1016/j.apgeog.2013.09.026)
49
- - Nakanishi M, Cooper LG (1974) Parameter estimation for a Multiplicative Competitive Interaction Model: Least squares approach. *Journal of Marketing Research* 11(3): 303–311. [10.2307/3151146](https://doi.org/10.2307/3151146).
50
- - Wieland T (2017) Market Area Analysis for Retail and Service Locations with MCI. *R Journal* 9(1): 298-323. [10.32614/RJ-2017-020](https://doi.org/10.32614/RJ-2017-020)
51
- - Wieland T (2018) A Hurdle Model Approach of Store Choice and Market Area Analysis in Grocery Retailing. *Papers in Applied Geography* 4(4): 370-389. [10.1080/23754931.2018.1519458](https://doi.org/10.1080/23754931.2018.1519458)
52
-
53
-
54
- ## Installation
55
-
56
- To install the package, use `pip`:
57
-
58
- ```bash
59
- pip install huff
{huff-1.2.0.dist-info → huff-1.3.1.dist-info}/WHEEL RENAMED
File without changes