Current Location: NASA Science Support >> HISCALE Data Analysis Handbook >> Appendix 5.5

ULYSSES

Ulysses HISCALE Data Analysis Handbook

 

Appendix 5. Running the LAN Production

 

5.5 ARCSYN

 

Document revision 8/20/85

 

A5.5.1 Overview

 

Program ARCSYN reads and displays records from synoptic data files which were generated by ARCGEN data processing. The user can select among different display formats, some of which select out given data values, etc. These display routines are as follows:

 

Rate Selective Display. This displays one of the spin averaged rates over the time period requested. 
Sectored P2 Display. This displays the sectored P2 data over the time period requested.
Display Entire Records. This displays all data in each synoptic record for the time period requested.

 

ARCSYN operates in either "Console" or "Printer" modes which are selected by 'C' and 'P' respectively. In Console mode, output is formatted for an 80 by 25 screen and the user is prompted each time the screen is filled. In Printer mode, output is formatted for a 132 character wide printer and no user prompts are required.

 

Selecting start and end times is facilitated by the use of defaults. Whenever a start time is given to the program, it will be the default selection next time. The end time always defaults to 1 week after the start time. For example:

 

Enter start time (def=1984/326/19:50:00) >1984/326/23:40:00
Enter end time (def=1984/333/23:40:00) >

 

To run ARCSYN with console output type

 

% ARCSYN

 

To run ARCSYN with printer output, first send the output to a file then print that file later as follows:

 

% ARCSYN >ASOUT
.
. 
.
% print ASOUT

 

Example

 

% arcsyn
Synoptic Data Display Program v6-28-85

 

ARCSYN COMMAND LIST :
R : Rate Selective Display 
S : Sectored P2 Display
D : Display Entire Records
C : Console output format (now ON )
P : Printer output format (now OFF )
E : End

 

Enter Command (? for Help)
>r
Selectable quantities are :
1. P2 
2. P5 
3. E2 
4. FP5 
5. P2' 
6. P5' 
7. E2' 
8. FP5'
9. W1 
10. W3 
11. null
12. null
13. null
14. Null

 

Enter quantity # >2
Input the start time (def=1984/326 19:50: 0) >
Input the end time (def=1984/333 19:50: 0) >

 

 

 

Enter Command (? for Help)
>e
%

 

Programming Level

 

Files needed to create ARCSYN are:

 

arcsyn.f	ARCSYN program
synfns.f	Synoptic utility routines
synblk.inc	Synoptic record definition
util.f	General Utility routines
Makefile	Input file to UNIX 'make' utility to produce ARCGEN production programs.

 

Files needed to run ARCSYN are:

 

TIMESYN.DAT	Time directory for the synoptic data base
SYNxxxxx.DAT	The synoptic data files

 

Routines in arcsyn.f:

 

1. program arcsyn

 

Interacts with user to determine which function to perform, etc. Calls one of the following functions depending upon the response.

 

2. subroutine selprt (otype)

 

Routine to print out a selected qty from the synoptic data base between a start and an end time. Parameter otype controls whether to format the information for the 80¥25 terminal or 132 character wide printer. If in the console mode, the output stops after about 20 lines waiting for the user to strike a key.

 

3. subroutine sp2prt( otype )

 

This routine is very similar to selprt except that it will print only the sectored P2 qty, no others.

 

4. subroutine dumprt( otype )

This routine prints out all the information contained in each synoptic record between a start and an end time. If in the console mode, it will pause after each record and wait for the user to strike a key.

 

5. subroutine askse( st,et,timend, unit)

 

This routine is used to establish the starting and ending times the user wants to select. The start time defaults to the last start time used and the end time always defaults to 1 week after the start time. Before leaving, the routine positions the synoptic data base to the start time so the next call to getsyn will return that data. Timend is set to the end time converted to seconds since 1950. If no data exists for the period, timend is zeroed and a message is displayed.

 

Routines in synfns.f:

 

1. subroutine namsyn( itime, filnam )

This routine is used to create the name for a synoptic data file given the year,month,day, etc., information contained in itime. Filnam is returned as a character*16 value.

 

2. integer function opnsyn( unit, itime )

Opnsyn opens the synoptic database on a specified unit to a given time. It opens a file which has data on or after itime and returns the record number within that particular synoptic data file. If opnsyn has any problems, such as not being able to find such a time in the synoptic data, it will return 0.

 

3. integer function srcsyn( unit, time )

Srcsyn is a search function which searches a file on logical unit 'unit' for a time greater or equal to 'time'. Note: 'time' is in seconds since 1950 (use sec1950(itime)). It returns 0 if no data exists, else it returns the record number within the file for the data.

 

4. integer function getsyn( unit, irec )

Getsyn reads a record from the logical unit into the synoptic data common. Irec is an input parameter which, if nonzero, dictates the record number of the file to read. If zero, the next record is read in sequential style. Note: in the sequential mode, if the current file runs out of data, the next file in the synoptic data base is automatically opened.

 

Thus, using a combination of opnsyn and getsyn (with irec=0), one can read the entire synoptic database.

 

5. subroutine prtsyn

 

Prtsyn prints out the data in a synoptic data record to the standard output logical unit using data in the synoptic data common.

 

Routines in util.f:

 

See ARCGEN section.

 

 

Next: A5.6 STATMRG

 

Return to Appendix 5 Table of Contents Page

Return to HISCALE List of Appendices

Return to Ulysses HISCALE Data Analysis Handbook Table of Contents

 

QUICK FACTS

RELATED LINKS