GAOTOPV returns the average over time (or the optional print value if the average is outside the optional print limits) for the date range specified by the Offset and Grouping for the variable. The "average over time" totals all values in the date range and divides by the number of days in the date range. GAVG totals all values and divides by the number of values found.
SYNTAX:
GAOTOPV(VarNum, GroupOffset/StartDate, Grouping/EndDate,Decimal_Places)
VarNum: The variable number to get the average for.
GroupOffset/StartDate: Used with the Grouping parameter to set the dates to calculate the stat for. Sets the number of Groups (set by the Grouping Parameter) to be added to set the dates. See examples below. If this field is a date string (i.e. "07/16/2004") or refers to a cell with a date in it, it is assumed to be the start date to calculate the stat for.
Grouping/EndDate: Used to set which dates to calculate the stat for. If the Grouping is a date literal string (i.e. "07/16/2004") or refers to a cell with a date in it, it is assumed to be the end date to calculate the stat for. Common Settings are:
"D" Days
“M” Monthly
"R" Report Dates
“Y” Yearly
Click here for available Grouping options
Decimal_Places: Sets the number of decimal places to be displayed.
NOTES:
In Design, Spread Reports use Locate, Group Summary to place this formula on a report.
EXAMPLES:
GAOTOPV(1,1,"R") Returns the average over time of the values for variable 1, for the report date range.
Date |
V1 |
1/1/04 |
4 |
1/2/04 |
- |
1/3/04 |
8 |
1/4/04 |
- |
GAOTOPV returns 3 (12 divided by 4 days). GAVG would return 6 (12 divided by 2).
GAOT(2,1,"D") returns the average over time for variable 2 (hourly var) for the first day of the report.
See also: GAOT