Thursday November 13, 2014

Last Updated: Thursday November 13, 2014

Last Change : Thursday November 13, 2014

3.9. A practical case: Building QGIS and GRASS from source on Ubuntu with ECW and MrSID formats support

Required build deps:

to apt and only concern ourselves with coding QGIS!

/!\ Note: Refer to the section Building Debian packages for building

debian packages. Unless you plan to develop on QGIS, that is probably the

easiest option to compile and install QGIS.

The packages qgis depends on to build are available in the "universe" component

1. Edit your /etc/apt/sources.list file.

Also you will need to be running (K)Ubuntu 'edgy' or higher in order for

sudo apt-get update

/!\ A Special Note: If you are following this set of instructions on

a system where you already have Qt3 development tools installed, there will

be a conflict between Qt3 tools and Qt4 tools. For example, qmake will

point to the Qt3 version, not the Qt4. Ubuntu Qt4 and Qt3 packages are

designed to live alongside each other. This means that, for example, if you

have them both installed, you will have three qmake exe's:

/usr/bin/qmake -> /etc/alternatives/qmake

/usr/bin/qmake-qt3

/usr/bin/qmake-qt4

The same applies to all other Qt binaries. You will notice above that the

canonical 'qmake' is managed by apt alternatives, so before we start to

build QGIS, we need to make Qt4 the default. To return Qt3 to default later

you can use this same process.

You can use apt alternatives to correct this so that the Qt4 version of

applications is used in all cases:

sudo update-alternatives --config qmake

sudo update-alternatives --config uic

sudo update-alternatives --config designer

sudo update-alternatives --config assistant

sudo update-alternatives --config qtconfig

sudo update-alternatives --config moc

sudo update-alternatives --config lupdate

sudo update-alternatives --config lrelease

sudo update-alternatives --config linguist

Use the simple command line dialog that appears after running each of the

above commands to select the Qt4 version of the relevant applications.

/!\ Note: For python language bindings. If your distributions ships with older

versions of SIP or PyQt4 than specified in Section 2: Overview, you will need

to build and install those packages from source if you want to include support

for python language bindings.

cd /usr/local/bin

sudo ln -s /usr/bin/ccache gcc

sudo ln -s /usr/bin/ccache g++

mkdir -p ${HOME}/dev/cpp

cd ${HOME}/dev/cpp

cd ${HOME}/dev/cpp

cd ${HOME}/dev/cpp

mkdir -p ${HOME}/apps

When you run ccmake (note the .. is required!), a menu will appear where

and 'g' to generate the make files. Note that sometimes 'c' needs to

After the 'g' generation is complete, press 'q' to exit the ccmake

also create debian package. This is done from the qgis root directory, where

dch -l ~lucid --force-distribution --distribution lucid "lucid build"

3.9. A practical case: Building QGIS and GRASS from source on Ubuntu with ECW and MrSID formats support

=======================================================================================================

The following procedure has been tested on Ubuntu 8.04, 8.10 and 9.04 32bit. If

you want to use different versions of the software (gdal, grass, qgis), just

make the necessary adjustments to the following code. This guide assumes that

you don't have installed any previous version of gdal, grass and qgis.

3.9.1. Step 1: install base packages

====================================

First you need to install the necessary packages required to download the source

code and compile it. Open the terminal and issue the following command:

sudo apt-get install build-essential g++ subversion

3.9.2. Step 2: compile and install the ecw libraries

====================================================

Go to the ERDAS web site http://www.erdas.com/ and follow the links

"'products --> ECW JPEG2000 Codec SDK --> downloads'"

then download the "'Image Compression SDK Source Code 3.3'" (you'll need to make a registration

and accept a license).

Uncompress the archive in a proper location (this guide assumes

that all the downloaded source code will be placed in the user home)

and the enter the newly created folder

cd /libecwj2-3.3

Compile the code with the standard commands

./configure

then

make

then

sudo make install

leave the folder

cd ..

3.9.3. Step 3: download the MrSID binaries

==========================================

Go to the LIZARDTECH web site http://www.lizardtech.com/ and follow the links

"'download --> Developer SDKs'",

then download the "'GeoExpress SDK for Linux (x86) - gcc 4.1 32-bit'"

(you'll need to make a registration and accept a license).

Uncompress the downloaded file. The resulting directory name should be similar to "Geo_DSDK-7.0.0.2167"

3.9.4. Step 4: compile and install the gdal libraries

=====================================================

Download the latest gdal source code

svn checkout https://svn.osgeo.org/gdal/trunk/gdal gdal

then copy a few files from the MrSID binaries folder to the folder with the gdal source code

('replace "USERNAME" with your actual account username')

cp /home/USERNAME/Geo_DSDK-7.0.0.2167/include/*.* /home/USERNAME/gdal/frmts/mrsid/

enter the gdal source code folder

cd /gdal

and run configure with a few specific parameters

./configure --without-grass --with-mrsid=../Geo_DSDK-7.0.0.2167 --without-jp2mrsid

at the end of the configuration process you should read something like

...

GRASS support: no

...

...

...

ECW support: yes

MrSID support yes

...

then compile normally

make

and

sudo make install

finish the process by creating the necessary links to the most recent shared libraries

sudo ldconfig

at this point you may want to check if gdal was compiled correctly with MrSID and ECW

support by issuing one (or both) of the following commands

gdalinfo --formats | grep 'ECW'

gdalinfo --formats | grep 'SID'

leave the folder

cd ..

3.9.5. Step 5: compile and install GRASS

========================================

Before downloading and compile GRASS source code you need to install a few

other libraries and programs. We can do this through apt

sudo apt-get install flex bison libreadline5-dev libncurses5-dev lesstif2-dev \

debhelper dpatch libtiff4-dev tcl8.4-dev tk8.4-dev fftw-dev xlibmesa-gl-dev \

libfreetype6-dev autoconf2.13 autotools-dev libgdal1-dev proj libjpeg62-dev \

libpng12-dev libpq-dev unixodbc-dev doxygen fakeroot cmake python-dev \

python-qt4-common python-qt4-dev python-sip4 python2.5-dev sip4 libglew1.5-dev \

libxmu6 \ libqt4-dev libgsl0-dev python-qt4 swig python-wxversion \

python-wxgtk2.8 libwxgtk2.8-0 libwxbase2.8-0 tcl8.4-dev tk8.4-dev tk8.4 \

libfftw3-dev libfftw3-3

At this point we can get the GRASS source code: you may want to download it

through svn or maybe you want just to download the latest available source code

archive. For example the GRASS 6.4rc4 is available at

http://grass.itc.it/grass64/source/grass-6.4.0RC4.tar.gz

Uncompress the archive, enter the newly created folder and run configure with a few specific parameters

CFLAGS="-fexceptions" ./configure \

--with-tcltk-includes=/usr/include/tcl8.4 \

--with-proj-share=/usr/share/proj \

--with-gdal=/usr/local/bin/gdal-config \

--with-python=/usr/bin/python2.5-config

The additional gcc option -fexceptions is necessary to enable exceptions

support in GRASS libraries. It is currently the only way to avoid QGIS crashes

if a fatal error happens in GRASS library. See also

http://trac.osgeo.org/grass/ticket/869

Then as usual (it will take a while)

make

and

sudo make install

leave the folder

cd ..

you have now compiled and installed GRASS (also with the new wxpyhton interface) so you

may want to give it a try

grass64 -wxpython

3.9.6. Step 6: Compile and install QGIS

=======================================

As for GRASS you can obtain the QGIS source code from different sources as described

in section 2 above. Once you have the sources, create a build directory in them:

cd QGIS

mkdir build

cd build

then run ccmake

ccmake ..

Press the "c" key to do an initial configure.

Press the "c" again and the option "Press [g] to generate and exit" will appear.

Press the "g" key to generate and exit.

then as usual (it will take a while)

make

and

sudo make install

At the end of the process you should have QGIS and GRASS working with MrSID and ECW

raster format support.

To run QGIS just use this command

qgis

to apt and only concern ourselves with coding QGIS!

/!\ **Note:** Refer to the section ''Building Debian packages'' for building

debian packages. Unless you plan to develop on QGIS, that is probably the

easiest option to compile and install QGIS.

The packages qgis depends on to build are available in the "universe" component

+ Edit your /etc/apt/sources.list file.

Also you will need to be running (K)Ubuntu 'edgy' or higher in order for

```

sudo apt-get update

/!\ **A Special Note:** If you are following this set of instructions on

a system where you already have Qt3 development tools installed, there will

be a conflict between Qt3 tools and Qt4 tools. For example, qmake will

point to the Qt3 version, not the Qt4. Ubuntu Qt4 and Qt3 packages are

designed to live alongside each other. This means that, for example, if you

have them both installed, you will have three qmake exe's:

```

/usr/bin/qmake -> /etc/alternatives/qmake

/usr/bin/qmake-qt3

/usr/bin/qmake-qt4

```

The same applies to all other Qt binaries. You will notice above that the

canonical 'qmake' is managed by apt alternatives, so before we start to

build QGIS, we need to make Qt4 the default. To return Qt3 to default later

you can use this same process.

You can use apt alternatives to correct this so that the Qt4 version of

applications is used in all cases:

```

sudo update-alternatives --config qmake

sudo update-alternatives --config uic

sudo update-alternatives --config designer

sudo update-alternatives --config assistant

sudo update-alternatives --config qtconfig

sudo update-alternatives --config moc

sudo update-alternatives --config lupdate

sudo update-alternatives --config lrelease

sudo update-alternatives --config linguist

```

Use the simple command line dialog that appears after running each of the

above commands to select the Qt4 version of the relevant applications.

/!\ Note: For python language bindings. If your distributions ships with older

versions of SIP or PyQt4 than specified in Section 2: Overview, you will need

to build and install those packages from source if you want to include support

for python language bindings.

```

cd /usr/local/bin

sudo ln -s /usr/bin/ccache gcc

sudo ln -s /usr/bin/ccache g++

```

mkdir -p ${HOME}/dev/cpp

cd ${HOME}/dev/cpp

```

cd ${HOME}/dev/cpp

```

cd ${HOME}/dev/cpp

```

mkdir -p ${HOME}/apps

When you run ccmake (note the .. is required!), a menu will appear where

and 'g' to generate the make files. Note that sometimes 'c' needs to

After the 'g' generation is complete, press 'q' to exit the ccmake

```

also create debian package. This is done from the qgis root directory, where

dch -l ~lucid --force-distribution --distribution lucid "lucid build"

== A practical case: Building QGIS and GRASS from source on Ubuntu with ECW and MrSID formats support ==

The following procedure has been tested on Ubuntu 8.04, 8.10 and 9.04 32bit. If

you want to use different versions of the software (gdal, grass, qgis), just

make the necessary adjustments to the following code. This guide assumes that

you don't have installed any previous version of gdal, grass and qgis.

=== Step 1: install base packages ===

First you need to install the necessary packages required to download the source

code and compile it. Open the terminal and issue the following command:

```

sudo apt-get install build-essential g++ subversion

```

=== Step 2: compile and install the ecw libraries ===

Go to the ERDAS web site http://www.erdas.com/ and follow the links

"'''products --> ECW JPEG2000 Codec SDK --> downloads'''"

then download the "'''Image Compression SDK Source Code 3.3'''" (you'll need to make a registration

and accept a license).

Uncompress the archive in a proper location (this guide assumes

that all the downloaded source code will be placed in the user home)

and the enter the newly created folder

```

cd /libecwj2-3.3

```

Compile the code with the standard commands

```

./configure

```

then

```

make

```

then

```

sudo make install

```

leave the folder

```

cd ..

```

=== Step 3: download the MrSID binaries ===

Go to the LIZARDTECH web site http://www.lizardtech.com/ and follow the links

"'''download --> Developer SDKs'''",

then download the "'''GeoExpress SDK for Linux (x86) - gcc 4.1 32-bit'''"

(you'll need to make a registration and accept a license).

Uncompress the downloaded file. The resulting directory name should be similar to "Geo_DSDK-7.0.0.2167"

=== Step 4: compile and install the gdal libraries ===

Download the latest gdal source code

```

svn checkout https://svn.osgeo.org/gdal/trunk/gdal gdal

```

then copy a few files from the MrSID binaries folder to the folder with the gdal source code

('''replace "USERNAME" with your actual account username''')

```

cp /home/USERNAME/Geo_DSDK-7.0.0.2167/include/*.* /home/USERNAME/gdal/frmts/mrsid/

```

enter the gdal source code folder

```

cd /gdal

```

and run configure with a few specific parameters

```

./configure --without-grass --with-mrsid=../Geo_DSDK-7.0.0.2167 --without-jp2mrsid

```

at the end of the configuration process you should read something like

```

...

GRASS support: no

...

...

...

ECW support: yes

MrSID support yes

...

```

then compile normally

```

make

```

and

```

sudo make install

```

finish the process by creating the necessary links to the most recent shared libraries

```

sudo ldconfig

```

at this point you may want to check if gdal was compiled correctly with MrSID and ECW

support by issuing one (or both) of the following commands

```

gdalinfo --formats | grep 'ECW'

```

```

gdalinfo --formats | grep 'SID'

```

leave the folder

```

cd ..

```

=== Step 5: compile and install GRASS ===

Before downloading and compile GRASS source code you need to install a few

other libraries and programs. We can do this through apt

```

sudo apt-get install flex bison libreadline5-dev libncurses5-dev lesstif2-dev \

debhelper dpatch libtiff4-dev tcl8.4-dev tk8.4-dev fftw-dev xlibmesa-gl-dev \

libfreetype6-dev autoconf2.13 autotools-dev libgdal1-dev proj libjpeg62-dev \

libpng12-dev libpq-dev unixodbc-dev doxygen fakeroot cmake python-dev \

python-qt4-common python-qt4-dev python-sip4 python2.5-dev sip4 libglew1.5-dev \

libxmu6 \ libqt4-dev libgsl0-dev python-qt4 swig python-wxversion \

python-wxgtk2.8 libwxgtk2.8-0 libwxbase2.8-0 tcl8.4-dev tk8.4-dev tk8.4 \

libfftw3-dev libfftw3-3

```

At this point we can get the GRASS source code: you may want to download it

through svn or maybe you want just to download the latest available source code

archive. For example the GRASS 6.4rc4 is available at

http://grass.itc.it/grass64/source/grass-6.4.0RC4.tar.gz

Uncompress the archive, enter the newly created folder and run configure with a few specific parameters

```

CFLAGS="-fexceptions" ./configure \

--with-tcltk-includes=/usr/include/tcl8.4 \

--with-proj-share=/usr/share/proj \

--with-gdal=/usr/local/bin/gdal-config \

--with-python=/usr/bin/python2.5-config

```

The additional gcc option -fexceptions is necessary to enable exceptions

support in GRASS libraries. It is currently the only way to avoid QGIS crashes

if a fatal error happens in GRASS library. See also

http://trac.osgeo.org/grass/ticket/869

Then as usual (it will take a while)

```

make

```

and

```

sudo make install

```

leave the folder

```

cd ..

```

you have now compiled and installed GRASS (also with the new wxpyhton interface) so you

may want to give it a try

```

grass64 -wxpython

```

=== Step 6: Compile and install QGIS ===

As for GRASS you can obtain the QGIS source code from different sources as described