mapdata 2.8.0__tar.gz → 3.7.2__tar.gz

mapdata-3.7.2/PKG-INFO

@@ -0,0 +1,172 @@
+Metadata-Version: 2.1
+Name: mapdata
+Version: 3.7.2
+Summary: An interactive map and table explorer for geographic coordinates in a spreadsheet, CSV file, or database
+Home-page: https://osdn.net/project/mapdata/
+Author: Dreas Nielsen
+Author-email: cortice@tutanota.com
+License: GPL
+Keywords: Map,Locations,CRS,CSV,Spreadsheet,Database,PNG,JPG,Postscript
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: License :: OSI Approved :: GNU General Public License (GPL)
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Scientific/Engineering
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: tkintermapview
+Requires-Dist: pyproj
+Requires-Dist: jenkspy
+Requires-Dist: odfpy
+Requires-Dist: openpyxl
+Requires-Dist: xlrd
+Requires-Dist: matplotlib
+Requires-Dist: seaborn
+Requires-Dist: loess
+Requires-Dist: statsmodels
+Requires-Dist: scipy
+Requires-Dist: scikit-learn
+Requires-Dist: pymannkendall
+Requires-Dist: umap-learn
+Requires-Dist: pynndescent
+
+
+*mapdata.py* is a data explorer for data sets containing geographic coordinates.  Data can be read from a CSV file, spreadsheet, or database.  Both a map and a data
+table are displayed.  When a location is selected on the map, the same location is highlighted in the table, and *vice-versa*.  Single or multiple selections may be enabled.  Locations may also be selected and highlighted by writing a query expression to select rows of the data table.
+
+![example map](https://mapdata.readthedocs.io/en/latest/_images/UI_CSOs_1.png)
+
+In addition to visually browsing the map and table, the user can produce a number of different tabular, graphical, and statistical summaries of the data.  Most of these summaries can be applied either to the entire data set or to a selected subset of the data.
+
+Map coordinates should be in decimal degrees, in WGS84 (coordinate reference system [CRS] 4326), however, coordinates in other CRSs can be converted to 4326.
+
+The map display can be customized in several ways:
+
+  * Different raster tile servers may be used for the basemap.  The default is
+    OpenStreetMap.  Several alternatives are provided, and other tile servers
+    can be specified in a configuration file.
+
+  * Locations identified by coordinates in the data file may be designated by
+    different types of markers and by different colors.  The default marker for
+    locations, and the default marker used to flag selected locations can both be
+    customized.  Symbols and colors to use for location markers can be specified
+	in a configuration file and in the data file.  Different symbols and markers
+	can be used for different selected locations.
+
+  * Locations may be unlabeled or labeled with data values from the data file
+    The label font, size, color, and location can all be customized.
+
+  * When there is more than one data value (table row) at a location, the number
+    of rows can be annotated on the map adjacent to each location.  In addition,
+    data can be selected based on the number of data rows with the same
+    geographic  coordinates.
+
+The map can be exported to a Postscript, PNG, or JPEG file.  Using command-line options, *mapdata* can be directed to load a data file and display location markers and then to export the map to an image file, and quit.
+
+Selected rows in the data table can be exported to a CSV or spreadsheet file.
+
+*Mapdata* provides five different ways to show information about multiple data rows that all have the same geographic coordinates, and thus plot at the same location on the map.
+
+Data can also be displayed in several different types of plots: box plots, scatter
+plots, line charts, ECDF plots, Q-Q plots, Fisher-Jenks group plots, strip charts, 
+and counts of categorical and quantitative variables.  Plots
+can use either all data or only data values that are selected in the map and
+table.  Plots have a live connection to the data table and map, so when data selections are changed the plots are automatically updated.
+
+![example plot](https://mapdata.readthedocs.io/en/latest/_images/UI_cat_stripchart.png)
+
+*Mapdata* can also display summaries of univariate and bivariate statistics for selected variables.  These summaries can use either all data in the data table or only the data that are highlighted on the map.  These summaries are updated immediately if different data are selected.
+
+![Bivariate statistics](https://mapdata.readthedocs.io/en/latest/_images/Bivariate_dialog.png)
+
+In addition to univariate and bivariate statistics, and plots, *mapdata* can display the relationships between variables in the form of:
+
+  * A correlation matrix.
+
+  * A contingency table, using either categorical or numeric variables, with flexible
+    specification of groups.  Tests of independence, risk ratio, odds ratio and related
+    statistics, and conditional probabilities are all shown.
+
+  * A Receiver Operating Characteristics (ROC) curve and measures such as sensitivity and specificity for a selected value of the predictor variable.
+ 
+  * A scatter plot of the results of a *t*-Distributed Stochastic Neighbor Embedding (t-SNE) analysis of multiple variables.
+ 
+  * A scatter plot of the results of a Uniform Manifold Approximation and Projection (UMAP) analysis of multiple variables.
+
+![Correlation matrix](https://mapdata.readthedocs.io/en/latest/_images/UI_corr_matrix_example.png)
+
+SQL commands can be used when importing data from a database.  The SQL
+commands can be augmented with [execsql](https://pypi.org/project/execsql/)
+metacommands and substitution variables.
+
+Complete documentation is at [https://mapdata.readthedocs.io/en/latest](https://mapdata.readthedocs.io/en/latest).
+
+A configuration file template and additional bitmap symbols are included with the distribution of *mapdata.py*.
+
+
+## Dependencies
+
+*Mapdata.py* uses the following third-party Python libraries:
+
+  * [jenkspy](https://pypi.org/project/jenkspy/)
+
+  * [loess](https://pypi.org/project/loess/)
+
+  * [numpy](https://pypi.org/project/numpy/)
+
+  * [matplotlib](https://pypi.org/project/matplotlib/)
+
+  * [odfpy](https://pypi.org/project/odfpy/)
+ 
+  * [openpyxl](https://pypi.org/project/openpyxl/)
+
+  * [pillow](https://pypi.org/project/pillow/)
+ 
+  * [pymannkendall](https://pypi.org/project/pymannkendall/)
+
+  * [pynndescent](https://pypi.org/project/pynndescent/)
+ 
+  * [pyproj](https://pypi.org/project/pyproj/)
+ 
+  * [scikit-learn](https://pypi.org/project/scikit-learn/)
+
+  * [scipy](https://pypi.org/project/SciPy/)
+
+  * [seaborn](https://pypi.org/project/seaborn/)
+
+  * [statsmodels](https://pypi.org/project/statsmodels/)
+
+  * [tkintermapview](https://pypi.org/project/tkintermapview/)
+
+  * [umap-learn](https://pypi.org/project/umap-learn/)
+
+  * [xlrd](https://pypi.org/project/xlrd/)
+
+If *mapdata.py* is used to query a database to obtain a data set to view and
+explore, then one or more of the following Python libraries will have to be
+installed manually, depending on the type of DBMS used:
+
+   * PostgreSQL: [psycopg2](https://pypi.org/project/psycopg2/)
+
+   * MariaDB and MySQL: [pymysql](https://pypi.org/project/pymysql/)
+
+   * DuckDB: [duckdb](https://pypi.org/project/duckdb/)
+
+   * SQL Server: [pydobc](https://pypi.org/project/pyodbc/)
+
+   * Oracle: [cx-Oracle](https://pypi.org/project/cx-Oracle/)
+
+   * Firebird: [fdb](https://pypi.org/project/fdb/)
+
+
+[![Downloads](https://pepy.tech/badge/mapdata)](https://pypi.org/project/mapdata/)  

mapdata-3.7.2/README.md

@@ -0,0 +1,130 @@
+
+*mapdata.py* is a data explorer for data sets containing geographic coordinates.  Data can be read from a CSV file, spreadsheet, or database.  Both a map and a data
+table are displayed.  When a location is selected on the map, the same location is highlighted in the table, and *vice-versa*.  Single or multiple selections may be enabled.  Locations may also be selected and highlighted by writing a query expression to select rows of the data table.
+
+![example map](https://mapdata.readthedocs.io/en/latest/_images/UI_CSOs_1.png)
+
+In addition to visually browsing the map and table, the user can produce a number of different tabular, graphical, and statistical summaries of the data.  Most of these summaries can be applied either to the entire data set or to a selected subset of the data.
+
+Map coordinates should be in decimal degrees, in WGS84 (coordinate reference system [CRS] 4326), however, coordinates in other CRSs can be converted to 4326.
+
+The map display can be customized in several ways:
+
+  * Different raster tile servers may be used for the basemap.  The default is
+    OpenStreetMap.  Several alternatives are provided, and other tile servers
+    can be specified in a configuration file.
+
+  * Locations identified by coordinates in the data file may be designated by
+    different types of markers and by different colors.  The default marker for
+    locations, and the default marker used to flag selected locations can both be
+    customized.  Symbols and colors to use for location markers can be specified
+	in a configuration file and in the data file.  Different symbols and markers
+	can be used for different selected locations.
+
+  * Locations may be unlabeled or labeled with data values from the data file
+    The label font, size, color, and location can all be customized.
+
+  * When there is more than one data value (table row) at a location, the number
+    of rows can be annotated on the map adjacent to each location.  In addition,
+    data can be selected based on the number of data rows with the same
+    geographic  coordinates.
+
+The map can be exported to a Postscript, PNG, or JPEG file.  Using command-line options, *mapdata* can be directed to load a data file and display location markers and then to export the map to an image file, and quit.
+
+Selected rows in the data table can be exported to a CSV or spreadsheet file.
+
+*Mapdata* provides five different ways to show information about multiple data rows that all have the same geographic coordinates, and thus plot at the same location on the map.
+
+Data can also be displayed in several different types of plots: box plots, scatter
+plots, line charts, ECDF plots, Q-Q plots, Fisher-Jenks group plots, strip charts, 
+and counts of categorical and quantitative variables.  Plots
+can use either all data or only data values that are selected in the map and
+table.  Plots have a live connection to the data table and map, so when data selections are changed the plots are automatically updated.
+
+![example plot](https://mapdata.readthedocs.io/en/latest/_images/UI_cat_stripchart.png)
+
+*Mapdata* can also display summaries of univariate and bivariate statistics for selected variables.  These summaries can use either all data in the data table or only the data that are highlighted on the map.  These summaries are updated immediately if different data are selected.
+
+![Bivariate statistics](https://mapdata.readthedocs.io/en/latest/_images/Bivariate_dialog.png)
+
+In addition to univariate and bivariate statistics, and plots, *mapdata* can display the relationships between variables in the form of:
+
+  * A correlation matrix.
+
+  * A contingency table, using either categorical or numeric variables, with flexible
+    specification of groups.  Tests of independence, risk ratio, odds ratio and related
+    statistics, and conditional probabilities are all shown.
+
+  * A Receiver Operating Characteristics (ROC) curve and measures such as sensitivity and specificity for a selected value of the predictor variable.
+ 
+  * A scatter plot of the results of a *t*-Distributed Stochastic Neighbor Embedding (t-SNE) analysis of multiple variables.
+ 
+  * A scatter plot of the results of a Uniform Manifold Approximation and Projection (UMAP) analysis of multiple variables.
+
+![Correlation matrix](https://mapdata.readthedocs.io/en/latest/_images/UI_corr_matrix_example.png)
+
+SQL commands can be used when importing data from a database.  The SQL
+commands can be augmented with [execsql](https://pypi.org/project/execsql/)
+metacommands and substitution variables.
+
+Complete documentation is at [https://mapdata.readthedocs.io/en/latest](https://mapdata.readthedocs.io/en/latest).
+
+A configuration file template and additional bitmap symbols are included with the distribution of *mapdata.py*.
+
+
+## Dependencies
+
+*Mapdata.py* uses the following third-party Python libraries:
+
+  * [jenkspy](https://pypi.org/project/jenkspy/)
+
+  * [loess](https://pypi.org/project/loess/)
+
+  * [numpy](https://pypi.org/project/numpy/)
+
+  * [matplotlib](https://pypi.org/project/matplotlib/)
+
+  * [odfpy](https://pypi.org/project/odfpy/)
+ 
+  * [openpyxl](https://pypi.org/project/openpyxl/)
+
+  * [pillow](https://pypi.org/project/pillow/)
+ 
+  * [pymannkendall](https://pypi.org/project/pymannkendall/)
+
+  * [pynndescent](https://pypi.org/project/pynndescent/)
+ 
+  * [pyproj](https://pypi.org/project/pyproj/)
+ 
+  * [scikit-learn](https://pypi.org/project/scikit-learn/)
+
+  * [scipy](https://pypi.org/project/SciPy/)
+
+  * [seaborn](https://pypi.org/project/seaborn/)
+
+  * [statsmodels](https://pypi.org/project/statsmodels/)
+
+  * [tkintermapview](https://pypi.org/project/tkintermapview/)
+
+  * [umap-learn](https://pypi.org/project/umap-learn/)
+
+  * [xlrd](https://pypi.org/project/xlrd/)
+
+If *mapdata.py* is used to query a database to obtain a data set to view and
+explore, then one or more of the following Python libraries will have to be
+installed manually, depending on the type of DBMS used:
+
+   * PostgreSQL: [psycopg2](https://pypi.org/project/psycopg2/)
+
+   * MariaDB and MySQL: [pymysql](https://pypi.org/project/pymysql/)
+
+   * DuckDB: [duckdb](https://pypi.org/project/duckdb/)
+
+   * SQL Server: [pydobc](https://pypi.org/project/pyodbc/)
+
+   * Oracle: [cx-Oracle](https://pypi.org/project/cx-Oracle/)
+
+   * Firebird: [fdb](https://pypi.org/project/fdb/)
+
+
+[![Downloads](https://pepy.tech/badge/mapdata)](https://pypi.org/project/mapdata/)  

mapdata-3.7.2/mapdata/configfile/mapdata.conf

@@ -0,0 +1,204 @@
+# ======================================================================================
+#                 Configuration file for mapdata.py
+# For more information about the settings in this file, and how to use configuration
+# files, see the online documentation at https://mapdata.readthedocs.io/en/latest/ 
+# --------------------------------------------------------------------------------------
+
+[basemap_tile_servers]
+# This section contains names and URLs for alternate basemap layers.
+# If the URL includes <API_KEY>, there must be a corresponding entry in the "api_keys" section.
+Stamen terrain=https://tiles.stadiamaps.com/tiles/stamen_terrain/{z}/{x}/{y}.png?api_key=<API_KEY>
+Stamen toner=https://tiles.stadiamaps.com/tiles/stamen_toner/{z}/{x}/{y}.png?api_key=<API_KEY>
+Stamen toner lite=https://tiles.stadiamaps.com/tiles/stamen_toner_lite/{z}/{x}/{y}.png?api_key=<API_KEY>
+Stamen toner background=https://tiles.stadiamaps.com/tiles/stamen_toner_background/{z}/{x}/{y}.png?api_key=<API_KEY>
+Stadia outdoors=https://tiles.stadiamaps.com/tiles/outdoors/{z}/{x}/{y}.png?api_key=<API_KEY>
+Mapbox satellite=https://api.mapbox.com/v4/mapbox.satellite/{z}/{x}/{y}.jpg?access_token=<API_KEY>
+
+
+[api_keys]
+# This section conatains API keys for tile servers that require token-based authentication.
+#Stamen terrain=
+#Stamen toner=
+#Stamen toner lite=
+#Stamen toner background=
+#Statdia outdoors=
+#Mapbox satellite=
+
+
+[map_attributions]
+# This section contains attributions for map imagery.  Attributions should consist
+# of a comma-separated list of text and optionally hyperlinks.  The hyperlinks must
+# be contained in angle brackets.
+# Tile servers listed in the 'basemap_tile_servers' section that do not have
+# attributions will not be available for use as basemaps.
+Stamen terrain=© Stadia Maps <https://stadiamaps.com/>, © OpenMapTiles <https://openmaptiles.org>, © OpenStreetMap <https://www.openstreetmap.org/copyright>, © Stamen Design <https://stamen.com/>
+Stamen toner=© Stadia Maps <https://stadiamaps.com/>, © OpenMapTiles <https://openmaptiles.org>, © OpenStreetMap <https://www.openstreetmap.org/copyright>, © Stamen Design <https://stamen.com/>
+Stamen toner lite=© Stadia Maps <https://stadiamaps.com/>, © OpenMapTiles <https://openmaptiles.org>, © OpenStreetMap <https://www.openstreetmap.org/copyright>, © Stamen Design <https://stamen.com/>
+Stadia outdoors=© Stadia Maps <https://stadiamaps.com/>, © OpenMapTiles <https://openmaptiles.org>, © OpenStreetMap <https://www.openstreetmap.org/copyright>
+Stamen toner background=© Stadia Maps <https://stadiamaps.com/>, © OpenMapTiles <https://openmaptiles.org>, © OpenStreetMap <https://www.openstreetmap.org/copyright>, © Stamen Design <https://stamen.com/>
+Mapbox satellite=© Mapbox <https://www.mapbox.com/about/maps>, © OpenStreetMap <https://www.openstreetmap.org/about/>, Improve this map <https://labs.mapbox.com/contribute/>
+
+
+[map_color_adj]
+# This optional section contains color adjustment values for custom basemaps.  Each setting key
+# should be the name of a basemap tile, and each value should be a set of three floating-point
+# numbers.  These numbers are the adjustments to be made to saturation, contrast, and
+# brightness, respectively.  Negative values decrease the saturation, etc., and positive values
+# increase the values.
+
+
+[symbols]
+# This section contains file names (with paths) for additional symbols that can be loaded
+# for use on the map.  The key should be a symbol name, and the value should be the name
+# of a file containing an X11 bitmap (.xbm) for the symbol.  These can be used as map markers
+# or as the marker for selected locations.
+
+
+[connect]
+# This section contains settings that are needed to connect to a database to obtain a data
+# table on startup.
+
+# The type of DBMS.  Valid values are: ‘p’: PostgreSQL, ‘l’: SQLite, ‘k’: DuckDB, ‘m’: MySQL or MariaDB,
+# ‘o’: Oracle, and ‘f’: Firebird.
+#db_type=
+
+# The name of the server for client-server databases.
+#server=
+
+# The port number for client-server databases.  This is only needed if the DBMS has been set up
+# to use a non-standard port.
+#port=
+
+# The name of the database to use, for client-server databases.
+#database=
+
+# The name of the database file to use, for file-based databases.
+#file=
+
+# The name of the database user, for client-server databases.
+#user=
+
+# Whether to suppress the password when a user name is provided.  By default, a password
+# will be prompted for when a user name is provided for a client-server database.
+# Valid values are True and False.  The default is False; a setting of True will suppress
+# the password prompt.
+#no_password=True
+
+# The name of the database table to import.
+#table=
+
+# The file name of a SQL script that will be run against the database before the data table
+# is imported.  The script will be run with the same connection that is used to import the
+# table, so the script may create a temporary table or view to import.
+#script=
+
+
+
+[defaults]
+
+# The basemap to use initially for the map.  This may be one of the basemap names
+# in the 'basemap_tile_servers' section of a configuration file, or one of the servers
+# with built-in support: "OpenStreetMap", "Google streets", and "Google satellite".
+# The default is OpenStreetMap.
+#basemap=
+
+# The name of the column in the data table containing color names that can be used
+# for location markers.
+#color_column=
+
+# The name of a CSV or spreadsheet file containing data to import an display. 
+#datafile=
+
+# The name of the column in the data table containing identifiers, or labels, to be 
+# placed above or below location markers.
+#id_column=
+
+# The name of the image file to create when mapdata is used simply to create a map
+# image file and exit.
+#imagefile=
+
+# The length of time (in seconds) to wait for the basemap to be drawn before exporting
+# the map to an image file.
+#imagewait=12
+
+# The appearance of location labels in boldface.  Valid values for 'label_bold' are
+# "Yes" and "No"; the default is "No".  Valid values for colors are listed in the online
+# documentation.  The font name must be one of the font families installed on the computer.
+# The font name must be specified as one word; if the name contains spaces, they should be
+# replaced with underscores.  Valid values for 'label_position' are "above" and "below".
+# The label size should be specified in pixels.
+#label_bold=Yes
+#label_color=
+#label_font=
+#label_position=
+#label_size=
+
+
+# The type and color of the symbol used to mark locations in the data file.  These may be
+# overridden by values in the data file, as specified by 'color_column' and 'sybmol_column'
+# settings.  Valid values for the color and marker (symbol) are shown in the online
+# documentation.
+#location_color=
+#location_marker=
+
+# Text that will be used as a title on the map window.
+#message=
+
+# Whether to initially allow multiple selections.  Valid values are "Yes" and "No"; the
+# default is "No".
+#multiselect=Yes
+
+# The Coordinate Reference System (CRS) identifier for the latitude and longitude values,
+# if the coordinates are not in decimal degrees WGS84 (CRS 4326).
+#projection=
+
+# The type and color of the symbol used to mark selected locations.  Valid values are shown
+# in the online documentation.  The defaults are 'red' and 'wedge'.
+#select_color=
+#select_symbol=
+
+# The name of the sheet to import when data are imported from a spreadsheet workbook.
+#sheet=
+
+# Whether or not to show regression statistics (the slope, intercept, and R-square)
+# whenever a least-squares regression line is added to a scatter plot or line plot
+# (and when the plot is redrawn).  Valid values are "Yes" and "No"; the default
+# value is "No".
+#show_regression_stats=Yes
+
+# The name of the column in the data table containing names of symbols to be used
+# for location markers.  Valid symbols are shown in the online documentation.
+#symbol_column=
+
+# Whether or not to use symbol colors that are specified in the data table (see the
+# 'color_column' setting).  Valid values are "Yes" and "No"; the default is "Yes".
+#use_data_color=No
+
+# Whether or not to use symbols that are specified in the data table (see the
+# 'symbol_column' setting.  Valid values are "Yes" and "Nok"; the default is "Yes".
+#use_data_marker=No
+
+# The name of the columns in the data table containing longitude and latitude values.
+#x_column=
+#y_column=
+
+
+[misc]
+# This section contains settings related to the operation of mapdata.py.
+
+# The name of an external editor that can be used to edit custom SQL that is
+# entered in the 'Selections/Query data' dialog box
+#editor=
+
+# The name of a SQLite database file to be used to store a copy of the data table.
+# This file may need to be used for very large data sets.
+#temp_dbfile=
+
+# The name of another configuration file to be read immediately after
+# this one.
+#read_config=
+
+
+# End of mapdata.conf configuration file
+# ======================================================================================
+