Frameworks

Mac OS X frameworks of various Unix image format and GIS libraries, which are the base requirements for most software available on this site. All frameworks are built for Mt Lion and newer, except as noted. Python modules included are made for the system Python 2.7. For older systems, see the download archive.

GDAL Complete

This is a convenience installer that includes all the current versions of the GDAL, GEOS, PROJ, SQLite and UnixImageIO frameworks as of the major GDAL version of the package. There is no need to download and install these frameworks individually if this package is installed. The GDAL plugins and other extras are not included, but the numPy package is.

Note about updates: after initial installation, when an framework is updated, you may want to download the individual installers to save on download time, unless it’s the GDAL framework that is updated (because that’s 80% of this package) or many frameworks change.

The individual frameworks are not available for the GDAL Complete 2.2 package.

GDAL Plugins

GDAL 2.2

Older Frameworks

PROJ

UnixImageIO

Requirements:

  • PROJ framework

The UnixImageIO framework. Common graphics format libraries in a single framework. Image libraries included: GIF, JPEG, PNG, TIFF, GeoTIFF, JasPer UUID, OpenJPEG.

GEOS

GEOS framework includes Shapely Python library (for system Python only).

SQLite3

Requirements:

  • GEOS framework
  • PROJ framework
  • UnixImageIO framework

Includes the FTS3 search, ICU unicode, R-Tree indexing and Spatialite 4.2 & Rasterlite 1.1 extensions, and Proxy Locking, Column Metadata and Memory Management features are enabled. Pysqlite2 Python extension included.

GDAL

GDAL 2.1

GDAL 1.11

Requirements:

  • UnixImageIO framework
  • GEOS framework
  • SQLite3 framework
  • PROJ framework
  • NumPy

Includes Python GDAL library and tools. Extra plugins and R package are available as separate downloads above. The GDAL Python libraries and scripts use the system Python. The GDAL framework includes a copy of the Numpy installer. R support requires the R framework and application.

Other Frameworks

FreeType

cairo

Requirements:

  • FreeType framework
  • UnixImageIO (or GDAL Complete) framework

❗ Note: cairo conflicts with the “Cairo” framework from the OS X Gtk framework package. They are not compatible. The only option right now is to choose – my framework for GRASS and MapServer, or Gtk cairo for whatever app needs it (nothing here, of course). I don’t feel like changing anything as I don’t really give a ____ about Gtk, but maybe I’ll figure out something… or maybe not.

GSL

Tcl/Tk

Standard framework build of Tcl/Tk Aqua. This will NOT be updated to 8.5.9 because that breaks compatibility with GRASS NVIZ.

Old Systems

The frameworks will not be updated further for older systems than those above. If you need up-to-date frameworks for older systems, use the build scripts (or build standard libraries from source for the discontinued frameworks, like Xerces).

These frameworks have build scripts available in the developer section below:

  • SQLite3
  • FreeType
  • PROJ
  • UnixImageIO
  • GSL

These frameworks have a framework build option in the source:

These frameworks are discontinued and will be built as static libraries (or not used at all), to be included as needed in other software:

  • FFTW3 (used in GRASS only)
  • Xerces (used in GDAL only)
  • GD (used in MapServer and PHP, small enough to be static)
  • PDFlib (used in MapServer and PHP, other PDF option available) ❗ not used

Developers and Do-It-Yourselfers

Build Scripts

Developer Notes

These frameworks were designed to be easy to use as both normal frameworks for OS X apps, and as normal Unix libraries. This means that most of the time, configure scripts should need little or no changes to use these frameworks. Follow normal framework procedures for including them in Xcode projects, or for using them as frameworks in other software. All of these have been checked for framework-style includes internally or between them, such as #include <PROJ/projects.h> – many were OK as is, some needed some adjustments.

In a Unix configure-make-install project, they can be used as is, without messing around with patching configure. There is a symlink folder at the top level that acts as a mini unix library environment, called ‘unix’. ie in GDAL it would be /Library/Frameworks/GDAL.framework/unix. This has the usual assortment of bin/include/lib subfolders, and symlinks with a normal lib*.dylib style library name. You would use this ‘unix’ folder in configure --with options just like /usr/local. ie: --with-proj=/Library/Frameworks/PROJ.framework/unix, or --with-gdal=/Library/Frameworks/GDAL.framework/unix/bin/gdal-config.