McIDAS-X User's Guide
Version 2024.1
[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]
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 SSEC 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 SSEC remote server with the IP address GEOARC.SSEC.WISC.EDU.
Type: DATALOC ADD BLIZZARD GEOARC.SSEC.WISC.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 GEOARC.SSEC.WISC.EDU <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 GEOARC.SSEC.WISC.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 GEOARC.SSEC.WISC.EDU 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'
[Search Manual] [Table of Contents] [Go to Previous] [Go to Next]