USpGET/USpSET(USpSTX)

DCL:GRPH2:USPACK: Auto-Scaling Routines: Explanation of Subroutines (Parameter Handling)

7.8.1 USpGET/USpSET(USpSTX)

1.

Function

Inquires/changes the floating-point, integer, and logical internal variables. (USpSTX permits changes with a runtime option.)

2.

Call

CALL USpGET(CP, IPARA)
CALL USpSET(CP, IPARA)
CALL USpSTX(CP, IPARA)

3.

Argument

CP (C*(*)) The name of a parameter (i)

IPARA (I/R/L) The value of a parameter (i/o)

4.

List of Parameters

IRESET (I) A variable for specifying the automatic resetting of parameters with USINIT. The initial value is 1.
0: Resets only the variables with *, such as scaling parameters.
1: In addition to IRESET=0, resets the title.
2: Reset all parameters in US p SET.
USINIT is normally called from GRFRM.

XDTMIN*, XDTMAX* (R) The maximum and minimum values of the X axis set by USSPNT.

YDTMIN*, YDTMAX* (R) The maximum and minimum values of the Y axis set by USSPNT.

LXINV (L) Inverts the X axis (left-right) when .TRUE..

LYINV (L) Inverts the Y axis (top-bottom) when .TRUE..

LMATCH (L) When .TRUE., the intervals of the labels and characters for the X and Y axis are set to be equal.

RMRGN (R) The width of a margin. Units in width of character (9.524).

XFAC* (R) The value of the X axis factor (999).

YFAC* (R) The value of the Y axis factor (999).

XOFF* (R) The offset value of an uniform X axis (999).

YOFF* (R) The offset value of an uniform Y axis (999).

DXT* (R) The interval of the tick marks for an uniform X axis (999).

DYT* (R) The interval of the tick marks for an uniform Y axis (999).

DXL* (R) The interval of the labels for an uniform X axis (999).

DYL* (R) The interval of the labels for an uniform Y axis (999).

TFACT (R) The approximate interval of tick marks for an uniform coordinate system (2).
A convenient value is selected for DUT, with an interval smaller than this value is multiplied by the character width.

MXDGTX (I) The maximum number of digits in the label for the uniform X axis (4).

MXDGTY (I) The maximum number of digits in the label for the uniform Y axis (4).
When the number of digits in the label exceed this value, set UOFF and UFAC so that the number of digits is lower than this value.

NBLANK1 (I) The minimum number of blanks between the labels when the labels are parallel to the axis. (Uniform coordinate system) (1).

NBLANK2 (I) The minimum number of blanks between the labels when the labels are perpendicular to the axis. (Uniform coordinate system) (2).

NLBLX* (I) The label format for a log X axis (999).

NLBLY* (I) The label format for a log Y axis (999).

NTICKSX* (I) The number of ticks in a single order for a log X axis (999).

NTICKSY* (I) The number of ticks in a single order for a log Y axis (999).

ITYPEX* (I) The type of log X axis (999).

ITYPEY* (I) The type of log Y axis (999).

MXDGTSX (I) When the sub-labels for the X axis are drawn horizontally, they are drawn so that they do not exceed the range of character numbers for the label specified by MXSDGTX.

MXDGTSY (I) When the sub-labels for the Y axis are drawn vertically, they are drawn so that they do not exceed the range of character numbers for the label specified by MXDGTSY.

LPRTCT (L) Specifies that the sub-labels should not invade the label area for the other axis. When this is .TRUE., then the specifications in MXDGTSX/MXDGTSY are ignored.

SOFFX sp * (R) The offset value of the X-axis sub-label. sp = 'TR', 'TL', 'BR', 'BL', 'UR', 'UL'.

SOFFY sp * (R) The offset value of the Y-axis sub-label. sp = 'RT', 'RB', 'LT', 'LB', 'UT', 'UB'.

ROFFX s * (R) The offset value of the X-axis when the Y-axis sub-label has intruded the X-axis label area. s = 'T', 'B'.

ROFFY s * (R) The offset value of the Y-axis when the X-axis sub-label has intruded the Y-axis label area. s = 'L', 'R'.

Variables with * are reset each time.

5.

Notes

(a)

The following subroutines are available for handling the internal variables.

USPQNP(NCP) Counts the total number of internal variables (NCP).

USPQID(CP,IDX) Determines the position (IDX) of the internal variable CP.

USPQCP(IDX,CP) Inquires the name (CP) of the internal variable at position IDX.

USPQVL(IDX,IPARA) Inquires the value (IPARA) of the internal variable at position IDX.

USPSVL(IDX,IPARA) Changes the value (IPARA) of the internal variable at position IDX

(b)

USpGET calls the above USPQID to determine the position of an internal variable, and inquires its value using USPQVL. USpSET calls USPQID to determine the position of an internal variable and changes its value using USPSVL. Therefore, when the specified internal variable is not found, an error message is printed by USPQID.

(c)

Specify an appropriate type of constant or variable for ITYPE.

Back|Forward

DCL:GRPH2:USPACK: Auto-Scaling Routines: Explanation of Subroutines (Parameter Handling)

`CP`	`(C())`	The name of a parameter `(i)`
`IPARA`	`(I/R/L)`	The value of a parameter `(i/o)`

`XDTMIN`, `XDTMAX`	`(R)`	The maximum and minimum values of the X axis set by USSPNT.
`YDTMIN`, `YDTMAX`	`(R)`	The maximum and minimum values of the Y axis set by USSPNT.

`LXINV`	`(L)`	Inverts the X axis (left-right) when `.TRUE.`.
`LYINV`	`(L)`	Inverts the Y axis (top-bottom) when `.TRUE.`.
`LMATCH`	`(L)`	When `.TRUE.`, the intervals of the labels and characters for the X and Y axis are set to be equal.
`RMRGN`	`(R)`	The width of a margin. Units in width of character (9.524).

`XFAC*`	`(R)`	The value of the X axis factor (999).
`YFAC*`	`(R)`	The value of the Y axis factor (999).
`XOFF*`	`(R)`	The offset value of an uniform X axis (999).
`YOFF*`	`(R)`	The offset value of an uniform Y axis (999).

`DXT*`	`(R)`	The interval of the tick marks for an uniform X axis (999).
`DYT*`	`(R)`	The interval of the tick marks for an uniform Y axis (999).
`DXL*`	`(R)`	The interval of the labels for an uniform X axis (999).
`DYL*`	`(R)`	The interval of the labels for an uniform Y axis (999).

`TFACT`	`(R)`	The approximate interval of tick marks for an uniform coordinate system (2). A convenient value is selected for DUT, with an interval smaller than this value is multiplied by the character width.
`MXDGTX`	`(I)`	The maximum number of digits in the label for the uniform X axis (4).
`MXDGTY`	`(I)`	The maximum number of digits in the label for the uniform Y axis (4). When the number of digits in the label exceed this value, set `UOFF` and `UFAC` so that the number of digits is lower than this value.

`NBLANK1`	`(I)`	The minimum number of blanks between the labels when the labels are parallel to the axis. (Uniform coordinate system) (1).
`NBLANK2`	`(I)`	The minimum number of blanks between the labels when the labels are perpendicular to the axis. (Uniform coordinate system) (2).

`NLBLX*`	`(I)`	The label format for a log X axis (999).
`NLBLY*`	`(I)`	The label format for a log Y axis (999).
`NTICKSX*`	`(I)`	The number of ticks in a single order for a log X axis (999).
`NTICKSY*`	`(I)`	The number of ticks in a single order for a log Y axis (999).
`ITYPEX*`	`(I)`	The type of log X axis (999).
`ITYPEY*`	`(I)`	The type of log Y axis (999).

`MXDGTSX`	`(I)`	When the sub-labels for the X axis are drawn horizontally, they are drawn so that they do not exceed the range of character numbers for the label specified by `MXSDGTX`.
`MXDGTSY`	`(I)`	When the sub-labels for the Y axis are drawn vertically, they are drawn so that they do not exceed the range of character numbers for the label specified by `MXDGTSY`.
`LPRTCT`	`(L)`	Specifies that the sub-labels should not invade the label area for the other axis. When this is `.TRUE.`, then the specifications in `MXDGTSX/MXDGTSY` are ignored.

`SOFFX` sp `*`	`(R)`	The offset value of the X-axis sub-label. sp = `'TR', 'TL', 'BR', 'BL', 'UR', 'UL'`.
`SOFFY` sp `*`	`(R)`	The offset value of the Y-axis sub-label. sp = `'RT', 'RB', 'LT', 'LB', 'UT', 'UB'.`
`ROFFX` s `*`	`(R)`	The offset value of the X-axis when the Y-axis sub-label has intruded the X-axis label area. s `= 'T', 'B'`.
`ROFFY` s `*`	`(R)`	The offset value of the Y-axis when the X-axis sub-label has intruded the Y-axis label area. s `= 'L', 'R'`.

`USPQNP(NCP)`	Counts the total number of internal variables `(NCP)`.
`USPQID(CP,IDX)`	Determines the position `(IDX)` of the internal variable `CP`.
`USPQCP(IDX,CP)`	Inquires the name `(CP)` of the internal variable at position `IDX`.
`USPQVL(IDX,IPARA)`	Inquires the value `(IPARA)` of the internal variable at position `IDX`.
`USPSVL(IDX,IPARA)`	Changes the value `(IPARA)` of the internal variable at position `IDX`