Differences
This shows you the differences between two versions of the page.
Next revision | Previous revision | ||
diana:gettingstarted [2011-10-07 09:44:22] davidb Started to write a short guide to get people started with Diana. |
diana:gettingstarted [2022-05-31 09:29:31] (current) |
||
---|---|---|---|
Line 1: | Line 1: | ||
====== Getting Started ====== | ====== Getting Started ====== | ||
- | This document aims to describe what is needed to get a released version of Diana up | + | This document aims to describe what is needed to get a released version of Diana up and running on Ubuntu |
- | and running on Ubuntu from a set of Debian packages. It is assumed that you will be | + | |
- | using the version of Ubuntu that the packages were developed for. Using packages | + | |
- | with a later version of Ubuntu is slightly more complicated. | + | |
- | ===== Installing | + | To build Diana for other distributions, |
- | Obtain | + | To build a batch version |
- | writing, this is [[diana_3.25|Diana | + | |
- | release. | + | |
- | You need the .deb files for diana, libfelt and libfimex. Download these to a | + | ===== Installing Packages ===== |
- | suitable location on your system. In a terminal, type the following to install | + | |
- | them: | + | |
- | < | + | Obtain a set of release |
- | sudo dpkg -i libfelt-0.28-0_0.28-2_i386.deb libfimex-0.28-0_0.28-2_i386.deb diana_3.25.0-ubuntu3_i386.deb | + | |
- | </ | + | |
- | + | ||
- | ===== Installing Data Files ===== | + | |
- | + | ||
- | From the same page as the packages, download | + | |
- | '' | + | |
- | + | ||
- | Choose a suitable location for installation. The default configuration file | + | |
- | specifies ''/ | + | |
- | '' | + | |
- | the archives in that directory. | + | |
- | + | ||
- | < | + | |
- | cd / | + | |
- | tar zxf / | + | |
- | tar zxf / | + | |
- | </ | + | |
- | + | ||
- | Alternatively, | + | |
- | Diana' | + | |
===== Configuring Diana ===== | ===== Configuring Diana ===== | ||
Line 45: | Line 17: | ||
* The current directory. | * The current directory. | ||
* '' | * '' | ||
- | * ''/ | ||
- | Possibly the easiest way to arrange this is to run Diana without | + | If you built and installed |
- | file then immediately quit. This will cause the '' | + | |
- | in the user's home directory. Then copy the ''/ | + | * ''/ |
- | that directory for further configuration. | + | |
If you installed the maps and demo data in a location other than the default, | If you installed the maps and demo data in a location other than the default, | ||
Line 62: | Line 32: | ||
</ | </ | ||
+ | This means that you need to have a '' | ||
+ | edit it. Possibly the easiest way to arrange this is to run Diana without a '' | ||
+ | file then immediately quit. This will cause the '' | ||
+ | in the user's home directory. Then copy the ''/ | ||
+ | (or the correct one for the version you are using) into that directory for further | ||
+ | configuration. | ||
+ | |||
+ | ===== Testing with bdiana ===== | ||
+ | |||
+ | It is useful to test that the basic installation works correctly, particularly on headless systems that only allow '' | ||
+ | |||
+ | < | ||
+ | buffersize=800x800 | ||
+ | output=PNG | ||
+ | filename=test.png | ||
+ | |||
+ | PLOT | ||
+ | MAP backcolour=117: | ||
+ | AREA proj4string=" | ||
+ | ENDPLOT | ||
+ | </ | ||
+ | |||
+ | Process the input file using a command like the following, using the appropriate executable and setup file for your configuration: | ||
+ | |||
+ | < | ||
+ | bdiana -i test.input -s diana.setup | ||
+ | </ | ||
+ | |||
+ | A file called '' | ||
+ | |||
+ | {{diana: | ||
+ | |||
+ | If the file is not created or the image is blank, check the output from '' | ||
+ | |||
+ | You can also find more input files to test in the [[https:// | ||
===== Running Diana ===== | ===== Running Diana ===== | ||