umpget/umpset(umpstx)

DCL:GRPH2:UMPACK: Map Projection Routines: Explanation of Subroutines: Drawing Map Information

12.3.5 umpget/umpset(umpstx)

1.

Function

Inquires/changes an internal variable used in the UMPACK subroutine package. (umpstxpermits changes with a runtime option.)

2.

Call

lpara = NumRu::DCL.umpget(cp)
NumRu::DCL.umpset(cp,lpara)
NumRu::DCL.umpstx(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

The following is a list of names that cane be specified as cp.

'LGRIDMJ' (L) Specifies whether major lines will be drawn when umpgrd draws latitudes and longitudes. Drawn when .true.; not drawn when .false.. (The initial value is .true..)

'LGRIDMN' (L) Specifies whether minor lines will be drawn when umpgrd draws latitudes and longitudes. Drawn when .true.; not drawn when .false.. (The initial value is .true..)

'INDEXMJ' (I) The line index for the major lines of latitudes and longitudes drawn by umpgrd. (The initial value is 3.)

'INDEXMN' (I) The line index for the minor lines of latitudes and longitudes drawn by umpgrd. (The initial value is 1.)

'ITYPEMJ' (I) The line type for the major lines of latitudes and longitudes drawn by umpgrd. (The initial value is 1.)

'ITYPEMN' (I) The line type for the minor lines of latitudes and longitudes drawn by umpgrd. (The initial value is 3.)

'DGRIDMJ' (R) The interval between the major lines of latitudes and longitudes drawn by umpgrd. (Units in degrees; The initial value is 30.0.)

'DGRIDMN' (R) The interval between the minor lines of latitudes and longitudes drawn by umpgrd. (Units in degrees; The initial value is 10.0.)

'DGRPLMJ' (R) Specifies the angle between the pole and the beginning of the major line for the longitude drawn by umpgrd. (Unit in degrees; The initial value is 0.0.)

'DGRPLMN' (R) Specifies the angle between the pole and the beginning of the major line for the longitude drawn by umpgrd. (Unit in degrees; The initial value is 0.0.)

'INDEXBND' (I) The line index of the boundary line of the map drawn by umplim. (The initial value is 3.)

'MAXBND' (I) Specifies the number of segments the boundary line of the map is divided into when drawn by umplim. (The initial value is 300.)

'INDEXOUT' (I) The line index for the line for map information such as coastlines. (The initial value is 1.)

'ITYPEOUT' (I) The line type for the line for map information such as coastlines. (The initial value is 1.)

'LGLOBE' (L) When umstrf sets a transformation parameter, specifies whether to draw the whole Earth. Whole Earth drawn when .true.; the whole Earth not drawn when .false.. (The initial value is .false..)

4.

Notes

(a)

The following subroutines are available for handling the internal variables.

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

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

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

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

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

(b)

UMpGET calls the above UMPQID to determine the position of an internal variable, and inquires its value using umpqvl. umpset calls umpqid to determine the position of an internal variable and changes its value using umpsvl. Therefore, when the specified internal variable is not found, an error message is printed by umpqid.

(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

`'LGRIDMJ'`	`(L)`	Specifies whether major lines will be drawn when `umpgrd` draws latitudes and longitudes. Drawn when `.true.`; not drawn when `.false.`. (The initial value is `.true.`.)
`'LGRIDMN'`	`(L)`	Specifies whether minor lines will be drawn when `umpgrd` draws latitudes and longitudes. Drawn when `.true.`; not drawn when `.false.`. (The initial value is `.true.`.)
`'INDEXMJ'`	`(I)`	The line index for the major lines of latitudes and longitudes drawn by `umpgrd`. (The initial value is 3.)
`'INDEXMN'`	`(I)`	The line index for the minor lines of latitudes and longitudes drawn by `umpgrd`. (The initial value is 1.)
`'ITYPEMJ'`	`(I)`	The line type for the major lines of latitudes and longitudes drawn by `umpgrd`. (The initial value is 1.)
`'ITYPEMN'`	`(I)`	The line type for the minor lines of latitudes and longitudes drawn by `umpgrd`. (The initial value is 3.)
`'DGRIDMJ'`	`(R)`	The interval between the major lines of latitudes and longitudes drawn by `umpgrd`. (Units in degrees; The initial value is 30.0.)
`'DGRIDMN'`	`(R)`	The interval between the minor lines of latitudes and longitudes drawn by `umpgrd`. (Units in degrees; The initial value is 10.0.)
`'DGRPLMJ'`	`(R)`	Specifies the angle between the pole and the beginning of the major line for the longitude drawn by `umpgrd`. (Unit in degrees; The initial value is 0.0.)
`'DGRPLMN'`	`(R)`	Specifies the angle between the pole and the beginning of the major line for the longitude drawn by `umpgrd`. (Unit in degrees; The initial value is 0.0.)
`'INDEXBND'`	`(I)`	The line index of the boundary line of the map drawn by `umplim`. (The initial value is 3.)
`'MAXBND'`	`(I)`	Specifies the number of segments the boundary line of the map is divided into when drawn by `umplim`. (The initial value is 300.)
`'INDEXOUT'`	`(I)`	The line index for the line for map information such as coastlines. (The initial value is 1.)
`'ITYPEOUT'`	`(I)`	The line type for the line for map information such as coastlines. (The initial value is 1.)
`'LGLOBE'`	`(L)`	When `umstrf` sets a transformation parameter, specifies whether to draw the whole Earth. Whole Earth drawn when `.true.`; the whole Earth not drawn when `.false.`. (The initial value is `.false.`.)

`ncp = NumRu::DCL.umpqnp()`	Counts the total number of internal variables `(NCP)`.
`idx = NumRu::DCL.umpqid(cp)`	Determines the position `(IDX)` of the internal variable `cp`.
`cp = NumRu::DCL.umpqcp(idx)`	Inquires the name `(CP)` of the internal variable at position `idx`.
`ipara = NumRu::DCL.umpqvl(idx)`	Inquires the value `(IPARA)` of the internal variable at position `idx`.
`NumRu::DCL.umpsvl(idx,ipara)`	Changes the value `(IPARA)` of the internal variable at position `idx`