Showing data in spreadsheets
All data containers (including histograms and functions) discussed in [man:data:data_collections]] can be shown as a table (the class class jhplot.HTable or inside a spreadsheet, see the class jhplot.SPsheet. To show data in table, use the method "toTable()". To show data in a spreadsheet, initialize the class jhplot.SPsheet with an data object as an argument.
You can call a spreadsheet from the menu bar [Tool]->[Spreadsheet]. You will see the table. Another way to start is to use Jython prompt and type:
You will see the spreadsheet again, but now you can "talk" to it since you have a created a "spreadsheet" object "a". Type "a." + [Ctrl]+[Space]. You will see many methods associated with the class "SPsheet". You can insert data, remove, while watching how the data are changed in the spreadsheet.
The spreadsheet is based on SharpTools package and have:
- A Friendly Interface
- Compatibility with Microsoft Excel
- Configurable Preferences
- Formulas and References, File Operations
- Clipboard Operations
- Undo and Redo, insertion and Deletion of Rows and Columns
- Sorting Operations, Find and Find Next, Histograms
- Password Security
The spreadsheet configuration file is located in ".jehep/" directory (linux) and called "sharptools.ini".
Programming with spreadsheet
Showing comma-separated values (CSV) files
Comma-separated values (CSV) files can be shown either by loading the file from the menu of the spreadsheet, or inserting the data as a object in a programmatic manner.
Data is input to cells in the workspace. When a cell is clicked on, or highlighted, it is said to be selected. To make a cell editable, double-click on it. To select a range, select a cell and drag the mouse over the desired region. The range will be highlighted.
Sharp Tools Spreadsheet allows for user-defined formula input, such as:
Sharp Tools Spreadsheet allows nearly arbitrary variable-length parameter input to most formulas using
literals: -1, 0, 100 relative addressing: A1, B4, E76 absolute addressing: $A$2, $B$5, $E$7 range specification: C1:C10, A2:B2
Functions are predefined formulas that perform calculations by using specific values, called arguments, in a particular order or structure.
Arguments can be numbers or cell references. A cell reference can be a single cell or a range of cells. A single cell can use relative addressing (A1) or absolute addressing ($B$5). A range of cells is specified by a pair of diagonal cells (A1:C5 or $A$1:$C:$5). Different functions have difference requirements on the number or type of parameters.
The structure of a function begins with the an equal sign (=), the function name, an opening parenthesis, the arguments for the function separated by commas, and a closing parenthesis.
Sharp Tools Spreadsheet implements various symbolic formula operations:
Returns the absolute value of is argument.
Example: =ABS(-1) returns 1. AVERAGE
Returns the average (arithmetic mean) of its arguments. COUNT
Returns the number of its arguments.
Example: =COUNT(A1:A25,B1) returns 26.0. E
Returns an approximation of the golden mean. Takes no arguments.
Example: =E() returns 2.7182817 INT
Returns the integer portion of its argument.
Example: =INT(94.99) returns 94.0. LOG
Returns the logarithm base e of its argument.
Example: =LOG(E()*E()) returns 2.0. MAX
Returns the largest number among its arguments.
Example:=MAX(99.99,100,99.9999) returns 100.0. MEANDEV
Returns the largest average absolute deviation of its arguments. MEDIAN
Returns the largest average absolute deviation of its arguments. MIN
Returns the largest average absolute deviation of its arguments. PI
Returns an approximation of pi. Takes no arguments. RANGE
Returns the difference between MAX and MIN of its arguments. ROUND
Returns the nearest integer value of its argument. SQRT
Returns the square root of its argument. SUM
Adds up the specified arguments. STDDEV
Returns the standard deviation of its arguments. TRIG
TRIG can be any one of the trigonometric functions SIN, COS, TAN, ASIN, ACOS, or ATAN. All trigonometric functions take only one parameter input, which is specified in radians.
Example: =COS(2*PI()) returns 1.0.
Errors are of the form #ERROR?, where ERROR is the type of error. There are several errors that are possible when entering formulas:
#PAREN: Missing a parenthesis.
Example: =SUM(A1:A25 #NUM?: Improper number format.
Example: 2.3.4 #OP?: Improper use of an operator.
Example: =2++3 #NAME?: An unknown syntax.
Example: =AD #REFS?: A cell that does not exist has been referenced. #ADDR?: An invalid cell has been referenced.
Example: =1A #EVAL?: The input cannot be evaluated properly.
Example: =A4:B4+1 #FUNC?: An unknown function has been used
Example: =NOP() #PARAM?: Too many or too few arguments specified.