ranger2
-------

Program RANGER2.83p is a TI-83 program designed to work with the Texas
Instruments CBR. It includes all the functionality of CBR's built-in RANGER
program, plus offers several additional features requested by users:
 - can collect for other than 15 seconds in REALTIME=YES mode (1-99 seconds)
 - can collect other than 94 data points in REALTIME=NO mode (2-256 points)
 - can choose plot type (XYLINE or SCATTER) for DIST-TIME, VEL-TIME, and
   ACCEL-TIME plots
 - can specify ambient temperature for more accurate distance, velocity, and
   acceleration computations
 - can toggle augmented CBR piezo sound ("clicks") ON or OFF
 - can input functions to match in the DIST and VEL MATCH applications

If you choose to use these new features, you should delete RANGER from your
TI-83, send RANGER2 to your TI-83 using TI-GraphLink, then run RANGER2. Please
note that while RANGER2 has performed well in typical usage scenarios, it has
not undergone the rigorous quality assurance testing of released TI software
(such as RANGER) and so cannot be supported to the same degree. If you find it
"crashes" when you input unusual values, try again using more typical values.
And remember you can always reload RANGER from your CBR.

Any combination of the following new features can be selected in RANGER2 by
simply following the instructions below. After all desired Preferences have
been set, return to MAIN MENU by selecting 5:MAIN MENU then setup the desired
sample as in RANGER. Your selections will remain in effect (so long as you
continue using the same TI-83) until you make subsequent changes within
RANGER2's PREFERENCES menu, choose 2:SET DEFAULTS from MAIN MENU, or run the
standard RANGER program.

(RANGER defaults are shown in parentheses)

A. To specify REALTIME=YES collection time (default=15 seconds):
1) From MAIN MENU, select 1:SETUP/SAMPLE
2) If REALTIME: NO is displayed, cursor down to REALTIME: and press [ENTER]
until "YES" is displayed
3) Cursor down to TIME(S): and enter the desired collection time (within range
1-99 seconds)
4) Cursor up to START NOW and press [ENTER] then follow the on-screen prompts

B. To specify the number of 94 data points collected in REALTIME=NO mode
(default=94):
1) From MAIN MENU, select 5:TOOLS
2) Select 5:PREFERENCES
3) Select 1:NUMBER SAMPLES
4) Select either:
     1:DEFAULT to restore default number of data points (94) collected in
REALTIME=NO mode
     2:ENTER VALUE, then enter the desired number of data points (within
range 2-256) collected in REALTIME=NO mode

C. To specify plot type (XYLINE or SCATTER) for DIST-TIME, VEL-TIME, and
ACCEL-TIME plots (default=XY-LINE):
1) From MAIN MENU, select 5:TOOLS
2) Select 5:PREFERENCES
3) Select 2:PLOT TYPE
4) Select either:
     1:XY-LINE to restore default plot type (collected data points are
connected)
     2:SCATTER to plot collected data points distinctly (unconnected)

D. To specify the ambient temperature for more accurate distance, velocity, and
acceleration computations (default=21C):
1) From MAIN MENU, select 5:TOOLS
2) Select 5:PREFERENCES
3) Select 3:AMBIENT TEMP
4) Select either:
     1:DEFAULT to restore default ambient temperature (21 degrees Celsius,
or approximately 70 degrees Fahrenheit)
     2:ENTER VALUE, choose temperature unit (1:CELSIUS or 2:FAHRENHEIT),
then enter ambient temperature

E. To select augmented CBR piezo sound ("clicks") ON or OFF (default=ON):
1) From MAIN MENU, select 5:TOOLS
2) Select 5:PREFERENCES
3) Select 4:SOUND ON/OFF
4) Select either:
     1:ON to restore default state (augmented "Click" sound will be heard
during sampling)
     2:OFF (augmented "Click" sound will not be heard during sampling)

F. To choose a function to match in the DIST and VEL MATCH applications
(default= 3 random line segments):
1) From MAIN MENU, select 2:APPLICATIONS
2) Choose desired distance units (1:METERS or 2:FEET)
3) Choose desired match application (1:DIST MATCH or 2:VEL MATCH)
4) Choose type of function to match, either:
     1:RANDOM to restore default state (3 random line segments)
     2:USER INPUT then enter a function for variable X, then [ENTER]

Notes:
a) This program has been tested using only relatively simple functions such as
3X+1, SIN(X), 2X^2+3X+1, 2COS(X-PI/6)+5, etc.
b) Remember that you will not be able to obtain negative distance measurements
(why?), so you may wish to introduce a vertical offset into some functions to
force them positive, e.g. SIN(X)+5

