From MdsWiki
(Difference between revisions)
Revision as of 21:48, 21 January 2007 (edit) WikiSysop (Talk | contribs) ← Previous diff |
Revision as of 21:50, 21 January 2007 (edit) WikiSysop (Talk | contribs) Next diff → |
||
Line 3: | Line 3: | ||
| | | | ||
__NOTOC__ | __NOTOC__ | ||
- | <span id=""></span> | + | <span id="make_action"></span> |
==MAKE_ACTION (DISPATCH,TASK,[ERRORLOGS],[COMPLETION],[PERFORMANCE])== | ==MAKE_ACTION (DISPATCH,TASK,[ERRORLOGS],[COMPLETION],[PERFORMANCE])== | ||
MDS Operation. Make an action descriptor. <br /><br /> Arguments <br /> DISPATCH dispatch descriptor. <br /> TASK procedure, program, routine, or method descriptor. <br /> ERRORLOGS a character scalar for error reports. <br /> COMPLETION notification list. <br /> PERFORMANCE unsigned long vector of statistics from execution. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_ACTION(MAKE_DISPATCH("ident","phase","when", <br /> "completion"),MAKE_ROUTINE(timeout,image,routine)) <br /> has only dispatch and task. <br /><br /> | MDS Operation. Make an action descriptor. <br /><br /> Arguments <br /> DISPATCH dispatch descriptor. <br /> TASK procedure, program, routine, or method descriptor. <br /> ERRORLOGS a character scalar for error reports. <br /> COMPLETION notification list. <br /> PERFORMANCE unsigned long vector of statistics from execution. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_ACTION(MAKE_DISPATCH("ident","phase","when", <br /> "completion"),MAKE_ROUTINE(timeout,image,routine)) <br /> has only dispatch and task. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_call"></span> |
==MAKE_CALL ([KIND],IMAGE,ROUTINE,[ARG],...)== | ==MAKE_CALL ([KIND],IMAGE,ROUTINE,[ARG],...)== | ||
MDS Operation. Make a call of a routine in a sharable image. <br /> Usual Forms IMAGE->ROUTINE:KIND([ARG],...) or IMAGE->ROUTINE([ARG]) <br /><br /> Arguments Optional: KIND, ARG... . <br /> KIND byte unsigned scalar of KIND returned in R0. <br /> Use DSC$K_DTYPE_DSC=24 for a pointer to an XD. <br /> Use DSC$K_DTYPE_MISSING=0 for no information. <br /> Default type is long integer. <br /> Other accepted types are BU WU LU QU OU B W L Q O F D <br /> NID and null-terminated strings T PATH EVENT. <br /> IMAGE character scalar. It must be a simple filename in <br /> SYS$SHARE or a logical name of the file. <br /> ROUTINE character scalar. <br /> ARG... arguments with certain options. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> Use this form if IMAGE or ROUTINE must be expressions. <br /><br /> Example. MAKE_CALL(24,'TDISHR','TDI$SIND',DESCR(30.)) is <br /> the slow and hard way to do SIND(30.). <br /><br /> See also. CALL for info on argument form and type of output. <br /><br /> | MDS Operation. Make a call of a routine in a sharable image. <br /> Usual Forms IMAGE->ROUTINE:KIND([ARG],...) or IMAGE->ROUTINE([ARG]) <br /><br /> Arguments Optional: KIND, ARG... . <br /> KIND byte unsigned scalar of KIND returned in R0. <br /> Use DSC$K_DTYPE_DSC=24 for a pointer to an XD. <br /> Use DSC$K_DTYPE_MISSING=0 for no information. <br /> Default type is long integer. <br /> Other accepted types are BU WU LU QU OU B W L Q O F D <br /> NID and null-terminated strings T PATH EVENT. <br /> IMAGE character scalar. It must be a simple filename in <br /> SYS$SHARE or a logical name of the file. <br /> ROUTINE character scalar. <br /> ARG... arguments with certain options. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> Use this form if IMAGE or ROUTINE must be expressions. <br /><br /> Example. MAKE_CALL(24,'TDISHR','TDI$SIND',DESCR(30.)) is <br /> the slow and hard way to do SIND(30.). <br /><br /> See also. CALL for info on argument form and type of output. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_condition"></span> |
==MAKE_CONDITION (MODIFIER,CONDITION)== | ==MAKE_CONDITION (MODIFIER,CONDITION)== | ||
MDS Operation. Make a condition descriptor. <br /><br /> Arguments <br /> MODIFIER word unsigned, evaluated: <br /> TREE$K_NEGATE_CONDITION 7 <br /> TREE$K_IGNORE_UNDEFINED 8 <br /> TREE$K_IGNORE_STATUS 9 <br /> CONDITION MDS event or path. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by COMPILE_DEPENDENCY. <br /><br /> See also. MAKE_DEPENDENCY MAKE_EVENT and COMPILE_DEPENDENCY. <br /><br /> | MDS Operation. Make a condition descriptor. <br /><br /> Arguments <br /> MODIFIER word unsigned, evaluated: <br /> TREE$K_NEGATE_CONDITION 7 <br /> TREE$K_IGNORE_UNDEFINED 8 <br /> TREE$K_IGNORE_STATUS 9 <br /> CONDITION MDS event or path. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by COMPILE_DEPENDENCY. <br /><br /> See also. MAKE_DEPENDENCY MAKE_EVENT and COMPILE_DEPENDENCY. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_conglom"></span> |
==MAKE_CONGLOM (IMAGE,MODEL,NAME,QUALIFIERS)== | ==MAKE_CONGLOM (IMAGE,MODEL,NAME,QUALIFIERS)== | ||
MDS Operation. Make a conglomerate descriptor. <br /><br /> Arguments <br /> IMAGE character scalar. <br /> MODEL character scalar. <br /> NAME character scalar. <br /> QUALIFIERS long vector, module dependent. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routines. <br /><br /> | MDS Operation. Make a conglomerate descriptor. <br /><br /> Arguments <br /> IMAGE character scalar. <br /> MODEL character scalar. <br /> NAME character scalar. <br /> QUALIFIERS long vector, module dependent. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routines. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_dependency"></span> |
==MAKE_DEPENDENCY (OP_CODE,ARG_1,ARG_2)== | ==MAKE_DEPENDENCY (OP_CODE,ARG_1,ARG_2)== | ||
MDS Operation. Make a dependency descriptor. <br /><br /> Arguments <br /> OP_CODE word unsigned scalar, evaluated. <br /> TREE$K_DEPENDENCY_AND 10 <br /> TREE$K_DEPENDENCY_OR 11 <br /> ARG_1 MDS condition, event, or path. <br /> ARG_2 MDS condition, event, or path. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by COMPILE_DEPENDENCY. <br /><br /> See also. MAKE_CONDITION MAKE_EVENT and COMPILE_DEPENDENCY. <br /><br /> | MDS Operation. Make a dependency descriptor. <br /><br /> Arguments <br /> OP_CODE word unsigned scalar, evaluated. <br /> TREE$K_DEPENDENCY_AND 10 <br /> TREE$K_DEPENDENCY_OR 11 <br /> ARG_1 MDS condition, event, or path. <br /> ARG_2 MDS condition, event, or path. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by COMPILE_DEPENDENCY. <br /><br /> See also. MAKE_CONDITION MAKE_EVENT and COMPILE_DEPENDENCY. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_dim"></span> |
==MAKE_DIM ([WINDOW],AXIS)== | ==MAKE_DIM ([WINDOW],AXIS)== | ||
MDS Operation. Make a dimension descriptor. <br /><br /> Arguments Optional: WINDOW. <br /> WINDOW window descriptor. <br /> If missing, all point of AXIS are included and <br /> the initial point of the axis has an index of 0. <br /> AXIS slope or, if defined, other descriptor type. <br /><br /> Signals. None. <br /> Units... From AXIS. Should be same as WINDOW's value_at_idx0. <br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> The array will have bounds only if the <br /> window has a defined value at index 0. <br /><br /> Example. MAKE_DIM(MAKE_WINDOW(-1,3,10.),MAKE_SLOPE(3.)) <br /> makes dimension with value <br /> SET_RANGE(-1..3, [7.,10.,13.,16.,19.]). <br /><br /> | MDS Operation. Make a dimension descriptor. <br /><br /> Arguments Optional: WINDOW. <br /> WINDOW window descriptor. <br /> If missing, all point of AXIS are included and <br /> the initial point of the axis has an index of 0. <br /> AXIS slope or, if defined, other descriptor type. <br /><br /> Signals. None. <br /> Units... From AXIS. Should be same as WINDOW's value_at_idx0. <br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> The array will have bounds only if the <br /> window has a defined value at index 0. <br /><br /> Example. MAKE_DIM(MAKE_WINDOW(-1,3,10.),MAKE_SLOPE(3.)) <br /> makes dimension with value <br /> SET_RANGE(-1..3, [7.,10.,13.,16.,19.]). <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_dispatch"></span> |
==MAKE_DISPATCH (TYPE,IDENT,PHASE,WHEN,COMPLETION)== | ==MAKE_DISPATCH (TYPE,IDENT,PHASE,WHEN,COMPLETION)== | ||
MDS Operation. Make a dispatch descriptor. <br /><br /> Arguments <br /> TYPE byte unsigned scalar, evaluated: <br /> TREE$K_SCHED_ASYNC 1 <br /> TREE$K_SCHED_SEQ 2 <br /> TREE$K_SCHED_COND 3 <br /> IDENT character scalar. <br /> PHASE character scalar. <br /> WHEN character scalar? <br /> COMPLETION character scalar? <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routine. <br /><br /> | MDS Operation. Make a dispatch descriptor. <br /><br /> Arguments <br /> TYPE byte unsigned scalar, evaluated: <br /> TREE$K_SCHED_ASYNC 1 <br /> TREE$K_SCHED_SEQ 2 <br /> TREE$K_SCHED_COND 3 <br /> IDENT character scalar. <br /> PHASE character scalar. <br /> WHEN character scalar? <br /> COMPLETION character scalar? <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routine. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_function"></span> |
==MAKE_FUNCTION (OPCODE,[ARG],...)== | ==MAKE_FUNCTION (OPCODE,[ARG],...)== | ||
MDS Operation. Make a function descriptor. <br /><br /> Arguments Optional: ARG,... . <br /> OPCODE unsigned word from 0 to the number defined less one. <br /> ARG,... as needed by the function described by OPCODE. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_FUNCTION(BUILTIN_OPCODE('SIN'),30) makes an <br /> expression SIN(30). <br /><br /> | MDS Operation. Make a function descriptor. <br /><br /> Arguments Optional: ARG,... . <br /> OPCODE unsigned word from 0 to the number defined less one. <br /> ARG,... as needed by the function described by OPCODE. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_FUNCTION(BUILTIN_OPCODE('SIN'),30) makes an <br /> expression SIN(30). <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_method"></span> |
==MAKE_METHOD (TIME_OUT,METHOD,OBJECT,[ARG]...)== | ==MAKE_METHOD (TIME_OUT,METHOD,OBJECT,[ARG]...)== | ||
MDS Operation. Make a method descriptor. <br /><br /> Arguments Optional: ARG,... . <br /> TIME_OUT real scalar. <br /> METHOD character scalar. <br /> OBJECT character scalar. <br /> ARG,... as needed by METHOD applied to OBJECT. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routine. <br /><br /> | MDS Operation. Make a method descriptor. <br /><br /> Arguments Optional: ARG,... . <br /> TIME_OUT real scalar. <br /> METHOD character scalar. <br /> OBJECT character scalar. <br /> ARG,... as needed by METHOD applied to OBJECT. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routine. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_param"></span> |
==MAKE_PARAM (VALUE,HELP,VALIDATION)== | ==MAKE_PARAM (VALUE,HELP,VALIDATION)== | ||
MDS Operation. Make a parameter descriptor. <br /><br /> Arguments <br /> VALUE any. <br /> HELP character. Textual information about VALUE. <br /> VALIDATION logical scalar. $VALUE may be used by VALIDATION to <br /> test VALUE without explicit reference to a tree path. <br /> $THIS will give the parameter descriptor itself. <br /> $VALUE and $THIS may only be used within GET_DATA <br /> evaluations of the arguments. <br /> >>>>>>>>>WARNING Use of $THIS and $VALUE may be infinitely recursive. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> Example. MAKE_PARAM(42.0,'The answer.', <br /> $VALUE > 6 && HELP_OF($THIS) <> ""). <br /> DATA(above) is 42.0 and VALIDATION(above) is 1BU. <br /><br /> | MDS Operation. Make a parameter descriptor. <br /><br /> Arguments <br /> VALUE any. <br /> HELP character. Textual information about VALUE. <br /> VALIDATION logical scalar. $VALUE may be used by VALIDATION to <br /> test VALUE without explicit reference to a tree path. <br /> $THIS will give the parameter descriptor itself. <br /> $VALUE and $THIS may only be used within GET_DATA <br /> evaluations of the arguments. <br /> >>>>>>>>>WARNING Use of $THIS and $VALUE may be infinitely recursive. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> Example. MAKE_PARAM(42.0,'The answer.', <br /> $VALUE > 6 && HELP_OF($THIS) <> ""). <br /> DATA(above) is 42.0 and VALIDATION(above) is 1BU. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_procedure"></span> |
==MAKE_PROCEDURE (TIME_OUT,LANGUAGE,PROCEDURE,[ARG],...)== | ==MAKE_PROCEDURE (TIME_OUT,LANGUAGE,PROCEDURE,[ARG],...)== | ||
MDS Operation. Make a procedure call <br /><br /> Arguments Optional: ARG,... . <br /> TIME_OUT real scalar. <br /> LANGUAGE character scalar. The language in which the procedure <br /> is written. <br /> PROCEDURE character scalar. <br /> ARG,... as needed by the procedure. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routine. <br /><br /> | MDS Operation. Make a procedure call <br /><br /> Arguments Optional: ARG,... . <br /> TIME_OUT real scalar. <br /> LANGUAGE character scalar. The language in which the procedure <br /> is written. <br /> PROCEDURE character scalar. <br /> ARG,... as needed by the procedure. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. None, normally done by module add routine. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_program"></span> |
==MAKE_PROGRAM (TIME_OUT,PROGRAM)== | ==MAKE_PROGRAM (TIME_OUT,PROGRAM)== | ||
MDS Operation. Make a program call <br /><br /> Arguments <br /> TIME_OUT real scalar. <br /> PROGRAM character scalar. The name of a program to be run. <br /> The program must be responsible for entering its data in <br /> the tree. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_PROGRAM(1.2,'MYDISK:MYPROGRAM'). <br /><br /> | MDS Operation. Make a program call <br /><br /> Arguments <br /> TIME_OUT real scalar. <br /> PROGRAM character scalar. The name of a program to be run. <br /> The program must be responsible for entering its data in <br /> the tree. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_PROGRAM(1.2,'MYDISK:MYPROGRAM'). <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_range"></span> |
==MAKE_RANGE ([START],[END],[DELTA])== | ==MAKE_RANGE ([START],[END],[DELTA])== | ||
MDS Operation. Make a range descriptor. <br /> Usual Form START .. END [.. DELTA] or START : END [: DELTA]. <br /><br /> Arguments Optional: DELTA; START and END when used as subscript <br /> limits. See the specific routine; otherwise, required. <br /> START scalar. The starting value. <br /> END scalar. The last value. <br /> DELTA scalar. The increment. Default is one. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> This uses a data type RANGE, whereas <br /> DTYPE_RANGE(START,END,DELTA) is a function. <br /> On evaluation, the compatible data type. <br /> A vector of length max((END - BEGIN)/DELTA,0) elements. <br /><br /> The first value will be BEGIN and successive values will <br /> differ by DELTA. The last value will not be futher from <br /> BEGIN than END. <br /> >>>>>>>>>WARNING, the number of element cannot always be predicted <br /> for fractional delta, 1:2:.1 may have 10 or 11 elements. <br /> >>>>>>>>>WARNINGS, the colon (:) form may be confused with a tree member <br /> and the dot-dot (..) form is hard to read/understand, <br /> use spaces. <br /><br /> Examples. 2..5 becomes [2,3,4,5] and 2:5:1.8 becomes [2.,3.8]. <br /><br /> | MDS Operation. Make a range descriptor. <br /> Usual Form START .. END [.. DELTA] or START : END [: DELTA]. <br /><br /> Arguments Optional: DELTA; START and END when used as subscript <br /> limits. See the specific routine; otherwise, required. <br /> START scalar. The starting value. <br /> END scalar. The last value. <br /> DELTA scalar. The increment. Default is one. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /> This uses a data type RANGE, whereas <br /> DTYPE_RANGE(START,END,DELTA) is a function. <br /> On evaluation, the compatible data type. <br /> A vector of length max((END - BEGIN)/DELTA,0) elements. <br /><br /> The first value will be BEGIN and successive values will <br /> differ by DELTA. The last value will not be futher from <br /> BEGIN than END. <br /> >>>>>>>>>WARNING, the number of element cannot always be predicted <br /> for fractional delta, 1:2:.1 may have 10 or 11 elements. <br /> >>>>>>>>>WARNINGS, the colon (:) form may be confused with a tree member <br /> and the dot-dot (..) form is hard to read/understand, <br /> use spaces. <br /><br /> Examples. 2..5 becomes [2,3,4,5] and 2:5:1.8 becomes [2.,3.8]. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_routine"></span> |
==MAKE_ROUTINE (TIME_OUT,IMAGE,ROUTINE,[ARG],...)== | ==MAKE_ROUTINE (TIME_OUT,IMAGE,ROUTINE,[ARG],...)== | ||
MDS Operation. Make a routine descriptor. <br /><br /> Arguments Optional: ARG,... . <br /> TIME_OUT real scalar. <br /> IMAGE character scalar. <br /> ROUTINE character scalar. <br /> ARG,... as needed by the routine. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_ROUTINE(1.2,MYIMAGE,MYROUTINE,5). <br /><br /> | MDS Operation. Make a routine descriptor. <br /><br /> Arguments Optional: ARG,... . <br /> TIME_OUT real scalar. <br /> IMAGE character scalar. <br /> ROUTINE character scalar. <br /> ARG,... as needed by the routine. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_ROUTINE(1.2,MYIMAGE,MYROUTINE,5). <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_signal"></span> |
==MAKE_SIGNAL (DATA,RAW,[DIMENSION,...])== | ==MAKE_SIGNAL (DATA,RAW,[DIMENSION,...])== | ||
Line 82: | Line 82: | ||
<br /> | <br /> | ||
- | <span id=""></span> | + | <span id="make_slope"></span> |
==MAKE_SLOPE (SLOPE,[BEGIN,[END]]...)== | ==MAKE_SLOPE (SLOPE,[BEGIN,[END]]...)== | ||
MDS Operation. Make a piece-wise linear slope-axis for dimension. <br /> >>>>>>>>>WARNING, this is a deprecated feature and there is no assurance <br /> of future support. <br /><br /> Arguments Optional: BEGIN, END, and more segments. <br /> SLOPE real scalar. Ratio of change of axis to change of index. <br /> BEGIN real scalar. Axis starting point. <br /> END real scalar. Axis ending point, the last value. <br /><br /> Note. The axis may be divided into multiple segments. <br /> Without a window ISTART, there must be a first BEGIN. <br /> If the slope is used in a dimension with a window, then <br /> the greater of the window's ISTART or the first BEGIN is <br /> used and the lesser of the window's IEND or the last END <br /> is used, assuming positive slope. <br /><br /> Signals. None. <br /> Units... Combined from SLOPE and BEGIN. END units are combined <br /> from the first segment if no BEGIN is applied. <br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Examples. MAKE_SLOPE(3.0) is a constant ratio of 3 axis values <br /> per index step. Axes can be infinite in extent. <br /> A finite axis of MAKE_SLOPE(3,12,21) has data points <br /> [12,15,18,21]. <br /> MAKE_SLOPE(3.0,,10.,4.0,20.0) has points at <br /> ...,4.0,7.0,20.0,24.0,28.0,... . Note that the dead zone <br /> from 10 to 20 is absent and that thus 10.0 becomes 20.0. <br /> Often BEGIN[j+1] is the same as END[j] + SLOPE[j] as in <br /> a clock that does not stop but does change rate. <br /><br /> | MDS Operation. Make a piece-wise linear slope-axis for dimension. <br /> >>>>>>>>>WARNING, this is a deprecated feature and there is no assurance <br /> of future support. <br /><br /> Arguments Optional: BEGIN, END, and more segments. <br /> SLOPE real scalar. Ratio of change of axis to change of index. <br /> BEGIN real scalar. Axis starting point. <br /> END real scalar. Axis ending point, the last value. <br /><br /> Note. The axis may be divided into multiple segments. <br /> Without a window ISTART, there must be a first BEGIN. <br /> If the slope is used in a dimension with a window, then <br /> the greater of the window's ISTART or the first BEGIN is <br /> used and the lesser of the window's IEND or the last END <br /> is used, assuming positive slope. <br /><br /> Signals. None. <br /> Units... Combined from SLOPE and BEGIN. END units are combined <br /> from the first segment if no BEGIN is applied. <br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Examples. MAKE_SLOPE(3.0) is a constant ratio of 3 axis values <br /> per index step. Axes can be infinite in extent. <br /> A finite axis of MAKE_SLOPE(3,12,21) has data points <br /> [12,15,18,21]. <br /> MAKE_SLOPE(3.0,,10.,4.0,20.0) has points at <br /> ...,4.0,7.0,20.0,24.0,28.0,... . Note that the dead zone <br /> from 10 to 20 is absent and that thus 10.0 becomes 20.0. <br /> Often BEGIN[j+1] is the same as END[j] + SLOPE[j] as in <br /> a clock that does not stop but does change rate. <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_window"></span> |
==MAKE_WINDOW ([ISTART],[IEND],[X_AT_0])== | ==MAKE_WINDOW ([ISTART],[IEND],[X_AT_0])== | ||
MDS Operation. Make a window descriptor for a dimension. <br /><br /> Arguments Optional: ISTART, IEND, X_AT_0. <br /> ISTART integer scalar. First element stored. <br /> IEND integer scalar. Last element stored. <br /> X_AT_0 real scalar. Value at index zero. <br /> The effective defaults are -HUGE(1), +HUGE(1), and zero. <br /> If missing completely, the beginning of the axis is <br /> used for X_AT_0 when evaluating a dimension. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_WINDOW(-1024,7168,MAKE_WITH_UNIT(-0.1,'s')) <br /><br /> | MDS Operation. Make a window descriptor for a dimension. <br /><br /> Arguments Optional: ISTART, IEND, X_AT_0. <br /> ISTART integer scalar. First element stored. <br /> IEND integer scalar. Last element stored. <br /> X_AT_0 real scalar. Value at index zero. <br /> The effective defaults are -HUGE(1), +HUGE(1), and zero. <br /> If missing completely, the beginning of the axis is <br /> used for X_AT_0 when evaluating a dimension. <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. MAKE_WINDOW(-1024,7168,MAKE_WITH_UNIT(-0.1,'s')) <br /><br /> | ||
- | <span id=""></span> | + | <span id="make_with_units"></span> |
==MAKE_WITH_UNITS (DATA,UNITS)== | ==MAKE_WITH_UNITS (DATA,UNITS)== | ||
MDS Operation. Make a describe data with units. <br /><br /> Arguments <br /> DATA any expression that DATA(this) will be valid. <br /> UNITS character string. See the primary section on "Units". <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. _S = MAKE_WITH_UNITS($VALUE*6,'m/s^2') can be used in a <br /> MAKE_SIGNAL(_S,MAKE_WITH_UNITS(5./1024*raw_node,'V') <br /> or similar. Note this could also have been <br /> MAKE_WITH_UNITS(MAKE_SIGNAL($VALUE*6, <br /> MAKE_WITH_UNITS(5./1024*raw_node,'V')),'m/s^2'). <br /><br /> | MDS Operation. Make a describe data with units. <br /><br /> Arguments <br /> DATA any expression that DATA(this) will be valid. <br /> UNITS character string. See the primary section on "Units". <br /><br /> Result.. Class-R descriptor. <br /> Use BUILD_xxx for immediate structure building. <br /> Use MAKE_xxx in FUNs for evaluated non-PUBLIC variables. <br /><br /> Example. _S = MAKE_WITH_UNITS($VALUE*6,'m/s^2') can be used in a <br /> MAKE_SIGNAL(_S,MAKE_WITH_UNITS(5./1024*raw_node,'V') <br /> or similar. Note this could also have been <br /> MAKE_WITH_UNITS(MAKE_SIGNAL($VALUE*6, <br /> MAKE_WITH_UNITS(5./1024*raw_node,'V')),'m/s^2'). <br /><br /> | ||
|} | |} |