ucpget/ucpset(ucpstx)

Back|Forward

DCL:GRPH2:UCPACK : Coordinate Axis Routines for Date: Explanation of Subroutines

5.3.5 ucpget/ucpset(ucpstx)

1.

Function

Inquires/changes an internal variable used in UCPACK. (ucpstx permits change with a runtime option.)

2.

Call

ipara = NumRu::DCL.ucpget(cp)
NumRu::DCL.ucpset(cp,lpara)
NumRu::DCL.ucpstx(cp,ipara)

3.

Explanation of Paramters

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.

'NDAY' (I) Specifies the interval for plotting tick marks and labels of dates when using ucxady/ucyady. If 'NDAY' is undefined, then an appropriate value is selected from 0, 1, 2, 5, 10, or 15. (When 0, only the axis is plotted, and no ticks or labels are drawn.) When explicitly specified, the specified value is used. (The initial value is undefined.) This value is specified by the function 'NUCDAY'.

'NCHAR' (I) Specifies the number of letters in the month for the label when using ucxamn/ucyamn . If 'NCHAR' is undefined, then an appropriate value is selected from 0, 1, 2, 3, or 9. (When 0, only the axis is plotted, and no ticks or months are drawn) When explicitly specified, the specified value is used. (The initial value is undefined.) This value is specified by the function 'NUCCHR'.

'LOWER' (L) Specifies whether to write the letters after the second letter in lower case for the name of the month written by ucxady/ucyady. In lower case when .true.; in upper case when .false.. (The initial value is .false..)

'IUNDEF' (I) The internal variable indicating 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.ucpqnp() Counts the total number of internal variables (NCP).

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

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

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

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

(b)

UCpGET calls the above UCPQID to determine the position of an internal variable, and inquires its value using ucpqvl. ucpset calls ucpqid to determine the position of an internal variable and changes its value using ucpsvl. Therefore, when the specified internal variable is not found, an error message is printed by ucpqid.

(c)

Specify an appropriate type of constant or variable for IPARA, according to the type of the internal variable.

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

`'NDAY'`	`(I)`	Specifies the interval for plotting tick marks and labels of dates when using `ucxady/ucyady`. If `'NDAY'` is undefined, then an appropriate value is selected from 0, 1, 2, 5, 10, or 15. (When 0, only the axis is plotted, and no ticks or labels are drawn.) When explicitly specified, the specified value is used. (The initial value is undefined.) This value is specified by the function `'NUCDAY'`.
`'NCHAR'`	`(I)`	Specifies the number of letters in the month for the label when using `ucxamn/ucyamn` . If `'NCHAR'` is undefined, then an appropriate value is selected from 0, 1, 2, 3, or 9. (When 0, only the axis is plotted, and no ticks or months are drawn) When explicitly specified, the specified value is used. (The initial value is undefined.) This value is specified by the function `'NUCCHR'`.
`'LOWER'`	`(L)`	Specifies whether to write the letters after the second letter in lower case for the name of the month written by `ucxady/ucyady`. In lower case when `.true.`; in upper case when `.false.`. (The initial value is `.false.`.)
`'IUNDEF'`	`(I)`	The internal variable indicating that the value is undefined. (The initial value is -999.)

`ncp = NumRu::DCL.ucpqnp()`	Counts the total number of internal variables `(NCP)`.
`idx = NumRu::DCL.ucpqid(cp)`	Determines the position `(IDX)` of the internal variable `cp`.
`cp = NumRu::DCL.ucpqcp(idx)`	Inquires the name `(CP)` of the internal variable at position `idx`.
`ipara = NumRu::DCL.ucpqvl(idx)`	Inquires the value `(IPARA)` of the internal variable at position `idx`.
`NumRu::DCL.ucpsvl(idx,ipara)`	Changes the value `(IPARA)` of the internal variable at position `idx`