Differences
This shows you the differences between two versions of the page.
diana:gettingstarted [2015-11-25 14:17:28] davidb |
diana:gettingstarted [2022-05-31 09:29:31] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Getting Started ====== | ||
- | This document aims to describe what is needed to get a released version of Diana up and running on Ubuntu 12.04 (Precise) from a set of Debian packages. It is assumed that you will be using the version of Ubuntu that the packages were developed for. | ||
- | |||
- | To build Diana for other distributions, | ||
- | |||
- | To build a batch version of Diana for headless systems, install '' | ||
- | |||
- | ===== Installing Packages ===== | ||
- | |||
- | Obtain a set of release packages for the current release of Diana. Follow the instructions on the [[Installing Diana from Launchpad]] page. | ||
- | |||
- | ===== Installing Data Files ===== | ||
- | |||
- | From the same page as the packages, download the maps and demo data archives, | ||
- | [[ftp:// | ||
- | |||
- | 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 ===== | ||
- | |||
- | Diana expects to find a '' | ||
- | |||
- | * The current directory. | ||
- | * '' | ||
- | * ''/ | ||
- | |||
- | 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 ''/ | ||
- | that directory for further configuration. | ||
- | |||
- | If you installed the maps and demo data in a location other than the default, | ||
- | you will need to change the '' | ||
- | file. For example, if these resources were unpacked in the ''/ | ||
- | directory, these lines need to be changed to read: | ||
- | |||
- | < | ||
- | OPDATA | ||
- | MAPDIR | ||
- | </ | ||
- | |||
- | ===== Testing ===== | ||
- | |||
- | 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-3.35 -i test.input -s diana.setup | ||
- | </ | ||
- | |||
- | A file called '' | ||
- | |||
- | {{: | ||
- | |||
- | If the file is not created or the image is blank, check the output from '' | ||
- | |||
- | ===== Running Diana ===== | ||
- | |||
- | Run Diana using either the '' | ||
- | The '' | ||
- | address for bug reports. If you want to avoid this, run the '' | ||
- | executable instead. | ||
- | |||
- | If you have created a '' | ||
- | those mentioned above then you need to pass an option on the command line | ||
- | to specify where it is. | ||
- | |||
- | < | ||
- | diana -s / | ||
- | </ | ||
- | |||
- | The path specified must be an absolute path. |