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.
Other packages can build on top of this to provide a more Julian user experience. See for example ArchGDAL.jl.
Most users will want to use ArchGDAL.jl instead of using GDAL.jl directly.
This package is registered, so add it using
Pkg. This will also download GDAL binaries
created in Yggdrasil.
pkg> add GDAL
To check if it is installed correctly, you could run the test suite with:
pkg> test GDAL
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.ogr_g_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 OGRGDestroyGeometry() after use.
The bulk of this package is generated automatically by the scripts under
The provided GDAL installation also contains the commonly used utilities such as
ogr2ogr. They can be called from Julia like so:
using GDAL # list information about a raster dataset GDAL.gdalinfo_path() do gdalinfo run(`$gdalinfo path/to/raster-file`) end # convert raster data between different formats GDAL.gdal_translate_path() do gdal_translate run(`$gdal_translate -of COG input.asc output.tif`) end # list information about an OGR-supported data source GDAL.ogrinfo_path() do ogrinfo run(`$ogrinfo path/to/vector-file`) end # convert simple features data between file formats GDAL.ogr2ogr_path() do ogr2ogr run(`$ogr2ogr -f FlatGeobuf output.fgb input.shp`) end
GDAL.<util>_path are defined in the
GDAL_jll package. If you only wish
to run the utilities, that package will have all you need. A list of the available utilities
can be found here.
Documentation for them is available on
gdal.org/programs. Note that programs implemented in
python (ending in .py) are not available, since those would require a python installations.
If you want to use these utilities from outside julia, note that this will not work unless you set two things:
GDAL_DATAmust be set to the value returned in julia by
Sys.BINDIRmust be in your path.
Inside of julia (2) is always the case, and (1) happens on loading the
GDAL module, in its
If you get an error such as the one below:
GDALError (CE_Failure, code 6): The <...> driver needs to be compiled to support <...>
This means that the GDAL binaries you are using, which normally come from the Yggdrasil community build tree, 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 in this repository. Many formats need external libraries as added dependencies. This means an Yggdrasil build also needs to be available for that library, and added as a dependency. See issue #65 for a discussion on which new drivers should be prioritized.