13.1.8 Get Value Mathematic_Vector Functions

The Get_Value_MV functions return values from a Mathematic_Vector object. These operations require global communication (except Get_First_MV, Get_Name_MV, Get_Last_MV, Get_Length_PE and Get_Length_Total), but if called more than once without modifying the object, no global communication is done for the second call.

Calling syntax:

Output = Average (MV) ,
Output = First_PE (MV) ,
Output = Infinity_Norm (MV) ,
Output = Length_PE (MV) ,
Output = Last_PE (MV) ,
Output = Length_Total (MV) ,
Output = Locus (MV) ,
Output = Maximum (MV) ,
Output = Mean (MV) ,
Output = Minimum (MV) ,
Output = Name (MV) ,
Output = Norm (MV) ,
Output = One_Norm (MV) ,
Output = P_Norm (MV, P) ,
Output = Sum (MV) ,
Output = Total (MV) or
Output = Two_Norm (MV)  

Mean is an alternate interface name for the Average Procedure, Norm is an alternate interface name for the Two_Norm Procedure, and Total is an alternate interface name for the Sum Procedure.

Input variables:

 MV  The Mathematic_Vector object to be examined.
 P  P_Norm exponent. This optional argument is only available in P_Norm.

Output variable:

 Output  For Name and Locus, returns a character variable containing the name or locus assigned to the object upon initialization. For First_PE, Last_PE, Length_PE and Length_Total, returns an integer variable containing the named value of the Mathematic_Vector object. For all other functions, returns a real variable with the named value for the Mathematic_Vector object.

The Get Value Mathematic_Vector code listing contains additional documentation.

Michael L. Hall