home *** CD-ROM | disk | FTP | other *** search
- - 1 -
- 23rd December, 1990
-
- About TS3ST in General (Statistics: Transformations of observations)
- ======================
-
- Apply question mark ? with the program call for a brief description of a
- program.
-
- This package may be used and distributed freely for NON-COMMERCIAL,
- NON-INSTITUTIONAL, PRIVATE purposes, provided it is not changed in any way.
- ┌────────────────────────────────────────────────────────────────────────────┐
- │ For ANY other usage (such as use in a business enterprise or a university) │
- │ or the full scale version contact the author for a personal or a site │
- │ license. │
- └────────────────────────────────────────────────────────────────────────────┘
- Please do not distribute any part of this package separately. Uploading to
- BBSes is encouraged.
-
- The registered version is strictly for the registrant only. Identical
- programs must NOT be running on more than one computer at a time. Site
- licensed programs must not be run outside the licensed site.
-
- The programs are under development. Comments and contacts are solicited. If
- you have any questions, please do not hesitate to use electronic mail for
- communication.
- InterNet address: ts@chyde.uwasa.fi (preferred)
- Funet address: GADO::SALMI
- Bitnet address: SALMI@FINFUN
- FidoNet address: 2:515/1 (Micro Maniacs Opus, To: Timo Salmi)
-
- The author shall not be liable to the user for any direct, indirect or
- consequential loss arising from the use of, or inability to use, any program
- or file howsoever caused. No warranty is given that the programs will work
- under all circumstances.
-
- Timo Salmi
- Professor of Accounting and Business Finance
- School of Business Studies, University of Vaasa
- P.O. BOX 297, SF-65101 Vaasa, Finland
-
- EX2FL.EXE copyright (c) is by Programmer Tuomas Eerola
- School of Business Studies, University of Vaasa
- P.O. BOX 297, SF-65101 Vaasa, Finland
-
- CONTENTS:
-
- 1. General Description of STATTRAN.EXE
- 2. Use as an Editor
- 3. Exponential to floating converter EX2FL.EXE
- 4. Release Notes for STATTRAN.EXE
- 5. PD Programs for PC Compatibles by Timo Salmi
- 6. The Statistics Set for Other Computers
-
- - 2 -
-
-
- 1. GENERAL DESCRIPTION
-
- STATTRAN (Ver 1.5)
-
- STATistics: TRANsformations is part of the interactive statistical system
- by Timo Salmi. It is the third program in the set. It can be used for
- transforming the observations, and, if necessary, even as an editor. The
- first program in the set is STATistical MEASures (TS1STxx.ARC), which is
- intended for univariate analysis. The second program in the set is
- STATistics: multiple REGRession analysis (TS2STxx.ARC). The fourth program in
- the set is STATistics: Ranks and CORrelations (STATRCOR in TS4STxx.ARC). The
- fifth program in the set is STATistics: Least Absolute Deviation multiple
- Regression (STATLADR in TS5STxx.ARC).
- STATTRAN includes a built-in help system, which can be invoked by typing ?
- at any interactive question. Because of this built-in help, and the
- interactive nature of the program's user interface, no long-winding
- instructions have been included. (Who reads instructions anyhow?)
- The following transformations are available
- LOGAE is ln(x(i)), i.e. takes the natural logarithm.
- LOGAR is log(x(i)), i.e. takes the logarithm in a given base.
- POWER is x(i)^a, i.e. raises to the given power.
- SCALE is a*x(i), i.e. scaling with a constant coefficient.
- MULTI is y(i)*x(i), i.e. multiplies a variable with another variable.
- DEFLA is y(n)/y(i)*x(i), i.e. deflates a variable with another variable.
- DIFFE is x(i)-x(i-1), i.e. takes differences.
- LAGLD is x(i+lag), i.e. a lag or a lead.
- The data can either be given from the keyboard or taken from a file. If the
- input is to be taken from a file it must first be prepared with some editor,
- or some word processor which includes an option for preparing ordinary ascii
- text. (Also STATTRAN can be used for this purpose.)
- The data is given to the program in the following format:
-
- X1 X2 X3 !variable names (! denotes a comment)
- 3.56 6.32 -1.73
- 5.12 -4.21 9.18
- 14.2 5.11 0.31
- END !END is optional in a file
-
- A missing item in an observation is marked by a hash (#). E.g. if the first
- item of the second observation were missing, the observation should be
- written as # -4.21 9.18
- The items in an observation can be separated with blanks, as in the above,
- or with commas (,) e.g. 5.12,-4.21,9.18. The number of the intervening
- blanks is irrelevant, and can be customized for increased readability. Thus
- e.g. 5.12 -4.21 9.18 and 5.12 -4.21 9.18 are equivalent.
- A row can be continued using an ampersand (&). E.g. the variables could
- be given as
- X1 X2 &
- X3
- Alternatively, * can be used instead of & as the continuation marker.
- Comments can be added to the input data. If ! appears on a line all text
- after ! will be considered as a comment.
- A header can be entered on each page if output is directed to a file.
- To accomplish this start the very first line on the input file with a
- double exclamation mark (!!) and the rest of the line will be used as the
- header. Thus !! indicates a header, a single ! an ordinary comment. Note
- that STATTRAN will omit all comments.
- The maximum number of variables is 25. The maximum number of observations
- is 400 (for each variable). The public domain version, however, sets the
- limits at 4 and 100 respectively.
-
-
- 2. USE AS AN EDITOR
-
- STATTRAN can be used as a simple editor to prepare the data for the other
- statistics programs in the set. (Naturally, any editor will do.) The way to
- do this is to select the suitable options in STATTRAN as they come along:
- Choose giving the input from the keyboard (that is, not from a file), and
- directing the output to a file. Then select from the menu of transformations
- and actions the action SAVE. The data you have entered will be saved in your
- indicated output file in the proper format. If you wish to, you can, of
- course, also make transformations in the data during the same session.
- An experienced user may also find useful the programs FILETRIM and FILEADD
- in TSFCOMxx.ARC. The former can be used to extract columns from data files,
- and the latter to join them (side by side) into a new data file.
-
-
- 3. EXPONENTIAL TO FLOATING CONVERTER EX2FL.EXE (by Tuomas Eerola)
-
- The programs in the statistics set do not allow the input data to be in
- the exponential format (such as e.g. 1.2345E+05). Such data must first be
- converted into the floating format (e.g 123450.0).
-
- Usage: EX2FL Source.ext [Output.ext]
-
- EX2FL.EXE converts a file containing exponent-type numbers to floating-point
- numbers. Default output is con, that is to screen.
-
- Value range: 1E-15 ... 9.999E16
-
-
- 4. RELEASE NOTES FOR STATTRAN.EXE
-
- Version 1.1: Some internal changes.
-
- Version 1.2: Some of the routines of the Turbo Pascal code have been
- optimized for increased speed.
-
- Version 1.3: This version introduces input recall and line editing. The
- special keys Del, CrLf, CrRg, CrUp, Home, End, and Esc are functional for
- this purpose. PgUp is the recall key. Line editing uses insert mode.
- Disk access has been made faster (the program has its own cache).
- The directory routine has been updated.
- Read-only files can be read properly.
-
- Version 1.4: While fixing a bug in the multiple regression program I also
- made some enhancements in the routines which are common to all my statistical
- programs. Most importantly the insert key has been made functional in the
- line editing.
-
- Version 1.5: The line editing potential of the program has been improved.
- When the task is given from the keyboard, and continuation lines are used,
- the repeated input recall (CursorUp) gets each line in turn. Ctlr-C and
- break-key abort have been enhanced.
- A line can be continued using an &, or a * at the end. Now also the
- backslash \ is accepted. This was suggested by Tuomas Eerola.
- Some help texts within the program have been extended.
-
- Version 1.6: Several improvements to the nuts and bolts of the user
- interface.
- The new usage of the call is
- PROGNAME [/h(elp)] [/iInputFileName] [/oOutputFileName] [/cColumnsPerRow]
- (the /c option, which regulates the width of the output, is for registered
- versions, only). If you use the /i switch, it stuffs the InputFileName into
- the appropriate recall buffer. This means that when the program asks you for
- the input file name, you can invoke the input file name just by pressing the
- CursorUp key. (The same goes for the /o switch, respectively.) This is very
- convenient, if you use the program many times successively making small
- changes in your data in between. (This assumes, of course, that you have a
- command line editor like DOSEDIT or CED to recall previous MsDos commands.
- These common shareware programs can be obtained from any well-stocked BBS or
- FTP site.)
- The printer readiness test has been rewritten to be more general. The
- earlier test failed for some printers, because the codes the printers send
- when they are offline are not standardized.
- The "file exists, overwrite?" question is no more asked when the output
- file is prn, in other words when the output is directed to the printer.
- The user has now a choice of a left margin from 0 to 20 blanks when output
- is directed to the printer.
- The user has now a choice between formfeed and four blank lines to start
- each new page of output.
- When an input file is not found, the user is given the choice of listing a
- directory. The directory routine has been rewritten.
- The file ready message now also includes the file side besides the name.
-
-
- 5. PD PROGRAMS FOR PC COMPATIBLES BY THE AUTHOR
-
- See TSPROG.INF in ST1STxx.ARC or in ST2STxx.ARC.
-
-
- 6. THE STATISTICS SET FOR OTHER COMPUTERS
-
- The Statistical programs by Timo Salmi are also available for the Sinclair
- QL computer. Named STATPREP the system is part of a Public Domain library for
- QUANTA members. The descriptions of the files in the Quanta Library are given
- in STATMEAS.INF contained in TS1STxx:ARC, i.e. the first part of the set
- statistical programs.
-