udpget/udpset(udpstx)

DCL:GRPH2:UDPACK: Contour Routines: Explanation of Subroutines

8.2.10 udpget/udpset(udpstx)

1.

Function

Inquires/changes an internal variable used by the UDPACK subroutine package. (udpstx permits change with a runtime option.)

2.

Call

ipara = NumRu::DCL.udpget(cp)
NumRu::DCL.udpset(cp,lpara)
NumRu::DCL.udpstx(cp,lpara)

3.

Explanation of Parameters

cp (C*8) The name of an internal variable

ipara (I,R,L) The value of an internal variable

Below is a list of names that can be used to specify cp.

'INDXMJ' (I) The line index of the major line. (The initial value is 3.)

'INDXMN' (I) The line index of the minor line. (The initial value is 1.)

'LABEL' (L) Specifies whether to place labels on major lines. Labeled when .true.; not labeled when .false.. (The initial value is .true..)

'LDASH' (L) Specifies whether to use different line types for drawing negative contour lines. When .true., the negative contour lines are drawn with line type inquired by the internal variable 'IDASH'; when .false., all contour lines are drawn with the line type inquired by the internal variable 'ISOLID'. (The initial value is .true..).

'IDASH' (I) The line type used for the negative contour level when 'LDASH' is .true.. (The initial value is 3: dashed line.)

'ISOLID' (I) The line type used for contour levels with values larger than 0 when 'LDASH' is .true., and for all contour levels when 'LDASH' is .false.. (The initial value is 1: solid line.)

'ICYCLE' (I) Specifies the number of minor lines to drawn between major lines. One major line is drawn for a cycle of contour lines specified by the value inquired by 'ICYCLE', and the remaining contour lines are minor lines. (The initial value is 2.)

'NLEV' (I) When contour levels are automatically generated, this internal variable is inquired to generate nlev contour levels. (The initial value is 12.)

'RSIZEL' (R) The character height of the contour label. (Units in VC; The initial value is undefined.) When this internal variable is undefined, the internal variable 'RSIZEL1' handled by uzrget/uzrset is inquired. (See Section 3.7.)

'LMSG' (L) Specifies whether to write a message in the bottom margin. Message printed when .true., not printed when .false.. (The initial value is .true..)

'RSIZET' (R) The character height of the message printed in the bottom margin of the graph. (Units in VC; The initial value is undefined.) When this internal variable is undefined, the internal variable 'RSIZEL1' handled by uzpgetset is inquired. (See Section 3.7.)

'XTTL' (R) An internal variable which determines the position of the message printed in the bottom margin of the graph. Takes a floating-point value between -1 to +1. Left-aligned when -1, centered when 0, and right-aligned when +1. (The initial value is 0.).

'IUNDEF' (I) An internal variable which indicates that the value is undefined. (The initial value is -999.)

4.

Notes

(a)

The following subroutines are available for handling the internal variables.

ncp = NumRu::DCL.udpqnp() Counts the total number of internal variables (NCP).

idx = NumRu::DCL.udpqid(cp) Determines the position (IDX) of the internal variable cp.

cp = NumRu::DCL.udpqcp(idx) Inquires the name (CP) of the internal variable at position idx.

ipara = NumRu::DCL.udpqvl(idx) Inquires the value (IPARA) of the internal variable at position idx.

NumRu::DCL.udpsvl(idx,ipara) Changes the value (IPARA) of the internal variable at position idx

(b)

UDpGET calls the above UDPQID to determine the position of an internal variable, and inquires its value using udpqvl. udpset calls udpqid to determine the position of an internal variable and changes its value using udpsvl. Therefore, when the specified internal variable is not found, an error message is printed by udpqid.

(c)

Specify an appropriate type of constant or variable for ITYPE.

`cp`	`(C*8)`	The name of an internal variable
`ipara`	`(I,R,L)`	The value of an internal variable

`'INDXMJ'`	`(I)`	The line index of the major line. (The initial value is 3.)
`'INDXMN'`	`(I)`	The line index of the minor line. (The initial value is 1.)
`'LABEL'`	`(L)`	Specifies whether to place labels on major lines. Labeled when `.true.`; not labeled when `.false.`. (The initial value is `.true.`.)
`'LDASH'`	`(L)`	Specifies whether to use different line types for drawing negative contour lines. When `.true.`, the negative contour lines are drawn with line type inquired by the internal variable `'IDASH'`; when `.false.`, all contour lines are drawn with the line type inquired by the internal variable `'ISOLID'`. (The initial value is `.true.`.).
`'IDASH'`	`(I)`	The line type used for the negative contour level when `'LDASH'` is `.true.`. (The initial value is 3: dashed line.)
`'ISOLID'`	`(I)`	The line type used for contour levels with values larger than 0 when `'LDASH'` is `.true.`, and for all contour levels when `'LDASH'` is `.false.`. (The initial value is 1: solid line.)
`'ICYCLE'`	`(I)`	Specifies the number of minor lines to drawn between major lines. One major line is drawn for a cycle of contour lines specified by the value inquired by `'ICYCLE'`, and the remaining contour lines are minor lines. (The initial value is 2.)
`'NLEV'`	`(I)`	When contour levels are automatically generated, this internal variable is inquired to generate `nlev` contour levels. (The initial value is 12.)
`'RSIZEL'`	`(R)`	The character height of the contour label. (Units in VC; The initial value is undefined.) When this internal variable is undefined, the internal variable `'RSIZEL1'` handled by `uzrget/uzrset` is inquired. (See Section 3.7.)
`'LMSG'`	`(L)`	Specifies whether to write a message in the bottom margin. Message printed when `.true.`, not printed when `.false.`. (The initial value is `.true.`.)
`'RSIZET'`	`(R)`	The character height of the message printed in the bottom margin of the graph. (Units in VC; The initial value is undefined.) When this internal variable is undefined, the internal variable `'RSIZEL1'` handled by `uzpgetset` is inquired. (See Section 3.7.)
`'XTTL'`	`(R)`	An internal variable which determines the position of the message printed in the bottom margin of the graph. Takes a floating-point value between -1 to +1. Left-aligned when -1, centered when 0, and right-aligned when +1. (The initial value is 0.).
`'IUNDEF'`	`(I)`	An internal variable which indicates that the value is undefined. (The initial value is -999.)

`ncp = NumRu::DCL.udpqnp()`	Counts the total number of internal variables `(NCP)`.
`idx = NumRu::DCL.udpqid(cp)`	Determines the position `(IDX)` of the internal variable `cp`.
`cp = NumRu::DCL.udpqcp(idx)`	Inquires the name `(CP)` of the internal variable at position `idx`.
`ipara = NumRu::DCL.udpqvl(idx)`	Inquires the value `(IPARA)` of the internal variable at position `idx`.
`NumRu::DCL.udpsvl(idx,ipara)`	Changes the value `(IPARA)` of the internal variable at position `idx`