Maintenance script: Initial automated import

2016-02-24T18:28:44Z

Initial automated import

New page

{{Template:TI-BASIC:Command
|picture=RAND.GIF
|summary=Generates a random number between 0 and 1, or a list of such numbers. Can also be used to set the random number seed.
|syntax=rand

rand(''# of numbers'')

''seed''→rand
|location=Press:
# MATH to access the [[TI-BASIC:Math|Math]] menu.
# LEFT to access the PRB submenu.
# ENTER to select rand.
|compatibility=TI-83/84/+/SE
|size=1 byte
}}

rand generates a uniformly-distributed pseudorandom number (this page and others will sometimes drop the pseudo- prefix for simplicity) between 0 and 1. rand(''n'') generates a list of ''n'' uniformly-distributed pseudorandom numbers between 0 and 1. ''seed''→rand seeds (initializes) the built-in pseudorandom number generator. The factory default seed is 0.

[http://portal.acm.org/citation.cfm?doid=62959.62969 L'Ecuyer's algorithm] is used by TI calculators to generate pseudorandom numbers.

0→rand
0
rand
.9435974025
rand(2)
{.908318861 .1466878292}

'''Note:''' Due to specifics of the random number generating algorithm, the smallest number possible to generate is slightly greater than 0. The largest number possible ''is'' actually 1, but since returning a result of 1 would mess up the output of [[TI-BASIC:Randbin|RandBin(]] and [[TI-BASIC:Randnorm|RandNorm(]], the actual value returned in such cases is 1-1.11e-12 (which is displayed as 1, and is "equal" to 1 for the purposes of the [[TI-BASIC:Equal|=]] command). To see 1, store 196164532 to rand and then run the random number generator.

= Advanced Uses =

To seed the random number generator, store a positive integer to rand (the command will ignore any decimals, and the sign of the number). Seeding the random number generator has several uses:

When writing a program that uses random numbers, you may add a 0→rand instruction to the beginning of the program -- this ensures that the program's actions will be repeatable, making it easier to fix a bug. Just don't forget to take it out when you've finished writing the program.

Seeding the random number generator can also be used to create fairly secure (unbreakable without a computer) encryption. Pick a secret key, and store it to rand as a seed. Then, perform some randomly generated manipulations on the data you want to encode -- for example, shifting each character of a string by a random number. Decoding the message is simple: store the secret key to rand and perform the opposite of those random operations. However, this is impossible to do if you don't know the secret key.

------

When seeding the random number generator, as above, you make every random number generated afterwards predictable. This may be problematic even if your program doesn't need random numbers, because other programs might. To prevent this, use the following code to save and restore "randomness":

{{Template:TI-BASIC:Prgm-code
|code=
:randInt(1,[[TI-BASIC:Size_75%}}E[[/size|Size_75%}}E[[/size]]9)→N

(code that involves seeding the RNG here)

:N→rand
]]

------

Since generating random numbers is a fairly time-consuming operation, the rand(''# of numbers'') syntax is very effective at generating a delay in your program -- just add the line:

:rand(N)

The bigger N is, the longer the delay. In relation to the commonly used [[TI-BASIC:For|For(]] loop delay, the number used in the rand( delay is about 10 times smaller. However, this code has a side effect of storing a list of random numbers to [[TI-BASIC:Ans|Ans]], which may be undesirable. To avoid this, use this somewhat longer line:

:If dim(rand(N))

Despite the presence of an [[TI-BASIC:If|If]] statement, you don't have to worry about the next line being skipped, since dim(rand(N)) will always be true.

= Error Conditions =

* '''[[TI-BASIC:Errors#domain|ERR:DOMAIN]]''' if you try to generate a list of random numbers and the list length isn't an integer 1-999.

= Related Commands =

* [[TI-BASIC:Randint|RandInt(]]
* [[TI-BASIC:Randbin|RandBin(]]
* [[TI-BASIC:Randnorm|RandNorm(]]
* [[TI-BASIC:Randm|RandM(]]
* [[TI-BASIC:Randintnorep|randIntNoRep(]][[Category:TI-BASIC]]
[[Category:TIBD]]

TI-BASIC:Rand - Revision history

Maintenance script: Initial automated import