update

Author: afourmy

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Antoine Fourmy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,75 @@
+# Introduction
+
+A Geographic Information System (GIS) software is a software designed to import, analyze and visualize geographic data.
+PyGISS is a lightweight GIS software based on the standard Python library for GUI programming: tkinter.
+It allows users to create maps by importing shapefiles (.shp files), a format that describes maps as a set of polygons.
+
+![extended pyGISS](https://github.com/afourmy/PyGISS/blob/master/images/extended_pyGISS.PNG)
+
+# PyGISS dependencies
+
+PyGIS relies on three Python libraries:
+
+* pyshp, used for reading shapefiles.
+* shapely, used for converting a multipolygon into a set of polygons
+* pyproj, used for translating geographic coordinates (longitude and latitude) into projected coordinates
+
+Before using PyGISS, you must make sure all these libraries are properly installed:
+
+```
+pip install pyshp
+pip install shapely
+pip install pyproj
+```
+
+The extended PyGISS version also uses ImageTk from Pillow:
+
+```
+sudo apt-get install python3-tk (unix)
+sudo apt-get install python3-pil.imagetk (unix)
+pip install pillow (windows & unix)
+```
+
+# PyGISS versions
+
+## Standard version (pyGISS.py, < 100 lines)
+
+![pyGISS](https://github.com/afourmy/PyGISS/blob/master/images/pyGISS.PNG)
+
+The standard version implements PyGISS in less than 100 lines of code.
+
+It contains:
+* a menu 'Import shapefile' for the user to choose a shapefile and draw the map.
+* a menu 'Switch projection' to switch between the mercator and azimuthal orthographic projection.
+
+The following bindings are implemented:
+* the right-click button allows the user to move the display in any direction
+* the scroll wheel can be used for zooming in and out.
+* pressing the left-click button on the map will print the associated geographical coordinates (longitude, latitude).
+
+A few shapefiles are available for testing in the 'PyGISS/shapefiles' folder (world countries, continents, France, US).
+
+## Extended version (extended_pyGISS.py, < 500 lines)
+
+![extended pyGISS](https://github.com/afourmy/PyGISS/blob/master/images/extended_pyGISS.PNG)
+
+The extended version shows how to use PyGISS to create a full-on GIS software.
+Besides the import of shapefiles, nodes can be created with a "Drag & Drop" system, moved on the map, and deleted.
+They can also be imported by creating an Excel file that contains the longitude and latitude of the nodes. (an example is available in the 'PyGISS/import' folder).
+
+To create a node, press the left-click button on the Python Software Foundation icon in the menu, and hold it down until you've reached the desired location on the canvas.
+Pressing the left-click button on the canvas allows the user to either select one or several nodes, or move all selected nodes.
+The right-click button and the scroll wheel work like in PyGISS standard version.
+
+The menu on the left allows the user to import a shapefile and draw the associated map ("Import map"), erase the map or a selection of nodes, and switch between the mercator and azimuthal orthographic projections. 
+
+For each node on the canvas, the geographical coordinates (longitude and latitude) are displayed under the node, and the position is updated in real-time upon moving the node.
+
+## Golf version (golf_pyGISS.py, 5 lines)
+
+![pyGISS](https://github.com/afourmy/PyGISS/blob/master/images/golf_pyGISS.PNG)
+
+The golf version implements the core feature of PyGISS (import of shapefiles) in 5 lines of code. 
+Upon running golf_GISS.py, a window pops up for the user to choose a shapefile.
+The shapefile is then imported and drawn on the canvas. 
+The mouse wheel allows the user to move on the map by zooming in and zooming out.