Differences

This shows you the differences between two versions of the page.

--- 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 ======
-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 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.
-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 Packages =====
+To build Diana for other distributions, see the [[autotools|Building Metlibs and Diana with Autotools]] page for an installation guide then continue reading the [[Installing Data Files]] page.
-Obtain a set of release packages for the current release of Diana. At the time of
+To build a batch version of Diana for headless systems, install ''bdiana'' according to the instructions on the [[batch_diana_on_headless_systems|Batch Diana on Headless Systems]] page then continue reading the [[Installing Data Files]] page.
-writing, this is [[diana_3.25|Diana 3.25]] but check the main page for a later
-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:
-<code>
+Obtain a set of release packages for the current release of Diana. Follow the instructions on the [[Installing Diana from Launchpad]] page to install and test the packages.
-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
-</code>
-===== Installing Data Files =====
-From the same page as the packages, download the maps and demo data archives,
-''diana_maps.tar.gz'' and ''diana_demodata.tar.gz'' respectively.
-Choose a suitable location for installation. The default configuration file
-specifies ''/usr/share/diana'' as the directory to contain the ''maps'' and
-''demodata'' directories supplied by the archives, so you may want to unpack
-the archives in that directory.
-<code>
-cd /usr/share/diana
-tar zxf /path/to/diana_maps.tar.gz
-tar zxf /path/to/diana_demodata.tar.gz
-</code>
-Alternatively, you can unpack the archives in another directory and modify
-Diana's configuration file to refer to their locations.
 ===== Configuring Diana =====
@@ Line 45: / Line 17: @@
   * The current directory.
   * ''$HOME/.diana/diana.setup'' or equivalent
-  * ''/etc/diana/diana.setup-COMMON''
-Possibly the easiest way to arrange this is to run Diana without a ''diana.setup''
+If you built and installed Diana 3.39 from source, or installed a package from Launchpad, there should also be a setup file in the following location:
-file then immediately quit. This will cause the ''.diana'' directory to be created
-in the user's home directory. Then copy the ''/etc/diana/diana.setup'' file into
+  * ''/etc/diana/3.39/diana.setup''
-that directory for further configuration.
 If you installed the maps and demo data in a location other than the default,
@@ Line 62: / Line 32: @@
 </code>
+This means that you need to have a ''diana.setup'' file in a place where you can
+edit it. Possibly the easiest way to arrange this is to run Diana without a ''diana.setup''
+file then immediately quit. This will cause the ''.diana'' directory to be created
+in the user's home directory. Then copy the ''/etc/diana/3.39/diana.setup'' file
+(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 ''bdiana'' to run. Copy the following text into a file called ''test.input'':
+<code>
+buffersize=800x800
+output=PNG
+filename=test.png
+PLOT
+MAP backcolour=117:199:242 map=Gshhs-Auto contour=on cont.colour=black cont.linewidth=1 cont.linetype=solid cont.zorder=1 land=on land.colour=240:158:92
+AREA proj4string="+proj=ortho +lat_0=60" rectangle=-1500000.000000:1500000.000000:-1250000.000000:1750000.000000
+ENDPLOT
+</code>
+Process the input file using a command like the following, using the appropriate executable and setup file for your configuration:
+<code>
+bdiana -i test.input -s diana.setup
+</code>
+A file called ''test.png'' should be created that looks like the following image:
+{{diana:test.png?|}}
+If the file is not created or the image is blank, check the output from ''bdiana'' to determine whether the ''diana.setup'' file and map files were found correctly.
+You can also find more input files to test in the [[https://github.com/metno/diana-extras|diana-extras]] repository on GitHub. The files can be found in the [[https://github.com/metno/diana-extras/tree/master/testfiles/input|testfiles/input]] directory.
 ===== Running Diana =====