Skip to content

Latest commit

 

History

History
326 lines (208 loc) · 8.34 KB

install.rst

File metadata and controls

326 lines (208 loc) · 8.34 KB
Raw

Installation Guide GeoEasy 3

GeoEasy can be used on any Window/Linux box. There are no special requirements for the hardware.

Supported operating systems

  • Windows XP/2000/7/8/10 32 or 64 bit
  • Linux with X11 Ubuntu/Fedora/Debian 64 bit
  • OSX
  • Android (experimental)

Windows Installation

Windows binary release

To install binary release on your Windows machine download the installer from http://digikom.hu/english/geo_easy_e.html, it is generated by NSIS (Nullsoft Scriptable Install System), an open source installation kit generator for Windows.

Start the installer (Gizi3xxSetup.exe). First you have to select the language for installation (English, German, Hungarian).

images/install1.png

Select installation language

After selecting the language for installation a setup wizard starts. In the first dialog read and accept the license agreement.

images/install2.png

Accept license agreement

In the second dialog select the target folder for the installation. Please do not choose an installation path, which contains space or special characters.

images/install3.png

Select target folder and start installation

In the last dialog you can start the installation process.

images/install4.png

Exit wizard

After successful installation the GeoEasy icon can be found on the desktop and in the programs menu.

images/icon.png

GeoEasy icon

Windows portable release

There is a portable Windows zip file. It should be unzipped into a new empty folder (for example c:\GeoEasy). If you would like to export to GPX or KML format, set up an environment variable PROJ_LIB to the root directory of GeoEasy.

setx PROJ_LIB=C:\GeoEasy

Linux Installation (Ubuntu)

Prerequisites

Install tcl/tk on your platform (https://www.tcl.tk/software/tcltk/)

sudo apt-get install tcl tk

Install tcllib and libtk-img on your platform (libtk-img is optional used to png export in graphic window.

sudo apt-get install tcllib libtk-img

Install proj (https://proj4.org)

sudo apt-get install proj-bin

Install GNU Gama (https://www.gnu.org/software/gama/) There is no binary package for Ubuntu, make it from source.

Install Triangle (https://github.com/MrPhil/Triangle)

sudo apt-get install triangle-bin

Debian package

There is a Debian package for Debian/Ubuntu Linux distributions which can be downloaded from http://digikom.hu/english/geo_easy_e.html, it is a standard Debian package (geoeasy*version*-wheezy_all.deb). You can use the package manager to install it (right click on the file in the file manager or use dpkg)

sudo dpkg -i geoeasy*version*-wheezy_all.deb

To start GeoEasy select it from the menu or type in the terminal window:

geoeasy

The Debian install package was created by https://github.com/zvezdochiot.

Ubuntu binary release

There is a compressed Linux binary release which can be downloaded from http://digikom.hu/english/geo_easy_e.html, it is a simple tar-gzip (Gizi*version*Linux.tgz) file. The following commands have to be executed (it is supposed the tgz file is downloaded into your home directory):

mkdir GeoEasy
cd GeoEasy
tar xvzf ../Gizi3xxLinux.tgz

You can start GeoEasy from the installation directory using the command:

cd ~/GeoEasy
./GeoEasy

You can create a shell script file to start GeoEasy from any directory.

pushd ~/GeoEasy
./GeoEasy
popd

Copy this file into a directory on the PATH.

Install source release (Ubuntu)

Download the source files from GitHub (github.com/zsiki/GeoEasy) either the zip file or git clone the repository. If you would like to update your version regularly, then the git clone should be preferred.

git clone https://github.com/zsiki/GeoEasy.git

This will install the latest development version. If you want to install the stabile version select a zip or tgz file from the https://github.com/zsiki/GeoEasy/tags page. Change directory to GeoEasy/src and run the following commands from the command line, to prepare it.

cd GeoEasy/src
make source
chmod +x geo_easy.tcl

Make a symbolic link from the GeoEasy/src directory to the external programs.

cd GeoEasy/src
ln -s /usr/bin/cs2cs cs2cs
ln -s /usr/local/bin/gama-local gama-local
ln -s /usr/bin/triangle triangle

Alternatively you can change the path to these programs in the geo_easy.msk file.

set gamaProg {/usr/local/bin/gama-local/gama-local}
...
set triangleProg {/usr/bin/triangle}
...
set cs2csProg {/usr/bin/cs2cs}

Or if the commands are on the PATH input only the name of the commands in the geo_easy.msk file.

set gamaProg {gama-local}
...
set triangleProg {triangle}
...
set cs2csProg {cs2cs}

Note

The path to the external program may be different, depending on your settings and Linux distro.

To start the program use the following command from the src directory:

cd GeoEasy/src
wish geo_easy.tcl

or

cd GeoEasy/src
./geo_easy.tcl

To update to the actual master on GitHub simply git pull it, from the GeoEasy directory.

cd GeoEasy
git pull

The preparation should be repeated (make source).

OSX (Machintosh) installation

Usually Tcl/Tk, the necessary programming language is installed on OSX. Please check it from a terminal window.

wish

After this you should see a small empty graphic window in the upper left part of the screen and the prompt in the terminal window is changed to %. Press CTLR/D in the terminal window to exit or close the small graphic window.

For Machintosh there is no binary release. You can use only use the source release. Open a terminal window, change your current directory where you would like to install the software and type the following commands:

git clone https://github.com/zsiki/GeoEasy.git
cd GeoEasy/src
make source
wish geo_easy.tcl

This will install the latest development version. If you want to install the stabile version select a zip or tgz file from the https://github.com/zsiki/GeoEasy/tags page. The last wish command starts the application. If you would like you start it again open a terminal window and change to the installation directory and enter

wish geo_easy.tcl

The menus of the program are in the main menu bar, see the screenshot below.

images/osx.png

GeoEasy on Machintosh (thanks to Marco Kukavicic)

You can create a small script to automate the startup process.

Note

To have the external tools, like GNU Gama, Triangle, etc. you should install those programs as it is documented in the Ubuntu source install section.

Android Installation

Prerequisites

AndroWish installation. Download Android package signed with debug key: http://www.androwish.org/download/AndroWish-6e2085e6e4-debug.apk

In your Android setting allow packages from unknown sources (in Setting/Security) before installing AndroWish.

Installation

Create on your Android device a new folder called GeoEasy. Copy the following files/folders from the source tree:

  • GeoEasy.tcl (this file is created during make)
  • geo_easy.msk
  • i18n (folder)
  • bitmaps (folder)
  • demodata (folder, optional)

Open the GeoEasy.tcl file with AndroWish. You can use the menu in the tcl console window or write the following commands into the console window:

cd /sdcard/GeoEasy
source GeoEasy.tcl

You'll get warnings about DTM and Network adjustment modules. These modules are not available on Android yet .

Note

The log file is written to the env(HOME) folder. Use "global env; puts $env(HOME)" command to print the path to geo_easy.log file. Use "global env; cat $env(HOME)/geo_easy.log" to list the content of the log in the wish console.