Posts

Install QGIS on a Mac in 8-Steps

**UPDATED FOR QGIS 2.16 – 07 Oct 2016**

QGIS is an impressively powerful open source geographic information system (GIS). In 2010, I reviewed QGIS when it had an “All-In-One” installation bundle for the Mac. That one-step installation has gone by the wayside, and while QGIS is an excellent GIS solution for Mac users, installation is much more of a chore. As a software developer myself, I can only imagine the installation process discourages use by the average consumer (and by average, I mean moderately sophisticated GIS users).

If you’re in that camp, this guide is for you… it provides (without warranty) a step-by-step guide to successfully install the supporting frameworks and the QGIS software. These instructions are for QGIS 2.16 built for Mac OS X Mountain Lion, Mavericks, Yosemite, El Capitan, and (hopefully) MacOS Sierra.

Installing QGIS on a Mac

Step One: Honesty

Installing most software on a Mac is easy, but installing QGIS on a Mac is a pain (though it is getting easier with each release!)¹. I’ve stumbled through it a couple of times now.

There are supporting frameworks that must be installed first, and in a particular order, before the QGIS installation can begin. If you try installing QGIS before installing the supporting frameworks, you’ll likely see an error message like this:

qGIS installation error

Also, always read the ReadMe files included with your downloads before installing. For example, this important ReadMe message is included with the QGIS Installer:

 If you have an old QGIS.app in your Applications folder, trash it before installing QGIS 2.16.
 Old files may not be deleted by the installer, which may cause problems for QGIS2.16

In summary, the following download is required:

  1. Download QGIS for Mac Installer. There is no need to download and install these frameworks individually if this package is installed. All required items are included on the disk image, which includes:
    • GDAL Complete.pkg (installs framework package)
    • NumPy.pkg (installs python module)
    • Matplotlib.pkg (instalsl python module)
    • Install QGIS.pkg (installs the app!)
The Real 10 8 Steps

STEP 1. To allow installation of non-Apple developer recognized software, first change your Mac Security Preferences to ‘Allow apps downloaded from: Anywhere’

STEP 2. Download the ‘QGIS for Mac’ installer

Download QGIS for Mac Installer. Double-click the ‘QGIS-2.6.1.dmg’ to view its contents:

qgis-2-16-installer

STEP 3. install GDAL Complete —  double-click the ‘GDAL Complete.pkg’ and step through its installation.

STEP 4. Install NumPy — double-click the ’NumPy.pkg’ and step through its installation.

 

STEP 5. Install Matplotlib —  double-click the ‘matplotlib.pkg’ and step through its installation.

 

STEP 6. Install QGIS —  double-click the ‘Install QGIS.pkg’ and step through its installation.

STEP 7. Proceed to your Applications folder and find the QGIS app. Double-click to launch.

Be patient, it took a little less than a minute on first launch for my copy of QGIS to fully open. Also, even if you are familiar with GIS software, don’t expect QGIS to be completely intuitive. Like any new app, you need to take the time to learn its features and user interface. Fortunately, there are some terrific learning resources available, like the QGIS Tutorials and Tips by Ujaval Gandhi and the QGIS User Guide.

You now have a sophisticated GIS software to learn and enjoy. Depending on your needs, you might even want to add some of the QGIS Plugins.

STEP 8. Your almost done! To finish things off you should do the following:

a. Change your Mac Security Preferences back to ‘Allow apps downloaded from: Mac App Store and Identified Developers’ (or Mac App Store only).
b. Save the QGIS.dmg files, since they each contain uninstall instructions should you ever need them.

 

¹ Software isn’t always easy. I really appreciate the great work of good folks who support this open source (and free) software. The main release packages for QGIS for Mac are maintained by Kyngchaos, aka William Kyngsburye. (thank you!)

Install QGIS on a Mac in 10-Steps

**NEW: VIEW THE UPDATED STEPS FOR QGIS 2.16 – 07 Oct 2016**

The following instructions were for QGIS 2.10 and are kept here for historical record:

QGIS is an impressively powerful open source geographic information system (GIS). In 2010, I reviewed QGIS when it had an “All-In-One” installation bundle for the Mac. That easy installation has gone by the wayside, and while I still find QGIS an excellent GIS solution for Mac users, installation is much more of a chore. As a software developer myself, I can only imagine the installation process discourages use by the average consumer (and by average, I mean moderately sophisticated GIS users).

If you’re in that camp, this guide is for you… it provides (without warranty) a step-by-step guide to successfully install the supporting frameworks and the QGIS software (these instructions are for QGIS 2.10 built for Mac OS X Lion, Mountain Lion, Mavericks and Yosemite, though presumably will work with more current updates as they are added).

Installing QGIS on a Mac

Step One: Honesty

Installing most software on a Mac is easy, but installing QGIS on a Mac is a pain¹. I’ve stumbled through it a couple of times now.

There are supporting frameworks that must be installed first, and in a particular order, before the QGIS installation can begin. If you try installing QGIS before installing the supporting frameworks, you’ll likely see an error message like this:

qGIS installation error

Also, always read the ReadMe files included with your downloads before installing. For example, this important ReadMe message is included with the QGIS Installer:

 If you have an old QGIS.app in your Applications folder, trash it before installing QGIS.
 Old files may not be deleted by the installer, which may cause problems for QGIS.

In summary, the following downloads are required:

  1. Download GDAL Complete 1.11 framework package, which includes:
    • GDAL Complete.pkg (install framework package)
    • NumPy.pkg (install python module)
  2. Download Matplotlib Python module, which includes:
    • Matplotlib.pkg (install python module)
  3. Download QGIS for Mac Installer, which includes:
    • Install QGIS.pkg (install the app!)

 

The Real 10 Steps

STEP 1. To allow installation of non-Apple developer recognized software, first change your Mac Security Preferences to ‘Allow apps downloaded from: Anywhere’

STEP 2. Download the ‘GDAL 1.11 Complete’ framework package

Download ‘GDAL 1.11 Complete’ from http://www.kyngchaos.com/software/frameworks#gdal_complete (1.11 is the current version at the time I wrote this article — there may be newer version).

This is actually a package containing several frameworks more conveniently packaged together in one installer. Importantly, the required ‘GDAL Complete.pkg’ and ‘numPy.pkg’ are both included in the ‘GDAL 1.11 Complete’ download.

Double-click the ‘GDAL_Complete_1.11.dmg’ to view its contents:

STEP 3. install GDAL Complete —  double-click the ‘GDAL Complete.pkg’ and step through its installation.

STEP 4. Install NumPy — double-click the ’NumPy.pkg’ and step through its installation.

STEP 5. Download the ‘Matplotlib’ python module from http://www.kyngchaos.com/software/python

Double-click the ‘matplotlib-1.3.1-2.dmg’ to view its contents:

STEP 6. Install Matplotlib —  double-click the ‘matplotlib.pkg’ and step through its installation.

STEP 7. Download QGIS Mac OS X Installer from http://www.kyngchaos.com/software/qgis

Double-click the ‘QGIS-2.10.1-1.dmg’ to view its contents:

 

STEP 8. install QGIS —  double-click the ‘Install QGIS.pkg’ and step through its installation.

STEP 9. Proceed to your Applications folder and find the QGIS app. Double-click to launch.

Be patient, it took a little less than a minute on first launch for my copy of QGIS to fully open. Also, even if you are familiar with GIS software, don’t expect QGIS to be completely intuitive. Like any new app, you need to take the time to learn its features and user interface. Fortunately, there are some terrific learning resources available, like the QGIS Tutorials and Tips by Ujaval Gandhi and the QGIS User Guide.

You now have a sophisticated GIS software to learn and enjoy. Depending on your needs, you might even want to add some of the QGIS Plugins.

STEP 10. Your almost done! To finish things off you should do the following:

a. Change your Mac Security Preferences back to ‘Allow apps downloaded from: Mac App Store and Identified Developers’ (or Mac App Store only).
b. Save the three downloaded .dmg files, since they each contain uninstall instructions should you even need them.

 

¹ Software isn’t always easy. I appreciate the great work of good folks who support this open source (and free) software. The main release packages for QGIS for Mac are maintained by Kyngchaos, aka William Kyngsburye. (thank you!)

GIS for the Mac – gvSIG

Thanks Marcel St-Germain for turning me on to gvSIG v1.1. This relatively new open-source GIS software was reviewed by Adena Schutzberg All Points Blog on October 1, 2007 (and at its startup in 2005) and provides a quick review on the status of the project and major features. What I missed was the ability to run gvSIG on the Mac OSX operating system (Intel only) as well as Windows. Since I am now a MacBook Pro user (and lovin’ it), I am always on the prowl for good GIS applications that are low cost and robust. I mentioned in my review of My World GIS that most open source GIS for Mac (that are easy enough for me to have installed) are currently heavy on viewing capabilities but low on analysis. I am pleased to see that gvSIG is another GIS platform that runs on the Mac and includes a suite of analysis/geoprocessing capabilities.

Data File Types

This no-cost GIS platform seems well positioned for enterprise implementations due to its impressive ability to use vector (shp, dgn, dxf, dwg, gml, etc.), raster (ecw, mrsid, tiff, img, jpg2000, etc.), and it’s ability to connect with remote services like WMS, WFS, WCS, JDBC (geodatabases), catalogue, and gazetteer services (though maybe with a bit more development; there are some known problems that may merit holding off) . This likely stems from its government sponsorship by the “Conselleria de Infraestructuras y Transporte” (Council of Infrastructure and Transportation) of the “Generalitat Valenciana” (Regional Government of the Comunidad Valenciana in Spain) and its strong orientation to manage geographic information and towards Spatial Data Infrastructures (SDI).

Adding Your Own Data

Installation was easy. Even though a standard install file wasn’t available, it was easily created and I was up and running within about 60 seconds.

I’m one of those who dive right into a piece of software and then follow-up with the instructions if I can’t figure it out. While I didn’t find the interface immediately intuitive, MicroImages provides a good quick-start guide (January 2007 on version 1.0.1) that I found quite helpful for adding a WMS. Adding shapefiles and ArcIMS worked in much the same way. The gvSIG website states that most users of ArcView should find the interface intuitive. Unfortunately, its been a while since I’ve been on that platform.

Cartographic Features

Editing the symbology of layers was pretty straight forward. While the symbol sets are limited (small group of points and hatching), there appeared to be an option to add your own point graphics. Standard color ramps (swatches) and RGB menu ware available, as well as transparencies. Cartographic rendering options include display of unique values, intervals, and labeling with a similar interface to ArcGIS.

I probably missed it, but I didn’t see a print menu. Nonetheless, under VIEW>EXPORT users can export the map image to the following formats: JPG, BMP and PNG files.

Analysis

I was able to use the geoprocessing tools, but found them a bit buggy and slightly clunky (for example, I changed the map and measurement units before preforming a buffer operation, but they didn’t seem to stick). The following analysis functions are available, complete with graphic depiction and description (in English) of the function:

Proximity

-Buffer

-Spatial Join

Overlay

-Clip

-Difference

-Intersect

-Union

Computational Geometry

-Convex Hull

Aggregation

-Dissolve

Data Conversion

-Merge

-XY Shift

-Re-project

To support SDIs, future development would definitely benefit from the ability to re-project map data “on the fly.”

Overall I found the system impressive, though there may be a way to go on development and usability. It seems the team is well on its way and has the right support to make this a great open-source option for desktop and enterprise GIS.

Editing

While I haven’t tested it out yet, the system appears to have a full range of vector editing tools. Users can also create new layers. Users have the ability to export layers in shape, Oracle spatial, dxf, postGIS, GML raster and annotation.

Other Stuff

In addition to the MAC platform, at FOSS4G2007 the first migration of the gvSIG product (http://www.gvsig.gva.es) to mobile platforms was presented. This first launch is a brand-new open-source GIS client to be used in PDAs, with a good set of capabilities which fills a gap in the FOSS4G panorama, under a GPL license.

______

The third gvSIG Conference will be celebrated the next November 14th, 15th, and 16th in the Valencia Conference Centre. Congrats to the entire gvSIG Team for the contributions they have made thus far. I’m looking forward to following its development.

My World GIS for the Mac

UPDATE: My World GIS is no longer being developed and may not work with the latest operating systems.

(2007) Earlier this summer I made the switch to a MacBook Pro OS-X. While I knew there was a dearth of GIS software for the Mac, I knew all the other reasons for a switch made good sense for me. I continue to use my PC only for GIS needs and every time I use it I hate to boot up the system at all. I have been searching for an easy, inexpensive GIS system to use on my Mac and have been continually disappointed – until now.

First, let me give a quick overview of what I have found… (a more comprehensive review of these systems is on cartographica.com). The tools I’ve downloaded so far are Quantum GIS (QGIS), UDig, SimpleDEMViewer, and OpenOX-Grass. The biggest disappointment is none of the really easy ones have any ANALYSIS capability — I personally don’t think it is a GIS if you can’t analyze the data. Viewing the data is great, but I definitely need more. Also, let me admit I am not sophisticated enough of a Mac user yet to do everything required to run OpenOX-Grass (it requires Apple X11) but I will try to work toward this because it does look very powerful http://openosx.com/grass/grass.html and the price (~$60 US) is right. Also, QGIS with Grass support looks very promising (if I can figure out how to implement it). My conclusion with these existing programs is that those that are easy enough to plug-and-play lack basic analysis capabilities, and those that show promise for being very powerful are limited by not being plug-and-play.

This brings me to a review of My World GIS (v4.1.1) for the Mac (it can also run on a PC). So far I have been pleasantly surprised.

My World GIS

Northwestern University has developed a GIS called My World, which engages ESRI’s MapObjects Java technology. My World is distributed by Pasco Scientific (http://www.pasco.com/myworld/). Built in Java, My World runs on Macintosh OSX and Windows environments. It provides a robust subset of capabilities from a professional GIS environment, including multiple projections, table and map view, hyperlinks, and a common language approach to conducting analyses. It is marketed to educators, but licensing is also available for non-educational use (for research or other non-educational uses) directly from Northwestern University (currently priced at $99 US per single license). There is a fully functional 45-day trial period available.

Data File Types

My World supports the following types of data files and/or folders for reading and writing shape data:

* ESRI Shapefile, Comma-Separated Values, Tab-Separated Values, and GPX Waypoint Files; plus a variety of Grid and Image file types, and WMS data feeds (more info here).

Adding Your Own Data

I did find adding my own shape files a bit confusing at first since My World doesn’t support the shape files in their native projection and requires them to be un-projected. That this wasn’t totally straight-forward was my only real disappointment with My World. But once I got past the hassle involved with importing my own data, I had a lot of fun with this program.

“My World accepts shape data only in Unprojected Latitude and Longitude in Decimal Degrees, and the longitude must be in the range -180 to +180 (rather than 0 to 360).

If your data uses another projection or different units, you can use My World to un-project and convert it to the proper units by selecting Un-Project Shapefile… from the File menu, or by clicking the Import Data From File… button in Construct mode.

My World accepts projected grid and image data, but you must know all the details of the projection used to project that data before you can use it in My World.”

How I added my own shape files… (some data does come pre-packaged)

I had to really experiment with this before being able to import my shape files and have them show correctly on the map. I was successful using the following steps:

1. I copied my existing data into a temporary folder before using the “Un-project” function (and DEFINITELY HAD A BACKUP OF MY ORIGINAL DATA ON AN EXTERNAL DRIVE).

2. I also created a new folder in the Data directory (in the My World application folder) to hold my data after I un-projected it.

3. When I used the “Un-Project” function, I saved the new files into the new directory folder (I got errors every time I just replaced the existing files).

4. I then deleted the temporary folder containing copies of my original data (My World gets confused if it finds 2 datasets with the same name).

5. Under the “Construct” tab, I added my data to the map by simply dragging and dropping the layer from the Library to the Layer list.

6. You can set the map projection later.

Now the fun part – seeing what My World can do.

Note, under the Visualize and Edit tabs, single click a layer to make it active and double click the layer to set parameters or edit.

Cartographic Features

I am pleasantly surprised by the cartographic capabilities of My World. You can outline and fill polygons with any standard or custom RGB value, easy create color ramps, categorize data, create dot density maps, transparencies, etc. If you’re familiar with commercial GIS platforms it should be pretty intuitive (and maybe even easier). There are about 20 shapes for point symbols, all of which you can control the size, color and transparency.

Labels (Annotation)

In My World you don’t label features per se, you create annotations. This wasn’t intuitive and was kind of buried in the documentation (especially since I was expecting labeling to be done in the same place as symbology), but it was really easy to do once I figured it out. Under the Edit tab, you have to click create new layer. One option you will be presented with for the new layer type is “Annotation.” You can then create an annotation layer from an existing layer, select the existing database field for the annotation, choose from a wide array for fonts, colors, sizes, style, alignment etc. While you can’t do a halo, you can do a background block color and make it transparent to help your text stand out. And since it is annotation, you can just select and move your text around to improve placement. Pretty sweet.

Analysis

This is by far my favorite part.

 

Not only is it robust, but the analysis menu is also super easy to use. Again, if you know GIS and how to do analysis it should be pretty intuitive. Otherwise, there is pretty good documentation available. For example, I was able to very easily “select by spatial relationship” all the building features (first layer) that were within 15 feet of all commercial properties (second layer)(see example). You have the option to save this as a new layer, or make it a selected subset of the existing layer. All the analysis capabilities for selecting by value, by comparing values, by spatial relationship; combining by intersect, union, subtract, and clip; adding fields by math operation, by copying values, reclassifying, computing distances, and selecting members; creating charts of the data, buffering data; dissolving, summarizing statistics, and converting data are all in one place, intuitive and easy to use, and come with a menu complete with graphic depiction of the operation. Wow.

Editing Data

From the edit tab, you can create new layers and/or edit the geometry and data for any of your existing layers, including grids. I easily moved vertices and created new polygons. A note of caution, it seems to automatically save your changes, but there is an undo button or ctrl-Z.

Other Stuff

Overall, the data were pretty zippy to load large files and Web Map Services (WMS). While this wont replace your enterprise GIS, it is a fine system for stand-alone GIS use on your Mac. Besides my own use, my kid’s school only has a Mac computer lab and I now have a good option for getting GIS into their curriculum. I personally am thrilled to have a functional GIS option for my Mac.

My World GIS – I put in the category of “robust low-cost GIS; professionals will be surprised.”