dummy-link

GDAL

Thin Julia wrapper for GDAL - Geospatial Data Abstraction Library

Readme

GDAL.jl

Build Status Build status

Julia wrapper for GDAL - Geospatial Data Abstraction Library. This package is a binding to the C API of GDAL/OGR. It provides only a C style usage, where resources must be closed manually, and datasets are pointers. Note: this also means that before being able to use any drivers (for input/output of different formats), they must be registered first using GDAL.allregister().

Other packages can build on top of this to provide a more Julian user experience. See for example ArchGDAL.jl.

Installation

This package is registered, so add it using Pkg. This will also download GDAL binaries created by GDALBuilder.

pkg> add GDAL

To test if it is installed correctly, use:

pkg> test GDAL

Documentation

Docstrings are automatically inserted from the GDAL documentation. Note that these are written for the C API, so function names and argument type names will differ.

julia> using GDAL

help?> GDAL.creategeometry
  OGR_G_CreateGeometry(OGRwkbGeometryType eGeometryType) -> OGRGeometryH

  Create an empty geometry of desired type.

     Parameters
    ––––––––––––

    •  eGeometryType: the type code of the geometry to be created.

     Returns
    –––––––––

  handle to the newly create geometry or NULL on failure. Should be freed with
  OGR_G_DestroyGeometry() after use.

Further usage documentation is not yet available, but the files test/tutorial_raster.jl and test/tutorial_vector.jl should provide a good hint based on the API tutorials from GDAL.org.

The bulk of this package is generated automatically by the scripts under gen/. For developer documentation regarding this process see gen/README.md.

Low-level and mid-level API

Next to the functions available in the GDAL module, there is also a submodule GDAL.C available. GDAL.C is the low-level wrapping, without any error checking, function renaming or type wrapping. If you know what you are doing and don't want this package to get in your way, use this. Currently the GDAL.C module provides a more complete wrapping, though the intention is to make the complete user facing C API available in both modules.

Troubleshooting

Missing driver to support a format

If you get an error such as the one below:

GDALError (CE_Failure, code 6):
    The SQLite driver needs to be compiled to support the SQLite SQL dialect

This means that the GDAL binaries you are using, which normally come from the GDALBuilder, are not compiled with support for the format or feature you need. GDAL is a large library with many optional dependencies which allow support for more formats. Currently the amount of formats supported is still limited, but will grow over time. Lists of available formats can be found here for rasters and here for vectors. If you need support for another format, consider making an issue or PR at the GDALBuilder repository. Many formats need external libraries as added dependencies. This means a BinaryBuilder repository also needs to be available for that library, and added as a dependency.

Using the GDAL and OGR utilities

The provided GDAL installation also contains the commonly used utilities such as gdal_translate and ogr2ogr. They can be called from Julia like so:

using GDAL
run(`$(GDAL.gdalinfo_path) dem.tif`)

The GDAL.<util>_path are defined in the deps.jl file after installation.

Since GDAL 2.1's RFC59.1 most utilities are also available as functions in the library, they are implemented here and tested here. If these are used you can avoid the need for calling the binaries.

All executables listed below are included, except for the Python scripts. The Python scripts are a bit more complicated because it would require Python as a dependency. If we can optionally support them however that would be great.

If you want to use these utilities from outside julia, note that this will not work unless you set two things:

  1. The environment variable GDAL_DATA must be set to the value returned in julia by GDAL.GDAL_DATA[].
  2. Julia's Sys.BINDIR must be in your path.

Inside of julia (2) is always the case, and (1) happens on loading the GDAL module, in its __init__ function.

First Commit

10/06/2015

Last Touched

22 days ago

Commits

137 commits

Requires: