Added all original maptime tutorial files, from BiGCZ-Toolbox repo fo…

…lder

data/World_Seas.cpg

@@ -0,0 +1 @@
+UTF-8

data/World_Seas.prj

@@ -0,0 +1 @@
+GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137.0,298.257223563]],PRIMEM["Greenwich",0.0],UNIT["Degree",0.0174532925199433]]

data/hybas_na_lev00_v1c.cpg

@@ -0,0 +1 @@
+ISO-8859-1

data/hybas_na_lev00_v1c.prj

@@ -0,0 +1 @@
+GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137,298.257223563]],PRIMEM["Greenwich",0],UNIT["Degree",0.017453292519943295]]

data/hybas_na_lev00_v1c.qpj

@@ -0,0 +1 @@
+GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137,298.257223563,AUTHORITY["EPSG","7030"]],AUTHORITY["EPSG","6326"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4326"]]

data/oceans.prj

@@ -0,0 +1 @@
+GEOGCS["GCS_WGS_1984",DATUM["D_WGS_1984",SPHEROID["WGS_1984",6378137,298.257223563]],PRIMEM["Greenwich",0],UNIT["Degree",0.017453292519943295]]

data/oceans.qpj

@@ -0,0 +1 @@
+GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137,298.257223563,AUTHORITY["EPSG","7030"]],AUTHORITY["EPSG","6326"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4326"]]

environment.yml

@@ -0,0 +1,14 @@
+name: geopandasenv
+channels:
+- conda-forge
+dependencies:
+- python=2.7 
+- geopandas
+- geojson 
+- pysal 
+- pyepsg 
+- rasterstats 
+- requests
+- folium 
+- seaborn  
+- jupyter

install-conda.md

@@ -0,0 +1,98 @@
+
+### What is Conda?
+Similar to [pip](https://pypi.python.org/pypi/pip), [**conda**](http://conda.pydata.org/docs/) is an **open source package and environment management system** for installing multiple versions of software packages, their dependencies and switching easily between them. While it originally was developed to support Python, it now supports multiple languages. It works on Linux, OS X and Windows. This [Aug. 2016 blog post](https://jakevdp.github.io/blog/2016/08/25/conda-myths-and-misconceptions/) from Jake Vanderplas provides nice clarifications about conda and where it fits in the ecosystem of Python packaging and environments. See also [this Continuum Analytics blog post for a great, comprehensive introduction to conda](http://www.continuum.io/blog/conda-data-science) targeted to data scientists; it also has links to a presentation (Youtube and slides) on the same material.
+
+For additional help you can consult the [UW GeoHack conda introduction](https://geohackweek.github.io/Introductory/00-conda-tutorial/).
+
+### Anaconda or Miniconda
+[Anaconda](https://www.continuum.io/why-anaconda) is a data science platform that comes with a lot of packages. At the core, Anaconda uses the conda package management system. A list of packages included can be found [*here*](https://docs.continuum.io/anaconda/pkg-docs). If you don't have time or disk space -- or the inclination -- to install the entire distribution, try [Miniconda](http://conda.pydata.org/miniconda.html), a bootstrap version of Anaconda, which contains only Python, essential packages, and conda. Other packages have to be installed individually.
+
+**NOTE: We will be using Python 2.7 for this geopandas workshop.**
+
+### Installing Anaconda
+
+1. To install Anaconda, please click on the link below for your operating system, and follow the instructions on the site:
+  **NOTE: FOR Windows and OSX Graphical installation, make sure to do a custom install and uncheck the box `modify PATH`**
+
+  ![OSX Custom Install](https://docs.continuum.io/_images/pathoption.png)
+
+  - [Windows](https://docs.continuum.io/anaconda/install#anaconda-for-windows-install)
+  - [OSX](https://docs.continuum.io/anaconda/install#anaconda-for-os-x-graphical-install)
+  - Linux: see below
+
+  ```bash
+  url=https://repo.continuum.io/archive/Anaconda2-4.2.0-Linux-x86_64.sh
+  curl $url -o anaconda.sh
+  bash anaconda.sh -b
+  export PATH=$HOME/anaconda2/bin:$PATH
+  conda update --yes --all
+  ```
+2. Once Anaconda installation step is finished run `python` in the command line to test if Anaconda is installed correctly. **Note: For windows, please use Windows powershell as the command line. It should be preinstalled, if not click [here](https://msdn.microsoft.com/en-us/powershell/scripting/setup/installing-windows-powershell).**
+If Anaconda is installed correctly, you should have this prompt, which emphasizes **Anaconda**:
+
+```bash
+$ python
+Python 2.7.11 |Anaconda custom (x86_64)| (default, Dec  6 2015, 18:57:58)
+[GCC 4.2.1 (Apple Inc. build 5577)] on darwin
+Type "help", "copyright", "credits" or "license" for more information.
+Anaconda is brought to you by Continuum Analytics.
+Please check out: http://continuum.io/thanks and https://anaconda.org
+>>>
+```
+
+### Installing Miniconda
+
+#### Windows
+Navigate to http://conda.pydata.org/miniconda.html and download the proper installer for you Windows platform (32 or 64 bits).
+We recommend to download the Python 2 version of Miniconda as not all packages are Python 3-compliant yet.  You can still create new Python 3 environments using the Python 2 verson of Miniconda, so you are not limiting yourself.
+
+When installing you will be asked if you wish to make the Anaconda Python your default Python for Windows.
+If you do not have any other installation that may be a good option.  If you want to keep multiple versions of python on your machine (e.g. ESRI-supplied python, or both 32 and 64 bit versions of Anaconda), then don't select the option to modify your path or modify your Windows registry settings.
+
+#### Linux and OSX
+You may follow manual steps from http://conda.pydata.org/miniconda.html similar to the instructions on Windows (see above). Alternatively, you can execute these commands on a terminal shell (in this case, the bash shell):
+
+```bash
+url=https://repo.continuum.io/miniconda/Miniconda2-latest-Linux-x86_64.sh  # On MacOSX, replace Linux with MacOSX
+curl $url -o miniconda.sh
+bash miniconda.sh -b
+export PATH=$HOME/miniconda2/bin:$PATH
+conda update --yes --all
+```
+
+### Creating the `geopandasenv` conda environment
+
+Download the `environment.yml` file by going to [this link](https://raw.githubusercontent.com/BiG-CZ/BiG-CZ-Toolbox/master/geopandas/environment.yml), right clicking with the mouse and choosing `Save as...`
+
+Open a terminal window where you saved the file and type the commands to create the environment and "activate" it.
+```bash
+conda env create environment.yml  # Will create an environment called "geopandasenv"
+source activate geopandasenv  # OSX and Linux
+activate geopandasenv  # Windows
+```
+
+The `geopandasenv` conda environment includes `geopandas` and its dependencies, which include (for vector-handling packages) `shapely`, `fiona`, `pyproj`, `descartes` and `pysal`, in addition to `pandas` and `numpy`. These will be handled automatically by the conda environment. Additional conda packages available in the environment include `pyepsg`, `geojson`, `folium` (for interactive maps in Jupyter notebooks), `rasterstats` (for simplified raster-vector analysis), `requests`, and `psycopg2` for access to vector data stored in PostGIS (though this `Maptime` workshop will not include PostGIS).
+
+### Starting Jupyter notebooks
+
+On Windows and MacOSX you may have a conda GUI application already installed, specially if you installed Anaconda. That application should let you select the `geopandasenv` environment, then launch Jupyter notebook with that environment.
+
+Otherwise, on the command shell, you can launch Jupyter notebooks (after activating the environment) like this:
+```bash
+jupyter notebook
+```
+
+### Removing and recreating the `geopandasenv` conda environment
+
+To delete the conda environment, first "deactivate" it if you've activated it in your shell session:
+```bash
+source deactivate  # OSX and Linux
+deactivate  # Windows
+```
+
+Then remove the environment:
+```bash
+conda env remove -n geopandasenv
+```
+
+You can create it again, from scratch, using the command described earlier.

lessons.md

@@ -0,0 +1,18 @@
+# Introduction to GeoPandas and related vector geospatial processing with FOSS Python
+
+This [Maptime Meetup workshop](https://www.meetup.com/MaptimeSEA/) is adapted from materials prepared for the [University of Washington GeoHack week event](https://geohackweek.github.io), Nov 14-18, 2016. We'll be using [those materials ("Vector Data Processing using Python Tools")](https://geohackweek.github.io/vector/) directly in some cases, as is.
+
+## Python Preparations
+
+This workshop will rely on **conda** to set up the required Python 2.7 environment and packages. [See here](https://github.com/BiG-CZ/BiG-CZ-Toolbox/blob/master/geopandas/install-conda.md) for details on how to get set up. All demonstration will be done on [Jupyter notebooks](http://jupyter.org). The `geopandasenv` Python conda environment you will create includes Jupyter.
+
+## Materials and Lessons
+
+We'll follow the "lessons" used in the [UW GeoHack tutorial](https://geohackweek.github.io/vector/), jumping back and forth from those materials to the updated Jupyter notebooks. All materials can be [downloaded from here](https://github.com/BiG-CZ/BiG-CZ-Toolbox/tree/master/geopandas) so you can run the code on your computer. These include [GIS data files](https://github.com/BiG-CZ/BiG-CZ-Toolbox/tree/master/geopandas/data) and the [two Jupyter notebooks](https://github.com/BiG-CZ/BiG-CZ-Toolbox/tree/master/geopandas/notebooks). The data files can be grabbed more easily as [a zip file (18 MB)](https://github.com/BiG-CZ/BiG-CZ-Toolbox/raw/master/geopandas/data.zip). Make sure to reproduce the directory structure of the `notebooks` and `data` directories found on the github repository.
+
+1. [**Geospatial Concepts.**](https://geohackweek.github.io/vector/02-geospatial-concepts/) What is 'vector' geospatial data all about?
+2. [**Encodings, Formats and Libraries.**](https://geohackweek.github.io/vector/03-encodings-libraries/) What are the common ways to encode vector geospatial data in Python, and how much is borrowed from broader encoding standards?
+3. **GeoPandas Introduction.** What is GeoPandas? What functionality and advantages does GeoPandas offer over other Python geospatial tools? What geospatial storage, analytical and plotting capabilities does it include? What is its relationship to Pandas? [Download the Jupyter notebook](https://github.com/BiG-CZ/BiG-CZ-Toolbox/blob/master/geopandas/notebooks/geopandas_intro.ipynb) to run it locally, or view it [statically but nicely rendered on nbviewer](http://nbviewer.jupyter.org/github/BiG-CZ/BiG-CZ-Toolbox/blob/master/geopandas/notebooks/geopandas_intro.ipynb). The original materials with extra formatting and PostGIS content (and original notebook) can be [found here](https://geohackweek.github.io/vector/04-geopandas-intro/) on the UW GeoHack web site.
+4. **GeoPandas Advanced Topics.** What additional capabilities does GeoPandas provide, including data access, plotting and analysis? How does it integrate with other common Python tools? How do GeoPandas data objects integrate with analyses of raster data over vector geospatial features? [Download the Jupyter notebook](https://github.com/BiG-CZ/BiG-CZ-Toolbox/blob/master/geopandas/notebooks/geopandas_advanced.ipynb) to run it locally, or view it [statically but nicely rendered on nbviewer](http://nbviewer.jupyter.org/github/BiG-CZ/BiG-CZ-Toolbox/blob/master/geopandas/notebooks/geopandas_advanced.ipynb). The original materials with extra formatting and PostGIS content (and original notebook) can be [found here](https://geohackweek.github.io/vector/06-geopandas-advanced/) on the UW GeoHack web site.
+
+For lessons 1 and 2 we'll go directly to the GeoHack tutorial site.