Table of contents Previous: Setting the Expanded Stretch Option Next: Commands

Getting Started with ADDE

The exercise below introduces you to ADDE concepts such as dataset names, aliases, clients and servers. Use this exercise to practice adding entries to your client routing table and local server's mapping table, and displaying and copying image data from a remote server on an McIDAS-X workstation. The examples below use image datasets, but the concepts apply to all dataset types (grid, image, navigation, point and text). When you type a command, press Enter to run it. For more information about the commands, see Chapter 3, Commands and the online helps.

1. Log on to the workstation as user DEMO with project number 1234.

Type:  LOGON DEMO 1234

Logging on is required only if the ADDE remote servers you access require a user name and a project number for accounting. Administrators can allow access only to specific logon names and project numbers.

2. List your client routing table's groups and associated server IP addresses.

Type:  DATALOC

If this is the first time you are using the ADDE, the table is empty and the following listing is displayed.

Group Name      Server IP Address

3. Modify your client routing table so that commands requesting data from a dataset in the group BLIZZARD are routed to the Unidata remote server with the name adde.ucar.edu.

Type:  DATALOC ADD BLIZZARD adde.ucar.edu

The following listing is displayed. The last line informs you that commands requesting data from a group with the Server IP Address <LOCAL-DATA> are routed to the local server

Group Name   Server IP Address
BLIZZARD     adde.ucar.eddu


<LOCAL-DATA> indicates that data will be accessed from the local data directory.

4. List all datasets of type IMAGE in the group BLIZZARD.

Type:  DSINFO IMAGE BLIZZARD

The following listing is displayed. The NumPos value is the number of positions in the dataset. This data is located on the remote server at adde.ucar.edu.

Dataset Names of Type:  IMAGE in Group: BLIZZARD

Name              NumPos     Content
G7-IR-4K            3        Storm of the Century G7 IR
G7-VIS-1K           1        Storm of the Century G7 1K
G7-VIS-4K           3        Storm of the Century G7 VIS
G7-VIS-FD           1        Storm of the Century G7 16K
IMAGES             14        Storm of the Century All Images
M3-IR               3        Storm of the Century M3 IR
M3-VIS              3        Storm of the Century M3 VIS

5. List all the images in the dataset BLIZZARD/G7-VIS-4K.

Type:  IMGLIST BLIZZARD/G7-VIS-4K.ALL

The following listing is displayed. The Pos value is the absolute position of the image in the dataset

Image file directory listing for:BLIZZARD/G7-VIS-4K

Pos  Satellite/      Date          Time      Center     Band(s)
       sensor                                Lat Lon   _______
 1    GOES-7        13 MAR 93072  17:01:00   26  87        1
 2    GOES-7        13 MAR 93072  17:31:00   26  87        1
 3    GOES-7        13 MAR 93072  18:01:00   26  87        1

6. List the two most recent images (positions 0 and -1) in the dataset BLIZZARD/G7-VIS-4K.

Type:  IMGLIST BLIZZARD/G7-VIS-4K.-1

The following listing is displayed. The Pos value is the absolute position of the image in the dataset. The image in position 3 is listed first because it is the most recent image, relative position 0. The image in position 2 is the second most recent image, relative position -1.

Image file directory listing for:BLIZZARD/G7-VIS-4K

Pos  Satellite/      Date          Time      Center     Band(s)
      sensor                                 Lat Lon    _______
3    GOES-7        13 MAR 93072  18:01:00   26  87        1
2    GOES-7        13 MAR 93072  17:31:00   26  87        1

7. Create the aliases GV4 and GI4 for the dataset names BLIZZARD/G7-VIS-4K and BLIZZARD/G7-IR-4K.

Type:  AKA ADD GV4 BLIZZARD/G7-VIS-4K

Type:  AKA ADD GI4 BLIZZARD/G7-IR-4K

8. List the aliases in your client routing table.

Type:  AKA

The following listing is displayed.

Alias Name       Group/Descriptor
GI4              BLIZZARD/G7-IR-4K
GV4              BLIZZARD/G7-VIS-4K

9. Display the most recent image in the dataset with the alias name GV4. Display the image on frame 1 centered on Athens, Georgia, and draw a map on it. The AKA listing in step 7 shows that the alias GV4 represents dataset BLIZZARD/G7-VIS-4K.

Type:  IMGDISP GV4 1 STATION=KAHN SF=YES REFRESH='MAP VH 2'

10. Assign the dataset name MYDATA/IMAGES to areas 1 through 9999 on the local server.

Type:  DSSERVE ADD MYDATA/IMAGES AREA 1 9999 "All areas on local server

11. Use the IMGLIST command to find five empty areas on the local server.

Type:  IMGLIST MYDATA/IMAGES.991 995

If data exists in this block of areas, move or delete the areas or use the IMGLIST command to find a different block of empty areas.

12. Assign the dataset name MYDATA/TEST-IMAGES to the empty block of areas.

Type:  DSSERVE ADD MYDATA/TEST-IMAGES AREA 991 995 "Scratch areas for testing

13. List the datasets on the local server.

Type:  DSSERVE

A listing similar to the following is displayed.

Group/Descriptor    Type   Format & Range   RT   Comment
MYDATA/IMAGES       IMAGE  AREA    1-9999       All areas on local server
MYDATA/TEST-IMAGES  IMAGE  AREA   991-995       Scratch areas for testing

14. Modify your client routing table so that commands which request data from the group MYDATA are routed to the local server.

Type:  DATALOC ADD MYDATA LOCAL-DATA

This step is optional because ADDE commands that request data from a group not found in your client routing table are automatically routed to the local server. If you add your local server's groups to the table, you can use the DATALOC LIST command to list all the groups you can access, on local and remote servers.

15. List the groups in your client routing table.

Type:  DATALOC

Group Name      Server IP Address
BLIZZARD        128.104.109.190
MYDATA          <LOCAL-DATA>

<LOCAL-DATA> indicates that data will be accessed from the local data directory.

16. Create the alias TI for the dataset name MYDATA/TEST-IMAGES.

Type:  AKA ADD TI MYDATA/TEST-IMAGES

17. List the aliases in your client routing table.

Type:  AKA

The following listing is displayed.

Alias Name         Group/Descriptor
GI4                BLIZZARD/G7-IR-4K
GV4                BLIZZARD/G7-VIS-4K
TI                 MYDATA/TEST-IMAGES

18. List all the images in the dataset with the alias name TI. The AKA listing in step 17 shows that the alias TI represents dataset MYDATA/TEST-IMAGES.

Type:  IMGLIST TI.ALL

The following output is displayed because the dataset has no images.

Image file directory listing for:TI
IMGLIST: No images satisfy the selection criteria

19. Copy the most recent image in the dataset with the alias name GI4 to position 5 in the dataset with the alias name TI. Place Athens, Georgia, at its center. The AKA listing in step 17 shows that the aliases GI4 and TI represent datasets BLIZZARD/G7-IR-4K and MYDATA/TEST-IMAGES.

Type:  IMGCOPY GI4 TI.5 STATION=KAHN

20. List all the images in the dataset with the alias name TI.

Type:  IMGLIST TI.ALL

The following listing is displayed..

Image file directory listing for:BLIZZARD/G7-VIS-4K

Pos  Satellite/      Date          Time      Center     Band(s)
      sensor                                 Lat Lon   _______
 5    GOES-7 IR     13 MAR 93072  18:01:00   34  83        8

21. Display the image in position 5 in the dataset with the alias name TI. Display the image on frame 2 and draw a map on it.

Type:  IMGDISP TI.5 2 SF=YES REFRESH='MAP VH 2'

 


Table of contents Previous: Setting the Expanded Stretch Option Next: Commands