File:  [LON-CAPA] / loncom / html / adm / help / tex / Spreadsheet_Functions.tex
Revision 1.8: download - view: text, annotated - select for diffs
Tue Jan 23 01:48:37 2007 UTC (17 years, 5 months ago) by albertel
Branches: MAIN
CVS tags: version_2_9_X, version_2_9_99_0, version_2_9_1, version_2_9_0, version_2_8_X, version_2_8_99_1, version_2_8_99_0, version_2_8_2, version_2_8_1, version_2_8_0, version_2_7_X, version_2_7_99_1, version_2_7_99_0, version_2_7_1, version_2_7_0, version_2_6_X, version_2_6_99_1, version_2_6_99_0, version_2_6_3, version_2_6_2, version_2_6_1, version_2_6_0, version_2_5_X, version_2_5_99_1, version_2_5_99_0, version_2_5_2, version_2_5_1, version_2_5_0, version_2_4_X, version_2_4_99_0, version_2_4_2, version_2_4_1, version_2_4_0, version_2_3_99_0, bz6209-base, bz6209, bz5969, bz2851, PRINT_INCOMPLETE_base, PRINT_INCOMPLETE, HEAD, GCI_3, GCI_2, GCI_1, BZ5971-printing-apage, BZ5434-fox
- add a &PARM() routine to SPRS
- document &PARM(), &MAXPARM(), &MINPARM()

\label{Spreadsheet_Functions}
The following special functions are available in the spreadsheet.
Please see \textbf{Referencing Cells} (\ref{Spreadsheet_Referencing_Cells})
for information on specifying cells and ranges.

\begin{itemize}

\item \texttt{\&NUM(range)} - number of non-empty cells in range
\index{NUM}

\item \texttt{\&BIN(low, high, range)} - number of non-empty cells in
  range with values between low and high
\index{BIN}

\item \texttt{\&SUM(range)} - sum of the non-empty cells in range
\index{SUM}

\item \texttt{\&MEAN(range)} - mean value of non-empty cells in range
\index{MEAN}

\item \texttt{\&STDDEV(range)} - standard deviation of non-empty cells
  in range 
\index{STDDEV}

\item \texttt{\&PROD(range)} - product of non-empty cells in range
\index{PROD}

\item \texttt{\&MAX(range)} - maximum value of non-empty cell in range
\index{MAX}

\item \texttt{\&MIN(range)} - minimum value of non-empty cells in
  range 
\index{MIN}

\item \texttt{\&SUMMAX(n ,range)} - sum of the maximum n non-empty
  cells in range
\index{SUMMAX}

\item \texttt{\&SUMMIN(n, range)} - sum of the minimum n non-empty
  cells in range
\index{SUMMIN}

\item \texttt{\&EXT(expression)} - access to EXT function in lonnet.
Use \&EXT(``system.time'') to retrieve the current time.
\index{EXT}

\item \texttt{\&PARM(parameter)} - get the value of a specific parameter 
\index{PARM}

\item \texttt{\&MINPARM(expression)} - get the value of a parameter that 
matches the expression that is the smallest in value (If one specified 
'opendate' it would return the smallest opendate set on the problem.)
\index{MINPARM}

\item \texttt{\&MAXPARM(expression)} -  get the value of a parameter that 
matches the expression that is the largest in value (If one specified 
'opendata' it would return the largest opendate set on the problem.)
\index{MAXPARM}

\item \texttt{\&SUMSEQ(column,sequence1,sequence2,sequence3,...)} -
sum the given column across the folders or sequences listed.

When specifying a sequence use the full title.  Instead of a sequence title
the word ``all'' can be used to sum over all sequences.  Regular expressions
can be entered as well, if prefixed by ``regexp:''.  See below for examples.

\begin{itemize}

\item \texttt{\&SUMSEQ(``Z'',''Chapter 1'');}

\item \texttt{\&SUMSEQ(``Z'',''Chapter 1'',''Chapter 2'',''Chapter 3'');}

\item \texttt{\&SUMSEQ(``Z'',''all'');} - sum over all sequences.

\item \texttt{\&SUMSEQ(``Z'',''regexp:Large Biomolecules'');} -
 sum over all sequences which match the regular expression 
/Large Biomolecules/.

\end{itemize}

\end{itemize}

In addition, most non-IO Perl functions work in cells.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>