public/subjects/guess-it-2/README.md

## guess-it-2

### Objectives

Now that you have even more statistical knowledge, you will guess even more numbers. This time it will be a bit harder.

### Instructions

That is right, you must build a program that given a number as standard input, prints out a range in which the next number provided should be. Just like last time.

The data received by the program, as always, will be presented as below:

```console
189
113
121
114
145
110
...
```

This data represents a graph in which the values of the x axis are the number of the lines (0, 1, 2, 3, 4, 5 ...) and the values of the y axis are the actual numbers (189, 113, 121, 114, 145, 110...).

Each of the numbers will be your standard input and the purpose of your program is for you to find the range in which the next number will be in.
This range should have a space separating the lower limit from the upper one like in the example:

```console
>$ ./your_program
189      --> standard input
120 200  --> range for the next input, in this case for the number 113
113      --> standard input
160 230  --> range for the next input, in this case for the number 121
121      --> standard input
110 140  --> range for the next input, in this case for the number 114
114      --> standard input
100 200  --> range for the next input, in this case for the number 145
145      --> standard input
1 99     --> range for the next input, in this case for the number 110
110      --> standard input
100 150  --> range for the next input, in this case for the number 145
145      --> standard input
...
```

As you can see, some of the ranges are not correct and some are bigger than others. This is just an example. If you wish, you can give a specific range in your program, that is fully up to you to decide. The intent of this exercise is for you to use the calculations you did in the previous exercise (`linear_stats`) to guess the numbers.

### Testing

Your program will be extensively tested, so performance should be prioritized. Testing will work as follow:

If you correctly guess the range for the next given number, your score will be incremented based on the size of your range. In other words, the bigger your range is, the smaller your score will be. So we advise you to find the perfect balance between a small range and a good guess.

In order for auditors to test your program, you will have to follow the next steps:

- create a folder called **`student`**
- copy the files that are needed to run your program into this folder
- write an **executable** shell script named `script.sh` containing the command(s) to run your program, **from the root folder of the provided tester** (see below where to find it)

Here is a following example of the script, assuming that the program is called `solution` and was written in JS(Javascript):

```sh
#!/bin/sh
# We assume that we are on the root folder, so we have to enter the
# student folder in order to run the `solution.js` file
node ./student/solution.js
```

You can choose in which language you want to build your program.

If you fail one of these steps, the test will not work. So we advise you to run the test by downloading [this zip file](https://assets.01-edu.org/guess-the-number.zip) containing the tester. You should place the `student/` folder in the root directory of the items provided and read its instructions. The data sets used to test this exercise will be `Data 5` and `Data 6`.

This project will help you learn about:

- Statistical and Probabilities Calculations
- Scripting