terrain db software key features

8/8/2019 Terrain DB Software Key Features

1/44

Terrain DBTM

2008/05/27

Page 1 of 44

SOFTWARE MANUAL

Terrain DBTM

2008


2/44

Terrain DBTM

2008/05/27

Page 2 of 44

Table of contents

Contents

1 Introduction ................................................................................................................... 31.1 Overview ................................................................................................................ 31.2 System Requirements ............................................................................................ 31.3 Installation .............................................................................................................. 31.4 Conventions used in th is manual ........................................................................... 4

2 Getting started .............................................................................................................. 52.1 Starting the software .............................................................................................. 52.2 Database content - Datasets .................................................................................. 6

3 Adding terrain data ....................................................................................................... 84 Extracting terrain data................................................................................................. 21

4.1 Configure terrain data extraction parameters ....................................................... 235 Managing code lists .................................................................................................... 28

5.1 Add code l ist item ................................................................................................. 295.2 Edit code list item ................................................................................................. 295.3 Delete code list item ............................................................................................. 30

6 Managing responsible parties ..................................................................................... 316.1 Add responsible party .......................................................................................... 31

6.1.1 Add responsible party address ...................................................................... 326.1.2 Edit responsible party address ...................................................................... 336.1.3 Delete responsible party address .................................................................. 34

6.2 Edit responsible party ........................................................................................... 356.3 Delete responsible party....................................................................................... 35

7 Managing users .......................................................................................................... 367.1 Add user ............................................................................................................... 377.2 Edit user ............................................................................................................... 387.3 Delete user ........................................................................................................... 39

8 Configuring server and database connections ............................................................ 398.1 New server ........................................................................................................... 408.2 Edit server ............................................................................................................ 418.3 Delete server ........................................................................................................ 41

9 Terrain DB Technical Reference................................................................................. 439.1 File menu ............................................................................................................. 43

9.1.1 Exit................................................................................................................. 439.2 Data menu............................................................................................................ 43

9.2.1 Add Dataset ................................................................................................... 439.2.2 Extract elevation data .................................................................................... 439.2.3 Responsible parties ....................................................................................... 439.2.4 Manage code lists .......................................................................................... 43

9.3 User menu............................................................................................................ 449.3.1 Manage users ................................................................................................ 44

9.4 Help menu ............................................................................................................ 449.4.1 Manual ........................................................................................................... 449.4.2 About ............................................................................................................. 44


3/44

Terrain DBTM

2008/05/27

Page 3 of 44

1 IntroductionWelcome to the Terrain DBTM software manual. This document provides a completereference for using and understanding the software package. It is intended to help you

get started and to illustrate the methods and procedures involved in populating, viewingand managing your own terrain database.

The manual is divided into several sections. The first section, Getting Started describeshow to start the application and the layout of the application. The next few sections eachdescribe how to work with the main features of this application. The final section has adescription of all the menu items within Terrain DBTM.

1.1 Overview

The Terrain DBTM software provides you with a user friendly yet powerful

Application to view and manage the data stored within your datasets. The applicationutilizes the client server application architecture, which means that any number ofdatabases can be managed from a single client installation. Terrain DBTM provides all

the functionality that you require to manage the data stored in the database, includinghow to add, view and extract data to and from a variety of file formats.

1.2 System Requirements

The minimum software and hardware requirements to install and run Terrain DBTM are:

Hardware Requirements Minimum (Recommended):

2048MB 800MHz Dual Channel DDR2 SDRAM Dual Core Processor 3.00GHz

500GB (7200rpm) Serial ATA/100 Hard Drive

ASUS EN8500GT Silent 512Mb DDR 3 graphics card (or equivalent)

Gigabit LAN connection

17 Monitor

Mouse

QWERTY keyboard

Software Requirements:

Windows XP (SP2)

1.3 Installation

To Install Terrain DBTM

1. Insert the Terrain DBTMCD into your computers CD-ROM drive. The installation

Wizard will start automatically. If the Wizard does not open automatically, youcan use the setup.exe at the root of the CD instead.

2. Click Next to start the installation.


4/44

Terrain DBTM

2008/05/27

Page 4 of 44

3. In the Select Installation Folder screen you may choose a location to installTerrain DBTM. Click the Browsebutton to create or choose any folder on a harddisk with at least 100 megabytes of free disk space. Click Next to proceed to thenext step.

4. Click Next to start the installation and the Wizard will start copying the required

files to your chosen hard disk.5. Once the setup program has finished copying all the files, click Restart Windows

if prompted to do so.

1.4 Conventions used in this manual

The following terms are used in this manual:

Click - Position the cursor pointer on an item, and then quickly press and release theleft hand mouse button. When you click the mouse button you should hear and feel afaint click.

Double-click - Position the cursor pointer on an item, and then quickly press andrelease the left hand mouse button twice. Terrain DBTM interprets this as a singlecommand.

Drag - Position the cursor pointer on an item, press and hold the left hand mouse

button, and then move the mouse.

Select - Position the cursor pointer on an item, and then click.

Choosing menu commands - For example, to choose Exit from the File menu youcan use either of the following:

i) Using the mouse, click File. A listing of all the available File commands

appears. Click the Exit command;Or

ii) Using the keyboard, press ALT+F (for File) to display the menu and typeE (for Exit).

Specific text in the manual contains the following format:

Menu commands - Menu commands are bold-faced wherever they occur in the text.

Dialog box names - Dialog box names are bold-faced wherever they occur in the text.

Dialog box options - Dialog box optionsare in italics wherever they occur in the text.


5/44

Terrain DBTM

2008/05/27

Page 5 of 44

2 Getting started

2.1 Starting the software

Navigate to the Start Button, select PROGRAMS, select Global and finallyclick on the Terrain DBoption in the menu.

Upon executing the program a panel similar to the one shown below will appear.

Select one of the the databases listed, enter a valid user name and password and clickOK to log in.

Upon successful login a panel similar to the one below will be displayed.

Figure 1: Login page


6/44

Terrain DBTM

2008/05/27

Page 6 of 44

2.2 Database content - Datasets

Terrain data is stored in the database in a series of datasets. Each time terrain data is

added to the database a new dataset is created.

A dataset is made up of two components:

1. The terrain data (latitude, longitude and height)This is the actual data that represents the terrain of the area in question. Eachrecord for the terrain data represents a single point.

2. MetadataMetadata is a series of fields that describe the terrain data. The metadata fieldsinclude information such as accuracies, acquisition methods and responsible

parties amongst many others.

When Terrain DB is running, the main working area is displayed as shown below. The

working area is divided into two panels.

Figure 2: Main window


7/44

Terrain DBTM

2008/05/27

Page 7 of 44

1. Dataset explorer Lists all the datasets stored in the database.2. Metadata viewer Displays all the details stored in the database for the

selected dataset.

Figure 3: Panels


8/44

Terrain DBTM

2008/05/27

Page 8 of 44

3 Adding terrain dataTerrain data can be added to the database from a number of different file formats. Theprocess of adding terrain data is greatly simplified by the use of the Add Dataset

Wizard. The wizard will collate all of the metadata required along with the actual terraindata and automatically insert the data into the database.

When the Data Add dataset menu is selected the wizard is started and a panelsimilar to the one shown in Figure 5 will be displayed.

To proceed, click on the Nextbutton. To cancel, click on the Cancelbutton. If the Next

button is selected a panel similar to the one shown below will appear.

Figure 4: Start "Add dataset" wizard

Figure 5: Add dataset wizard


9/44

Terrain DBTM

2008/05/27

Page 9 of 44

Each dataset should be given a name and a description that describes the dataset.You can't progress through the wizard until you have at least given the dataset a name.



Figure 6: Add dataset - Dataset details


10/44

Terrain DBTM

2008/05/27

Page 10 of 44

Figure 7: Add dataset - Responsible party

Each dataset in the database has to be associated with a responsible party. The

responsible party is the individual or organization who supplied the terrain data that isbeing added to the database.

If the responsible party is not listed then it can be added to the database. For details on

how this is done see Section 6 for more details.

Once a responsible party has been selected click on the Nextbutton to proceed.

Select the file that contains the terrain data for this dataset.

Figure 8: Add dataset - Dataset terrain data file


11/44

Terrain DBTM

2008/05/27

Page 11 of 44

All data that is added to the database must be referenced to the WGS84 coordinatereference system and all the height data should be referenced to the WGS84 ellipsoid.

Once the file has been selected click on the Nextbutton to proceed.

Select the acquisition method used to collect the data.The list of acquisition methods presented in the drop down list is a user defined list.Items can be added to the list by editing the acquisition methods code list. See section 5

for further details.

Once the acquisition method has been selected, click on the Nextbutton to proceed.

Figure 9: Add dataset - Acquisition Method


12/44

Terrain DBTM

2008/05/27

Page 12 of 44

The area of coverage is used to help identify the area covered by this dataset.

Enter some descriptive text to identify the area covered by this dataset.

Click on the Nextbutton to proceed.

Figure 10: Add dataset - Area of Coverage


13/44

Terrain DBTM

2008/05/27

Page 13 of 44

Enter the value for the post spacing in both the latitude and longitude directions.

Once the post spacing has been entered click on the Nextbutton to proceed.

Figure 11: Add dataset - Post Spacing


14/44

Terrain DBTM

2008/05/27

Page 14 of 44

Enter the details that define the horizontal accuracy of the data.

Once all the fields have been populated click on the Nextbutton to proceed.

Figure 12: Add dataset - Horizontal details


15/44

Terrain DBTM

2008/05/27

Page 15 of 44

Enter the details that define the vertical accuracy of the data.

Once all the fields have been populated click on the Nextbutton to proceed.

Figure 13: Add dataset - Vertical details


16/44

Terrain DBTM

2008/05/27

Page 16 of 44

Enter a descriptive value that describes the integrity of the dataset.

Once a value has been added, click on the Nextbutton to proceed.

Figure 14: Add dataset - Integrity


17/44

Terrain DBTM

2008/05/27

Page 17 of 44

The surface details help identify the type of surface that is covered by the dataset. Italso records the surface that the sensor used to record the height data.

The penetration level is the distance below the actual surface that has been recorded.

Both the Surface type and Recorded surface lists presented are user defined lists. Itemscan be added to either list by editing the appropriate code list. See section 5 for furtherdetails.

Once all the details have been selected, click on the Nextbutton to proceed.

Figure 15: Add dataset - Surface details


18/44

Terrain DBTM

2008/05/27

Page 18 of 44

Enter any further information into this field that is relevant to this dataset.


Figure 16: Add dataset - Additional information


19/44

Terrain DBTM

2008/05/27

Page 19 of 44

Figure 17: Add dataset - Dataset creation

Figure 18: Add dataset - Inserting data into database


20/44

Terrain DBTM

2008/05/27

Page 20 of 44

The Terrain DB will go through a number of steps, firstly to prepare the data for insertioninto the database then it will upload the data to the server where it will be processedand inserted into the database.

This can often be a long process with several different factors affecting how long it will

take to complete. These factors include the size of the dataset, the speed of the networkand the speed / load of the server at that particular time.

Once the dataset has successfully been added to the database, a page similar to theone below will be displayed.


Figure 19: Add dataset - Dataset successfully added


21/44

Terrain DBTM

2008/05/27

Page 21 of 44

Click on the Finishbutton to close the wizard.

4 Extracting terrain data

The terrain data can be extracted from Terrain DB by using the terrain extraction tool.This tool contains a Terrain Extraction Wizard that will specify the parameters that theterrain data must comply with in order to be extracted from the database.

To start the Terrain Extraction Tool click on the Data Extract elevation data menuitem.

This will display the form similar to the one shown below.

Figure 20: Add dataset - Finished

Figure 21: Extract elevationdata menu item


22/44

Terrain DBTM

2008/05/27

Page 22 of 44

From the above form you can configure the parameters used to extract terrain data fromthe database, select the format to which you would like to save the extracted terraindata and monitor the progress of the extraction process.

Once the data extraction parameters have been configured (see section 4.1 for furtherdetails) and a f ile has been selected to save the data, click on the Startbutton to

commence the extraction process.

As the extraction process progresses, details about the current step and the currentprogress are displayed within the Data extraction progresssection as shown below.

Figure 22: Extract elevation data


23/44

Terrain DBTM

2008/05/27

Page 23 of 44

4.1 Configure terrain data extraction parametersTo configure the terrain data extraction parameters, click on the Configurebutton on the

previous form. This starts a wizard that will collect all the parameters and will looksimilar to the panel shown below.

Figure 23: Extracting data progress


24/44

Terrain DBTM

2008/05/27

Page 24 of 44

To proceed, click on the Nextbutton. To cancel, click on the Cancelbutton. If the Nextbutton is selected a panel similar to the one shown below will appear.

Figure 24: Elevation data wizard -Welcome

Figure 25: Elevation data wizard - Bounding area


25/44

Terrain DBTM

2008/05/27

Page 25 of 44

Use the fields on this form to enter the maximum and minimum latitude and longitudevalues. This will define a rectangular area over which the data will be extracted.


Use the check boxes to enable a particular field on the form. If a field is left asunchecked then this field will not be used to filter the terrain data. If the field is enabledthen the value entered into either the text box or the drop down list will be used to filterthe data. For example on the above form the Acquisition methodfield is selected, this

would mean that only datasets with an acquisition method of GPS Survey would beextracted from the database.


Figure 26: Extract elevation data - Acquisition Method and Surface Types


26/44

Terrain DBTM

2008/05/27

Page 26 of 44

As with the previous form, enable the fields with which the datasets should be filtered.On this form all fields refer to the horizontal parameters of the dataset.



Figure 27: Extract elevation data - Horizontal Parameters


27/44

Terrain DBTM

2008/05/27

Page 27 of 44

As with the previous two forms, enable the fields with which the datasets should befiltered. On this form all fields refer to the vertical parameters of the dataset.



Figure 28: Extract elevation data - Vertical Parameters

Figure 29: Extract elevation data - Finished


28/44

Terrain DBTM

2008/05/27

Page 28 of 44

All the relevant parameters have now been collected, click on the Finishbutton to closethe wizard.

5 Managing code listsThere are three code lists available in Terrain DB

1. Acquisition methods2. Surface Types3. Recorded surfaces

New items can be added or existing items edited in each of the lists above.

To edit a code list select it from the Data Manage code lists menu.

Selecting one of the code lists will display a form similar to the one below.

Figure 31: Edit code list

Figure 30: Manage code lists menu


29/44

Terrain DBTM

2008/05/27

Page 29 of 44

From this form, items within the code list can be added, edited and deleted.

5.1 Add code list itemTo add a new item to the code list, click on the Addbutton on the above form. This will

display the form below.

Enter into the fields a code (name) and a description for this new code list item. Once

these values have been entered, click on the Addbutton. If the process is to beterminated click the Cancelbutton.If the OKbutton is selected, then the previous form will be displayed but will also now

include the new code list item.

5.2 Edit code list itemTo edit an existing code list item, select the item to be edited from the list and click onthe Updatebutton on the Edit code listform. This will display the form below.

Figure 32: Add code list item


30/44

Terrain DBTM

2008/05/27

Page 30 of 44

Update both the code and description field as required. Once these values have beenedited click on the Updatebutton. If the process is to be terminated click the Cancelbutton. If the Updatebutton is selected, then the previous form will be displayed but willalso now include the updated code list item details.

5.3 Delete code list itemTo remove a code list item, select the item to be deleted from the list and click on the

Deletebutton on the Edit code listform. This will display the form below.

Click on the Deletebutton to remove this code list item from the database. If theprocess is to be terminated click the Cancelbutton. If the Deletebutton is selected, thenthe previous form will be displayed but will now not include the deleted code list item.

Figure 33: Edit code list item

Figure 34: Delete code list item


31/44

Terrain DBTM

2008/05/27

Page 31 of 44

6 Managing responsible partiesTerrain DB maintains a list of responsible parties. To view and manage the list of

responsible parties select the Data Responsible parties menu item as shownbelow.

Selecting this menu item will display the form below. This form displays a list of all theresponsible parties that are currently stored in the database. From this form you can

view, add, edit and delete responsible parties.

Figure 36: Responsible parties

6.1 Add responsible partyTo add a new responsible party to the database, click the Addbutton on the aboveform. This will display the form below.

Figure 35: Responsible parties menu


32/44

Terrain DBTM

2008/05/27

Page 32 of 44

Each responsible party is made up from a name, an organisation and one or moreaddresses. Enter the name and organisation in the fields on this form. Addresses areadded, edited and deleted as described in section 6.1.1 .

Once all the fields and address(s) have been added for this new responsible party, clickon the Addbutton. If the process is to be terminated click on the Cancelbutton.

6.1.1 Add responsible party addressTo add a new address for this responsible party, click on the small Addbutton within theAddressesgroup. This will display the following form.

Figure 37: Add responsible party


33/44

Terrain DBTM

2008/05/27

Page 33 of 44

Each address is made up from a number of fields that define the address for theresponsible party. Each address can have up to three phone numbers and three emailaddresses associated with it.To add an additional phone number for this address click on the Phonebutton on theleft hand side of the form and select one of the options from the drop down list thatappears below the button, then enter the phone number in the fields provided.To add an additional email address for this address click on the Emailbutton on the left

hand side of the form and select one of the options from the drop down list that appearsbelow the button, then enter the email address in the fields provided.

Once these values have been entered click on the Addbutton. If the process is to beterminated click the Cancelbutton. If the add button is selected, then the new addressis listed in the drop down list on the previous form.

6.1.2 Edit responsible party address

To edit an existing address for a responsible party, select the address from the dropdown list and click on the small Editbutton within the Addressesgroup. This will display

the following form.

Figure 38: Add address


34/44

Terrain DBTM

2008/05/27

Page 34 of 44

Once all the fields have been updated click on the Updatebutton. If the process is to beterminated click the Cancelbutton. If the update button is selected then the updatedaddress is listed in the drop down list on the previous form.

6.1.3 Delete responsible party address

To delete an existing address for a responsible party select the address from the drop

down list and click on the small Delbutton within the Addressesgroup. This will displaythe following form.

Figure 39: Edit address

Figure 40: Delete address


35/44

Terrain DBTM

2008/05/27

Page 35 of 44

To delete this address from the responsible party click on the Deletebutton. If theprocess is to be terminated click the Cancelbutton. If the delete button is selected thenthe address is removed from the database.

6.2 Edit responsible partyTo edit an existing responsible party select the party to be edited from the list and clickon the Editbutton on the Responsible partiesform, this will display the form below.

Update the responsible parties details. Address can be added, updated and deleted asdescribed in the previous sections.

Once all the fields and addresses have been updated, click on the Updatebutton. If the

process is to be terminated click on the Cancelbutton. If the update button is selected,the responsible parties details will be updated.

6.3 Delete responsible party

To delete a responsible party from the database, select the party from the list and click

on the Deletebutton. This will display the following form.

Figure 41: Update responsible party


36/44

Terrain DBTM

2008/05/27

Page 36 of 44

Click on the Deletebutton to remove this responsible party from the database. If theprocess is to be terminated click the Cancelbutton. If the Deletebutton is selected thenthe previous form will be displayed but will now not include the deleted responsibleparty.

7 Managing usersTerrain DB maintains a list of users for each database. Each user is primarily made up

from a user name, password and a set of permissions. The user name and passwordare used to log into the database whilst the permissions determine what actions thatuser is able to perform once logged on.

There are currently two sets of permissions that a user can have:l Edit users: The user is able to add, edit and delete users from the database.l Edit datasets: The user is able to add and delete datasets to the database.

A user can have any combination of the above permissions including having neither ofthem. If a user has neither of these permissions set, then they are able to log onto the

system but they are only able to view and download data.

To view and manage the list of users select the User Manage users menu item asshown below.

Figure 42: Delete responsible party


37/44

Terrain DBTM

2008/05/27

Page 37 of 44

Selecting this menu item will display the form below. This form displays a list of all theusers that are currently stored in the database. From this form you can view, add, editand delete users.

Figure 44: Manage users form

7.1 Add user

To add a new user to the database click on the Addbutton on the above form, this willdisplay the form below.

Figure 43: Manage users menuoption


38/44

Terrain DBTM

2008/05/27

Page 38 of 44

Use the edit boxes and check boxes to enter the details for the new user being created.Once these parameters have been selected, click the Addbutton. If the process is to be

terminated click the Cancelbutton. If the Addbutton is selected then the previous formwill be displayed containing the new users details.

7.2 Edit user

To edit an existing user, select the user to be edited from the list and click on the Editbutton on the Manage usersform. This will display the form below.

Figure 45: Add user

Figure 46: Edit user


39/44

Terrain DBTM

2008/05/27

Page 39 of 44

Once the user details have been changed, click on the OKbutton. If the process is to beterminated click the Cancelbutton. If the OKbutton is selected, then the previous formwill be displayed but will also now include the updated users details.

7.3 Delete userTo remove a user from the database, select the user from the list and click on theDeletebutton on the Manage usersform. This will display the form below.

Click on the Deletebutton to remove this user from the database. If the process is to beterminated click the Cancelbutton. If the Deletebutton is selected then the previous

form will be displayed but will now not include the deleted user.

8 Configuring server and database connectionsTo connect Terrain DB to a server, click on the Serversbutton at the Login Form asshown in the picture below.

Figure 47: Delete user


40/44

Terrain DBTM

2008/05/27

Page 40 of 44

This will display a form that lists all of the servers that have previously been configuredas shown below.

To connect to one of the listed servers, select it from the list and click on the Openbutton.

This will return you to the previous Loginform. The list of databases available on thisform will automatically be updated to reflect the databases available from the newlyselected server.

From the Servers form you can also add, edit and delete additional servers to the list.

8.1 New serverTo add a new server to the database click on the Addbutton on the above form, this willdisplay the following form.

Figure 48: Login form

Figure 49: Servers


41/44

Terrain DBTM

2008/05/27

Page 41 of 44

Use the edit boxes and check boxes to enter the details for the new server connectionbeing created. You may need to contact the administrator of the server for all the details

you need to populate this form.Once these parameters have been selected, click the Addbutton. If the process is to beterminated click the Cancelbutton. If the Addbutton is selected then the previous formwill be displayed containing the new server connection details.

8.2 Edit server

To edit an existing server connection, select the server to be edited from the list andclick on the Editbutton on the Serversform. This will display the form below.

Once the details have been updated, click on the Updatebutton. If the process is to beterminated click the Cancelbutton. If the Updatebutton is selected then the previousform will be displayed but will also now include the updated details.

8.3 Delete server

To remove a server from the list, select the server from the list and click on the Deletebutton on the Serversform. This will display the form below.

Figure 50: New server

Figure 51: Edit server


42/44

Terrain DBTM

2008/05/27

Page 42 of 44

Click on the Deletebutton to remove this server from the list. If the process is to beterminated click the Cancelbutton. If the Deletebutton is selected then the previous

form will be displayed but will now not include the deleted server.

Figure 52: Delete server


43/44

Terrain DBTM

2008/05/27

Page 43 of 44

9 Terrain DB Technical Reference

9.1 File menu

When the File menu option is selected, a menu screen similar to the one shown belowwill appear.

9.1.1 Exit

Use this option to log off from the server and close the application.

9.2 Data menuWhen the Data menu option is selected a menu screen similar to the one shown belowwill appear.

9.2.1 Add Dataset

Use this option to add data to the database. Clicking on this option will start the AddDataset Wizard which will guide you through the process of adding data to thedatabase.

See section 3 for further details.

9.2.2 Extract elevation dataUse this option to configure the parameters used to extract elevation data from thedatabase. See section 4 for further details.

9.2.3 Responsible parties

Use this option to manage the responsible parties stored in the database. See section 6for further details.

9.2.4 Manage code lists

When the Manage code listsub menu option is selected a menu similar to the oneshown below will appear.

Figure 53: File menu

Figure 54: Data menu


44/44

Terrain DBTM

Use these options to manage the individual code lists stored in the database. Seesection 5 for further details.

9.3 User menuWhen the Usermenu option is selected a menu similar to the one shown below willappear.

9.3.1 Manage users

Use this option to manage the users stored in the database. See section 7 for furtherdetails.

9.4 Help menu

When the Helpmenu option is selected a menu similar to the one shown below will

appear.

9.4.1 Manual

Opens the application manual

9.4.2 About

Displays the version number of the application

Figure 55: Manage code list menu

Figure 56: User menu

Figure 57: Help

terrain db software key features

Documents